WebStorm 2025.2 Help

使用 Wallet 和 OCI 创建 Oracle 数据源

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 连接准备驱动程序

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

    • 数据库 工具窗口的工具栏中,单击 数据源图标数据源

    • Shift+Enter

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

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

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

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

  6. 在文件浏览器中,导航至 Instant Client 文件所在目录(本教程中为 ~/Oracle/instantclient_19_8 ),然后单击 打开

  7. 您可以使用 WebStorm 提供的驱动,或使用 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 数据源 创建 Oracle Cloud 数据源

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

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

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

    • 数据库 工具窗口中,点击工具栏上的 新建图标新建。 导航到 数据源 并选择 Oracle

    创建新数据源
  2. 连接类型 列表中选择 TNS

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

  4. 点击 驱动程序 链接,然后选择在 步骤 1 中创建的驱动条目(在本例中为 Oracle [Cloud,OCI])。

  5. TNSADMIN 字段中,点击浏览按钮并导航到存放 Instant Client 文件的目录(本例中为 ~/Oracle/instantclient_19_8/network/admin )。

  6. TNS 名称 字段中,使用自动补全功能(Ctrl+Space )选择要使用的服务名称(请查看 tnsnames.ora wallet 文件中别名的值)。

  7. 为 Oracle 用户指定凭据。

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

    测试连接链接

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

  9. (可选)默认情况下,仅会对默认 schema 进行内省操作,并可供使用。 如果您也希望使用其他 schema,请在 架构 选项卡中为其启用内省。

    “数据源和驱动程序”对话框的 Schemas 选项卡
  10. 点击 确定 创建数据源。

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

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

    • 如需了解在 WebStorm 中操作数据库对象的更多信息,请参阅 数据库对象

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

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

创建 Oracle Cloud 数据源
最后修改日期: 2025年 9月 26日