使用 Wallet 和 OCI 创建 Oracle 数据源
官方文档与软件
有关 Oracle 的完整信息,请参阅 官方文档。
要下载 Oracle 数据库软件,请参阅 官方下载页面。
如需获取更多版本的 Oracle JDBC 驱动程序,请参阅 官方 JDBC 驱动下载。
请从 oracle.com 上的 Oracle Instant Client 下载页面 下载适用于您的操作系统的以下 Oracle Instant Client(OCI)软件包:
基础包
SQL*Plus 包
JDBC 补充包
从 oracle.com 上的 Oracle Database 12.2.0.1 JDBC Driver & UCP 下载页面 下载 oraclepki.jar 。
准备包含钱包文件的 ZIP 压缩包。 有关下载 wallet 的更多信息,请参阅 docs.oracle.com 上的下载客户端凭据(Wallet)。
WebStorm 使用 JDBC 驱动程序通过 TNS 协议连接到 Oracle 服务器。 可用的驱动模式包括:
在 Thin 模式下,JDBC 驱动程序始终连接到 TNS 监听器。 在此模式下,可以使用不同版本的 JDBC 驱动程序。
在 OCI 模式下,JDBC 驱动程序使用本地库。 在此情况下,JDBC 驱动程序的版本必须与本地库的版本一致。
Oracle Wallet 是一组文件,用于存储所有用户凭据,如证书、证书请求和私钥。 您可以使用 Oracle 工具创建 wallet,或请您的 Oracle 服务器管理员生成 wallet。 有关 wallet 的更多信息,请参阅 Creating and Managing 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 连接准备驱动程序 为 OCI 连接准备驱动程序
通过以下方式之一打开数据源属性:
在 数据库 工具窗口的工具栏中,单击
数据源。
按 Shift+Enter。

在 数据源和驱动程序 对话框中,单击 驱动程序 选项卡。
在驱动程序列表中,右键单击 Oracle 驱动程序,然后选择 复制。
更改复制的 Oracle 驱动程序名称(例如,
Oracle [Cloud,OCI])。在 驱动程序文件 窗格中,单击 添加 图标(
),然后选择 原生库路径…。
在文件浏览器中,导航至 Instant Client 文件所在目录(本教程中为 ~/Oracle/instantclient_19_8 ),然后单击 打开。
您可以使用 WebStorm 提供的驱动,或使用 Instant Client 提供的驱动。
请将文件版本更改为与 Instant Client 版本一致。

在 驱动程序文件 窗格中,点击 添加 图标(
),然后选择 自定义JAR…。
在文件浏览器中,导航到存放 Instant Client 文件的目录(本教程中为 ~/Oracle/instantclient_19_8 )。
在该目录中,选择以下文件: ojdbc8.jar 、 orai18n.jar 和 oraclepki.jar 。
点击 打开。

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

从 连接类型 列表中选择 TNS。
从 驱动程序 列表中选择 OCI。
点击 驱动程序 链接,然后选择在 步骤 1 中创建的驱动条目(在本例中为 Oracle [Cloud,OCI])。
在 TNSADMIN 字段中,点击浏览按钮并导航到存放 Instant Client 文件的目录(本例中为 ~/Oracle/instantclient_19_8/network/admin )。
在 TNS 名称 字段中,使用自动补全功能(Ctrl+Space )选择要使用的服务名称(请查看 tnsnames.ora wallet 文件中别名的值)。
为 Oracle 用户指定凭据。
确保可以使用提供的信息成功建立数据库连接。 为此,请点击连接详情部分底部的 测试连接 链接。

如果遇到任何连接问题,请参考 无法连接到数据库 页面。
(可选)默认情况下,仅会对默认 schema 进行内省操作,并可供使用。 如果您也希望使用其他 schema,请在 架构 选项卡中为其启用内省。

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