PyCharm 2025.3 Help

使用 OCI 创建 Oracle 数据源

启用 数据库工具和 SQL 插件

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

  1. 按下 Ctrl+Alt+S 以打开设置,然后选择 插件

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

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

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

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

所需文件与设置

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

  • 已配置的 tnsnames.ora 文件。 有关 tnsnames.ora 文件的完整信息,请参阅 官方文档

创建 Oracle OCI 数据源

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

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

    • 数据库 工具窗口的工具栏上,点击 数据源图标数据源

    • 按下 Shift+Enter

    打开数据源与驱动程序对话框
  2. 数据源和驱动程序 对话框中,点击 驱动程序 选项卡。

  3. 在驱动程序列表中,右键点击 Oracle 驱动程序,然后选择 复制

  4. 更改已复制的 Oracle 驱动程序的名称(例如, Oracle [OCI])。

  5. 驱动程序文件 窗格中,点击 添加 图标(添加按钮 ),然后选择 原生库路径…

  6. 在文件浏览器中,导航到 Instant Client 文件所在的目录(例如, ~/Oracle/instantclient_19_8 ),并点击 打开

    为 OCI 连接准备驱动程序

步骤 2。 创建 Oracle 数据源

要连接到数据库,请创建一个将存储您连接详细信息的数据源。

  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 钱包文件中的别名值)。

  7. 为 Oracle 用户指定凭据。

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

    测试连接链接

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

  9. (可选)默认情况下,仅默认架构会被内省并可供使用。 如果还希望使用其他架构,请在 架构 选项卡中选择它们以进行内省。

    数据源与驱动程序对话框的架构选项卡
  10. 点击 确定 以创建数据源。

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

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

    • 有关在 PyCharm 中使用数据库对象的更多信息,请参阅 数据库对象

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

    • 要查看数据库对象的数据,请双击该对象以打开 数据编辑器和查看器

创建 OCI 数据源
最后修改日期: 2025年 12月 2日