使用 OCI 创建 Oracle 数据源
启用 数据库工具和 SQL 插件
此功能依赖 数据库工具和 SQL 插件,该插件在 PyCharm 中默认捆绑并启用。 如果相关功能不可用,请确保您未禁用该插件。
按下 Ctrl+Alt+S 以打开设置,然后选择 。
打开 已安装 选项卡,找到 数据库工具和 SQL 插件,并选中插件名称旁边的复选框。
官方文档与软件
有关 Oracle 的完整信息,请参阅 官方文档。
要下载 Oracle 数据库软件,请参阅 官方软件下载。
有关更多版本的 Oracle JDBC 驱动程序,请参阅 官方 JDBC 驱动程序下载。
请从 oracle.com 上的 Oracle Instant Client 下载页面 下载适用于您操作系统的以下 Oracle Instant Client( OCI )软件包:
基本包
SQL*Plus 包
JDBC 补充包
从 oraclepki.jar 下载 Oracle Database 12.2.0.1 JDBC Driver & UCP Downloads 页面。
准备包含钱包文件的 ZIP 存档。 有关下载钱包的更多信息,请参阅 docs.oracle.com 上的 Download Client Credentials (Wallets)。
PyCharm 使用 JDBC 驱动程序通过 TNS 协议连接到 Oracle 服务器。 可用的驱动程序模式如下:
在 Thin 模式下,JDBC 驱动程序始终连接到 TNS 侦听器。 在该模式下,可以使用不同版本的 JDBC 驱动程序。
在 OCI 模式下,JDBC 驱动程序使用本机库。 在这种情况下,JDBC 驱动程序的版本必须与这些本机库的版本相同。
所需文件与设置
正在运行的 Oracle 实例,并为您的用户授予了访问权限。
已配置的 tnsnames.ora 文件。 有关 tnsnames.ora 文件的完整信息,请参阅 官方文档。
创建 Oracle OCI 数据源
步骤 1。 为 OCI 连接准备驱动程序
通过以下任一方式打开数据源属性:
在 数据库 工具窗口的工具栏上,点击
数据源。
按下 Shift+Enter。

在 数据源和驱动程序 对话框中,点击 驱动程序 选项卡。
在驱动程序列表中,右键点击 Oracle 驱动程序,然后选择 复制。
更改已复制的 Oracle 驱动程序的名称(例如,
Oracle [OCI])。在 驱动程序文件 窗格中,点击 添加 图标(
),然后选择 原生库路径…。
在文件浏览器中,导航到 Instant Client 文件所在的目录(例如, ~/Oracle/instantclient_19_8 ),并点击 打开。

步骤 2。 创建 Oracle 数据源
要连接到数据库,请创建一个将存储您连接详细信息的数据源。
选择您要创建的数据源。 您可以通过以下任一方式执行此操作:
在主菜单中,转到 并选择 Oracle。
在 数据库 工具窗口 的工具栏上,点击
新建。 导航到 数据源 并选择 Oracle。

在 连接类型 列表中,选择 TNS。
在 驱动程序 列表中,选择 OCI。
点击 驱动程序 链接,并选择您在 步骤 1 中创建的驱动程序条目(在我们的情况下, Oracle [OCI])。
在 TNSADMIN 字段中,点击浏览按钮并导航到包含 Instant Client 文件的目录(在我们的情况下, ~/Oracle/instantclient_19_8/network/admin )。
在 TNS 名称 字段中,使用自动补全(Ctrl+Space )选择要使用的服务名(请参见 tnsnames.ora 钱包文件中的别名值)。
为 Oracle 用户指定凭据。
确保可以使用提供的详细信息建立数据库连接。 为此,请点击连接详细信息部分底部的 测试连接 链接。

如果遇到任何连接问题,请参阅 无法连接到数据库 页面。
(可选)默认情况下,仅默认架构会被内省并可供使用。 如果还希望使用其他架构,请在 架构 选项卡中选择它们以进行内省。

点击 确定 以创建数据源。
在 数据库 工具窗口 中找到您的新数据源。
