GoLand 2025.2 Help

Oracle

启用 数据库工具和 SQL 插件

此功能依赖于 数据库工具和 SQL 插件，该插件在 GoLand 中默认捆绑并启用。 如果相关功能不可用，请确保未禁用该插件。

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

  2. 打开 已安装 选项卡，找到 数据库工具和 SQL 插件，并选中插件名称旁的复选框。

准备工作

This topic presents a general procedure on how you can create a data source for the connection to your Oracle database in GoLand, and run a test connection. 假设您已准备好必要的连接信息，并且数据库正在运行。

例如，如果您希望在本机上运行数据库并连接该数据库，则必须首先在本机上安装相应的 DBMS 软件。

如需了解您的 DBMS 软件，请参考其 官方文档。

连接到 Oracle 数据库

要连接到数据库，请创建一个用于存储连接信息的数据源。

  1. 选择您要创建的数据源。 您可以通过以下方式之一完成该操作：

    • 在主菜单中，依次转到 文件(F) | 新建(N) | 数据源 ，然后选择 Oracle。

    • 在 go.mod 文件中点击 创建新数据源 边距图标（）。

      数据库边距图标

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

    创建新的数据源

  2. 在 常规 选项卡的 数据源和驱动程序 对话框右侧窗格中，指定驱动和连接类型。

    1. 在 驱动程序 列表中选择用于连接的 JDBC 驱动。

      对于 Oracle，支持的驱动为 Oracle 和 9.X、10.X、11.1 版的 Oracle。 如需了解有关驱动类型的更多信息，请参阅 Oracle JDBC FAQ。

    2. 在 连接类型 列表中，根据您拥有的连接信息选择连接类型：

      • SID ：使用 Oracle 实例的唯一名称（在工作站上运行的进程）。

      • 服务名称 ：使用指向一个或多个 Oracle 实例的别名。

      • TNS ：使用 tnsnames.ora 配置文件。

      • Long ：使用带高级参数的扩展 JDBC URL 格式。

      • 仅限 URL ：仅使用 URL 进行连接。

      对于 仅限 URL 连接类型 ，所填的 JDBC URL 将完整使用，包括数据库凭据。

      对于其他连接类型，JDBC URL 会被拆分为连接参数。 您可以分别指定这些信息并使用自动生成的 URL，也可以直接在相应字段中输入该 URL。

    “数据源与驱动”对话框的“常规”选项卡

  3. 请检查连接设置区域底部是否存在 下载缺失的驱动程序文件 链接。 点击此链接以下载与数据库交互所需的驱动程序。 如需直接下载链接，请参阅 JetBrains JDBC drivers 页面。

    “下载缺失的驱动文件”链接

    下载的 JDBC 驱动程序将存放于 GoLand 配置目录。

    您也可以使用自己的数据库驱动程序，而不是提供的那些。 有关使用您自己的驱动程序连接数据库的更多信息，请参阅 Add a user driver to an existing connection。

    如果没有 下载缺失的驱动程序文件 链接，说明您已具备所需的驱动程序。

  4. 请指定数据库连接详细信息。 或者，将 JDBC URL 粘贴到 URL 字段中。

    1. 在 主机 字段中输入服务器地址。

    2. 在 端口 字段中输入 Oracle 的端口号。 默认端口为 1521。

    3. 在 SID 字段中，指定 Oracle 实例的唯一名称（在工作站上运行的进程）。

      有关更多信息，请参阅 特定 DBMS 的 General 选项卡参考。

    4. 在 驱动程序 列表中，选择要用于连接的 Oracle JDBC 驱动程序模式：

      • Thin ：驱动程序直接连接到服务器。

      • OCI 和 OCI8 ：驱动程序使用本地库连接到服务器。

    5. 在 身份验证 下拉列表中，选择用于验证连接的身份验证方法。 以下选项可用：

      • 用户与密码 ：使用登录名和密码。

      • Kerberos ：使用 Kerberos 进行身份验证。 需要 Kerberos 服务器并通过 kinit 进行身份验证。

      • SYSDBA ：以 SYSDBA 身份连接。

      • SYSOPER ：以 SYSOPER 身份连接。

      • 无身份验证 ：无需身份验证。

    6. 在 用户 和 密码 字段中输入您的用户凭据。

      若无需使用密码，请将 密码 字段留空。

      若需删除已输入的密码，请右键点击 密码 字段并选择 设为空。

      “设为空”上下文菜单操作

    7. 在 URL 字段中，GoLand 会根据其他连接设置的值自动生成 JDBC URL。

      如需使用带有特定附加设置的 JDBC URL，请将其粘贴到 URL 字段中。 通用的 URL 格式如下：

      • 格式： jdbc:oracle:thin:@<host_address>:<port_number>:<instance_name>

      • 示例： jdbc:oracle:thin:@127.0.0.1:1521:XE

      有关 URL 格式的更多信息，请参阅 Oracle 官方文档。

    数据库连接详情

    1. 在 主机 字段中输入服务器地址。

    2. 在 端口 字段中输入 Oracle 的端口号。 默认端口为 1521。

    3. 在 服务 字段中输入要使用的 Oracle 实例的别名。

    4. 在 驱动程序 列表中，选择要用于连接的 Oracle JDBC 驱动程序模式：

      • Thin ：驱动程序直接连接到服务器。

      • OCI 和 OCI8 ：驱动程序使用本地库连接到服务器。

    5. 在 身份验证 下拉列表中，选择用于验证连接的身份验证方法。 以下选项可用：

      • 用户与密码 ：使用登录名和密码。

      • Kerberos ：使用 Kerberos 进行身份验证。 需要 Kerberos 服务器并通过 kinit 进行身份验证。

      • SYSDBA ：以 SYSDBA 身份连接。

      • SYSOPER ：以 SYSOPER 身份连接。

      • 无身份验证 ：无需身份验证。

    6. 在 用户 和 密码 字段中输入您的用户凭据。

      若无需使用密码，请将 密码 字段留空。

      若需删除已输入的密码，请右键点击 密码 字段并选择 设为空。

      “设为空”上下文菜单操作

    7. 在 URL 字段中，GoLand 会根据其他连接设置的值自动生成 JDBC URL。

      如需使用带有特定附加设置的 JDBC URL，请将其粘贴到 URL 字段中。 通用的 URL 格式如下：

      • 格式： jdbc:oracle:thin:@//<host_address>:<port_number>/<instance_alias>

      • 示例： jdbc:oracle:thin:@//127.0.0.1:1521/XE

      有关 URL 格式的更多信息，请参阅 Oracle 官方文档。

    数据库连接详情

    1. 在 TNSADMIN 字段中，指定包含 tnsnames.ora 的文件夹路径。 或者，单击 打开 图标（打开按钮 ），然后导航至对应位置。

      有关详细信息，请参阅 连接设置及 DBMS 专属属性。

    2. 在 TNS 名称 字段中指定要使用的服务名（如果存在多个）。

      有关详细信息，请参阅 特定 DBMS 的“常规”选项卡参考。

    3. 从 驱动程序 列表中选择用于连接的 Oracle JDBC 驱动模式：

      • Thin ：驱动程序直接连接至服务器。

      • OCI 和 OCI8 ：驱动程序使用本机库连接至服务器。

    4. 从 身份验证 下拉列表中选择用于验证连接的身份验证方式。 可用选项如下：

      • 用户与密码 ：使用您的登录名和密码。

      • Kerberos ：使用 Kerberos 进行身份验证。 需要 Kerberos 服务器并使用 kinit 进行身份验证。

      • SYSDBA ：以 SYSDBA 身份连接。

      • SYSOPER ：以 SYSOPER 身份连接。

      • 无身份验证 ：不需要身份验证。

    5. 在 用户 和 密码 字段中输入您的用户凭据。

      要使用无密码连接，请将 密码 字段留空。

      要删除输入的密码，请右键单击 密码 字段，然后选择 设为空。

      “设为空”上下文菜单操作

    6. 在 URL 字段中，GoLand 会通过其他连接设置的值自动生成 JDBC URL。

      如果需要使用包含附加设置的 JDBC URL，请将其粘贴至 URL 字段。 通用的 URL 格式如下：

      • 格式： jdbc:oracle:thin:@<service_name>

      • 示例： jdbc:oracle:thin:@myServiceName

      有关 URL 格式的详细信息，请参阅 Oracle 官方文档。

    数据库连接详情

    1. 在 主机 字段中输入服务器地址。

    2. 在 端口 字段中输入 Oracle 端口。 默认端口为 1521。

    3. 在 服务 字段中输入要使用的 Oracle 实例别名。

    4. 从 驱动程序 列表中选择用于连接的 Oracle JDBC 驱动模式：

      • Thin ：驱动程序直接连接至服务器。

      • OCI 和 OCI8 ：驱动程序使用本机库连接至服务器。

    5. 从 身份验证 下拉列表中选择用于验证连接的身份验证方式。 可用选项如下：

      • 用户与密码 ：使用您的登录名和密码。

      • Kerberos ：使用 Kerberos 进行身份验证。 需要 Kerberos 服务器并使用 kinit 进行身份验证。

      • SYSDBA ：以 SYSDBA 身份连接。

      • SYSOPER ：以 SYSOPER 身份连接。

      • 无身份验证 ：不需要身份验证。

    6. 在 用户 和 密码 字段中输入您的用户凭据。

      要使用无密码连接，请将 密码 字段留空。

      要删除输入的密码，请右键单击 密码 字段，然后选择 设为空。

      “设为空”上下文菜单操作

    7. 在 URL 字段中粘贴包含所需参数的扩展格式 JDBC URL。

      有关 URL 格式的详细信息，请参阅 Oracle 官方文档。

    数据库连接详情

    1. 从 身份验证 下拉列表中选择用于验证连接的身份验证方式。 可用选项如下：

      • 用户与密码 ：使用您的登录名和密码。

      • Kerberos ：使用 Kerberos 进行身份验证。 需要 Kerberos 服务器并使用 kinit 进行身份验证。

      • SYSDBA ：以 SYSDBA 身份连接。

      • SYSOPER ：以 SYSOPER 身份连接。

      • 无身份验证 ：不需要身份验证。

    2. 在 用户 和 密码 字段中输入您的用户凭据。

      要使用无密码连接，请将 密码 字段留空。

      要删除输入的密码，请右键单击 密码 字段，然后选择 设为空。

      “设为空”上下文菜单操作

    3. 在 URL 字段中，GoLand 会通过其他连接设置的值自动生成 JDBC URL。

      如果需要使用包含附加设置的 JDBC URL，请将其粘贴至 URL 字段。

      有关 URL 格式的详细信息，请参阅 Oracle 官方文档。

    数据库连接详情

    有关 常规 和 数据源和驱动程序 对话框的其他标签页（Shift+Enter ）中的连接设置及属性的参考信息，请参阅 连接设置及 DBMS 专属属性。

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

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

  6. （可选）默认情况下，仅对默认 schema 执行结构分析并可供使用。 如果您还希望使用其他 schema，请在 架构 标签页中选择其以进行结构分析。

    “数据源与驱动”对话框的“架构”选项卡

  7. 单击 确定 以创建数据源。

  8. 在 数据库 工具窗口中查找新的数据源。

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

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

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

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

