WebStorm 2025.2 Help

使用 OCI 创建 Oracle 数据源

WebStorm 使用 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 wallet 文件中的别名值)。

  7. 为 Oracle 用户指定凭据。

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

    测试连接链接

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

  9. (可选)默认情况下,仅默认 schema 会被解析并可供使用。 如果您还希望使用其他 schema,请在 架构 选项卡中选择要解析的 schema。

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

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

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

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

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

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

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