JetBrains Rider 2026.2 Help

使用 Wallet 和 OCI 创建 Oracle 数据源

启用 Database Tools and SQL 插件

此功能依赖于 Database Tools and SQL 插件，该插件在 JetBrains Rider 中默认捆绑并启用。 如果相关功能不可用，请确保没有禁用该插件。

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

  2. 打开 已安装 选项卡，找到 Database Tools and SQL插件，然后选中插件名称旁边的复选框。

JetBrains Rider 使用 JDBC 驱动程序通过 TNS 协议连接到 Oracle 服务器。 以下驱动模式可用：

  • 在 Thin模式下，JDBC 驱动程序总是连接到 TNS 监听器。 在此模式下，可以使用各种版本的 JDBC 驱动程序。

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

Oracle Wallet 是一组文件，存储所有用户凭证，例如证书、证书请求和私钥。 您可以使用 Oracle 工具创建钱包，也可以请您的 Oracle 服务器管理员生成钱包。 有关 wallets 的更多信息，请参阅 创建和管理 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 连接准备驱动程序

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

    • 在 数据库 工具窗口工具栏上，点击 数据源图标数据源。

    • 请按 Shift+Enter.

    打开数据源和驱动程序对话框

  2. 在 数据源和驱动程序 对话框中，点击 驱动程序 选项卡。

  3. 在驱动程序列表中，右键点击 %oracle% 驱动程序并选择 复制。

  4. 将复制的 %oracle% 驱动程序名称更改为（例如， %oracle% [Cloud, OCI]）。

  5. 在 驱动程序文件 面板中，点击 添加 图标（"添加"按钮 ）并选择 原生库路径…。

  6. 在文件浏览器中，导航到 Instant Client 文件的目录（在本教程中为 ~/Oracle/instantclient_19_8 ）并点击 打开。

  7. 您可以使用 JetBrains Rider 提供的驱动程序，或使用 Instant Client 提供的驱动程序。

    将文件版本更改为与 Instant Client 版本相同。

    IDE 提供驱动程序的驱动文件版本列表

    1. 在 驱动程序文件 面板中，点击 添加 图标（"添加"按钮 ）并选择 自定义JAR…。

    2. 在文件浏览器中，导航到包含 Instant Client 文件的目录（在本教程中为 ~/Oracle/instantclient_19_8 ）。

    3. 在目录中，选择以下文件： ojdbc8.jar 、 orai18n.jar 和 oraclepki.jar 。

    4. 单击 打开。

    立即客户端提供的驱动程序文件

第 2 步. 创建 Oracle Cloud 数据源

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

  1. 在 数据库 工具窗口中，点击 新图标新建 并选择 连接到数据库。

  2. 如果您的解决方案或其他地方定义了数据库的连接字符串，请保持 使用连接字符串 选项选中，并在 数据库类型 选择器中选择 %oracle%。

    使用 字符串 选择器从您的解决方案中选择所需的连接字符串，或手动输入，然后点击 连接。

  3. 您还可以选择 手动添加数据源 ，点击 下一步 并在 数据库源 选择器中选择 %oracle%。 按照向导步骤，通过配置各个选项来形成连接字符串。

  4. 要访问新数据库连接的所有可用选项，请在 数据库 窗口中点击 ，然后点击 新图标新建 并选择 %oracle%。

  5. 请从 连接类型 列表中选择 TNS。

  6. 请从 驱动程序 列表中选择 OCI。

  7. 点击 驱动程序 链接并选择您在 步骤 1 中创建的驱动条目（在我们的例子中是 %oracle% [Cloud, OCI]）。

  8. 在 TNSADMIN 字段中，点击浏览按钮并导航到包含 Instant Client 文件的目录（在本例中为 ~/Oracle/instantclient_19_8/network/admin ）。

  9. 在 TNS 名称 字段中，使用自动完成（Ctrl+Space ）选择要使用的服务名称（请参阅 tnsnames.ora wallet 文件中别名的值）。

  10. 为 Oracle 用户指定凭据。

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

    测试连接链接

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

  12. （可选）默认情况下，仅检查默认架构并可供使用。 如果您还想使用其他架构，请在 架构 选项卡中选择它们以进行检查。

    数据源和驱动程序对话框中的 Schemas 选项卡

  13. 请点击 确定 以创建数据源。

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

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

    • 有关在 JetBrains Rider 中处理数据库对象的更多信息，请参阅 数据库对象。

    • 要编写和运行查询，请点击数据源并按下 F4 键，打开默认的 一个select查询。

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

创建 Oracle Cloud 数据源
2026年 7月 17日
使用 OCI 创建 Oracle 数据源PostgreSQL