连接设置及 DBMS 专属属性

连接设置

有关 常规 和其他 数据源和驱动程序 对话框标签页（Shift+Enter ）中的连接设置（例如 主机、 端口 等）的参考信息，请参阅 数据源。

DBMS 专属属性

常规选项卡

项

说明

连接类型

驱动程序

Oracle JDBC 驱动程序模式列表。

  • SID

  • 服务名称

  • TNS

  • Long

SID

Oracle 实例的唯一名称（在工作站上运行的进程）。 如需获取正确值，请查看服务器主机上的环境变量 ORACLE_SID ，或联系您的数据库管理员。 常用值为 XE 或 ORCL。

SID

服务

Oracle 实例（或多个实例）的别名。

服务名称

TNSADMIN

包含 tnsnames.ora 配置文件的文件夹路径。 有关 tnsnames.ora 的详细信息，请参阅 tnsnames.ora 文件中的本地命名参数。

TNS

TNS 名称

如果存在多个服务，请在连接时使用您要连接的服务名称。 要查找服务名称，请查看 net_service_name 在 tnsnames.ora 中的值。

选项选项卡

项

说明

启用 DBMS_OUTPUT

为数据库启用 DBMS_OUTPUT。

最后修改日期： 2025年 9月 26日
无法连接到 MySQL 5.1使用 OCI 创建 Oracle 数据源