PyCharm 2025.3 Help

使用 Wallet 和 OCI 创建 Oracle 数据源

启用 数据库工具和 SQL 插件

此功能依赖于 数据库工具和 SQL 插件，默认情况下，PyCharm 已捆绑并启用该插件。 如果相关功能不可用，请确保您未禁用该插件。

  1. 按 Ctrl+Alt+S 打开设置，然后选择 插件。

  2. 打开 已安装 选项卡，找到 数据库工具和 SQL 插件，并选中其名称旁的复选框。

PyCharm 通过 TNS 协议使用 JDBC 驱动程序连接到 Oracle 服务器。 可用的驱动程序模式如下：

  • 在 Thin 模式下，JDBC 驱动程序始终连接到 TNS 侦听器。 在此模式下，可以使用不同版本的 JDBC 驱动程序。

  • 在 OCI 模式下，JDBC 驱动程序使用本机库。 在这种情况下，JDBC 驱动程序的版本必须与这些本机库的版本相同。

Oracle Wallet 是一组文件，用于存储所有用户凭据，例如证书、证书请求和私钥。 您可以使用 Oracle 工具创建 Wallet，或者请您的 Oracle 服务器管理员生成 Wallet。 有关 Wallet 的更多信息，请参阅 创建和管理 Oracle Wallet。

先决条件

  • 正在运行的 Oracle Cloud 实例，并已为您的用户授予访问权限。

  • Oracle Wallet。

创建 Oracle Cloud 数据源

作为目录示例，本教程将使用以下目录：

  • 下载的软件包解压至 ~/Oracle/instantclient_19_8/ 。

  • oraclepki.jar 存储在 ~/Oracle/instantclient_19_8/ 。

  • Wallet 文件存储在 ~/Oracle/instantclient_19_8/network/wallet ，且包含已配置的 tnsnames.ora 和 sqlnet.ora 。

步骤 1。 为 OCI 连接准备驱动程序

  1. 通过以下任一方式打开数据源属性：

    • 在 数据库 工具窗口的工具栏上，点击 “数据源”图标数据源。

    • 按 Shift+Enter。

    打开“数据源与驱动程序”对话框

  2. 在 数据源和驱动程序 对话框中，点击 驱动程序 选项卡。

  3. 在驱动程序列表中，右键点击 Oracle 驱动程序并选择 复制。

  4. 更改复制的 Oracle 驱动程序的名称（例如， Oracle [Cloud, OCI]）。

  5. 在 驱动程序文件 窗格中，点击 添加 图标（“添加”按钮 ），然后选择 原生库路径…。

  6. 在文件浏览器中，导航到 Instant Client 文件所在的目录（本教程中为 ~/Oracle/instantclient_19_8 ），然后点击 打开。

  7. 您可以使用 PyCharm 提供的驱动程序，或使用随 Instant Client 提供的驱动程序。

    更改文件版本，使其与 Instant Client 的版本相同。

    IDE 提供的驱动程序的驱动文件版本列表

    1. 在 驱动程序文件 窗格中，点击 添加 图标（“添加”按钮 ），然后选择 自定义JAR…。

    2. 在文件浏览器中，导航到包含 Instant Client 文件的目录（本教程中为 ~/Oracle/instantclient_19_8 ）。

    3. 在该目录中，选择以下文件： ojdbc8.jar 、 orai18n.jar ，以及 oraclepki.jar 。

    4. 点击 打开。

    与 Instant Client 一起提供的驱动文件

步骤 2。 创建 Oracle Cloud 数据源

要连接到数据库，请创建用于存储连接详细信息的数据源。

  1. 选择您要创建的数据源。 您可以通过以下任一方式执行此操作：

    • 在主菜单中，转到 文件(F) | 新建(N) | 数据源 并选择 Oracle。

    • 在 数据库 工具窗口的工具栏上，点击 “新建”图标新建。 转到 数据源 并选择 Oracle。

    创建新数据源

  2. 从 连接类型 列表中，选择 TNS。

  3. 从 驱动程序 列表中，选择 OCI。

  4. 点击 驱动程序 链接，并选择您在 步骤 1 中创建的驱动程序条目（在本例中为 Oracle [云、 OCI]）。

  5. 在 TNSADMIN 字段中，点击“浏览”按钮并导航到包含 Instant Client 文件的目录（在本例中为 ~/Oracle/instantclient_19_8/network/admin ）。

  6. 在 TNS 名称 字段中，使用自动补全（Ctrl+Space ）选择要使用的服务名（请参见 tnsnames.ora Wallet 文件中别名的值）。

  7. 为 Oracle 用户指定凭据。

  8. 确保可以使用提供的详细信息建立数据库连接。 为此，请点击连接详细信息部分底部的 测试连接 链接。

    “测试连接”链接

    如果遇到任何连接问题，请参阅 无法连接到数据库 页面。

  9. （可选）默认情况下，仅自省默认架构并可用于工作。 如果您还想处理其他架构，请在 架构 选项卡中选择它们进行自省。

    “数据源与驱动程序”对话框的“架构”选项卡

  10. 点击 确定 以创建数据源。

  11. 在 数据库 工具窗口中找到您的新数据源。

    • 有关 数据库 工具窗口的更多信息，请参阅相应的 参考主题。

    • 有关在 PyCharm 中处理数据库对象的更多信息，请参阅 数据库对象。

    • 要编写并运行查询，请通过点击数据源并按下 F4 打开默认的 查询文件。

    • 要查看数据库对象的数据，请通过双击该对象打开 数据编辑器和查看器。

创建 Oracle Cloud 数据源
最后修改日期： 2025年 12月 2日
使用 OCI 创建 Oracle 数据源PostgreSQL