JetBrains Rider 2026.2 Help

使用 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 实例,并为您的用户授予访问权限。

  • 已配置 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. 数据库 工具窗口中,点击 新图标新建 并选择 连接到数据库

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

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

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

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

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

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

  7. 点击 驱动程序 链接并选择您在 步骤 1 中创建的驱动条目(在我们的例子中是 Oracle [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查询

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

创建 OCI 数据源
2026年 7月 17日