GoLand 2025.2 Help

数据源与驱动对话框

要访问 数据源和驱动程序 对话框,请执行以下任一操作:

  • 数据库 工具窗口中,点击 数据源属性 按钮 数据源属性按钮

  • 数据库 工具窗口中,点击 添加 按钮 添加按钮 并导航至 数据源 | <data_source_vendor>

概览

数据源和驱动程序 对话框中,您可以管理 数据源 和数据库驱动程序。

数据源与驱动对话框

左侧面板控件

当您从数据源和驱动程序列表中选择某个项目时,该项目的设置将显示在对话框右侧。

工具栏

项目

快捷键

描述

添加按钮

Alt+Insert

创建数据源或驱动程序。

移除图标

Delete

从列表中移除所选项目。

复制图标

Ctrl+D

创建所选数据源或驱动程序的副本。

转到驱动图标

Ctrl+B

导航至与所选数据源关联的驱动程序设置。

设为全局图标 移至项目图标

将所选数据源移动到全局或项目级别。

有关全局级别和项目级别的更多信息,请参见 数据源

返回图标 前进图标

在最近使用的项目之间切换。

上下文菜单

项目

快捷键

描述

添加按钮 添加

Alt+Insert

创建数据源或驱动程序。

    移除图标 移除

    Delete

    从列表中移除所选项目。

    复制图标 复制

    Ctrl+D

    创建所选数据源或驱动程序的副本。

    转到驱动图标 跳转到驱动程序

    Ctrl+B

    导航至与所选数据源关联的驱动程序设置。

    设为全局图标 设为全局

    移至项目图标 移至项目

    将所选数据源移动到全局或项目级别。

    有关全局级别和项目级别的更多信息,请参见

    数据源

    更改驱动程序

    将数据源与驱动程序关联。

    重置更改图标 重置更改

    Ctrl+Alt+Z

    还原所选项目的更改。

    加载源

    为所选类别的架构加载数据库对象的源代码。

    显示驱动使用位置图标 显示驱动程序使用情况

    Alt+F7

    显示使用所选驱动程序的数据源。

    数据源

    数据源 部分包含常规数据源和 DDL 数据源的设置。

    常规

    常规数据源的设置面板包含以下选项卡: 常规选项SSH/SSL架构高级

    数据源与驱动对话框:常规选项卡

    有关常规数据源的管理与创建的更多信息,请参见 数据源。 要了解特定数据库的连接设置,请参见专门的主题。

    创建和配置不同数据库的数据源

    常规

    常规 选项卡包含数据库连接所需指定的设置。

    该选项卡上的字段和控件集合取决于 连接类型 列表中选择的选项。

    数据源与驱动对话框:数据源设置的常规选项卡

    项目

    描述

    连接类型

    用于数据库连接的连接类型。

    • 仅 URL

      通常,此选项用于直接编辑数据库连接 URL。

      选择此选项后,仅以下字段可用: 用户密码URL

      应直接在字段中编辑 URL。 如有必要,您的用户名和密码可在相应字段中指定,或在 URL 中按照所使用 JDBC 驱动程序所需的格式指定。

    • 其他连接类型

      使用任何其他选项(这些选项特定于 DBMS)时,GoLand 会使用 URL 字段以上的信息自动生成数据库连接 URL。 在所有这类情况下,通常无需编辑 URL(当然您也可以根据需要进行编辑)。

    驱动程序

    驱动程序 列表中指定用于连接的驱动程序。

    文件

    数据库文件的路径。

    使用 打开 图标(打开图标 )选择现有数据库文件。

    保存 图标(保存按钮 )创建数据库文件副本并更改路径为副本的位置。

    路径

    数据库文件或文件夹的路径。

    使用 打开 图标(打开图标 )选择现有数据库文件或文件夹。

    主机

    数据库所在计算机的主机名(域名)或 IP 地址(IPv4 或 IPv6)。 如果数据库位于本地计算机上,请指定 localhost 127.0.0.1

    If you are using SSH, the database host must be accessible by the specified domain name or IP address from the computer on which the SSH proxy runs. 请参见 SSH/SSL 选项卡

    端口

    数据库端口号。

    数据库

    目标数据库或架构的名称。

    用户

    您的数据库用户帐户名称。

    密码

    数据库用户的密码。

    保存

    保存密码字段的设置。 您可以选择以下选项来存储您的密码:

    • 从不 :每次与数据库建立连接时都会提示输入密码。

    • 直到重启 :密码仅保存在当前 GoLand 运行期间。 如果退出 GoLand 并重新打开,您需要重新输入密码。

    • 对于会话 :密码仅保存在与数据库的当前连接会话中(直到您断开连接为止)。 您可以通过点击 停用 图标(终止图标 )或 Ctrl+F2 来终止连接。

    • 永久 :密码保存在 GoLand 存储中。 下次打开 GoLand 时,您无需再次输入密码。

    • IDE 密码设置 :点击以访问 IDE 密码存储设置。 您也可以通过打开 外观与行为 | 系统设置 | 密码 设置页面 Ctrl+Alt+S 来访问这些设置。 有关 IDE 密码设置的更多信息,请参见 密码 主题。

    创建数据库

    Adds an argument to the URL to create a database. 该选项仅在某些数据库管理系统中可用(例如,在 Apache Derby(嵌入式) 中)。

    URL

    GoLand 使用此 URL 来连接到数据库。 用于指定 URL 的用户界面因您在 连接类型 列表中选择的选项而异。

    测试连接

    Verifies that the database connection settings are correct and GoLand can communicate with the database. 要复制通信信息,请点击 复制

    选项

    选项 选项卡包含数据库连接设置。

    选项卡中的字段和控件集取决于您在 连接类型 列表中选择的选项。

    数据源与驱动对话框:数据源设置的选项选项卡

    项目

    描述

    连接

    Read-only

    设置只读状态。 选中该复选框以防止数据源被意外修改。

    如果选中该复选框,您将无法在 数据编辑器 中修改数据。

    如果驱动程序不支持只读状态,仍可能在 查询控制台 中修改数据。

    事务控制

    设置数据库事务的 隔离级别 和事务提交的方式。

    • 自动 :在将本地更改提交到数据库服务器时,当前事务将自动提交。

    • 手动 :提交到数据库服务器的更改将在一个事务中累积,可以进行提交或回滚。

    切换架构

    定义 GoLand 用于切换 schema 的模式。

    • 自动 :自动或手动切换 schema。 启用该选项后,之前配置的搜索路径或当前 schema 会在 IDE 重启之间自动恢复。

    • 手动 :仅手动切换 schema。

    • 禁用 :不切换 schema。

    时区

    选择用于数据源的时区。 例如,选择数据源连接的主机的时区。

    单会话模式

    启用 单会话模式。 单会话模式 表示数据源与所有控制台使用同一个会话。 该模式允许您在数据库树中查看临时对象,或在不同的 控制台 中使用同一个事务。 有关控制台的更多信息,请参见 查询控制台

    保持活动查询的运行间隔

    运行 keep-alive 查询以保持连接活动。 您可以在驱动设置中为不受支持的数据库定义自定义查询。

    此时间后自动断开

    在指定秒数后与数据库断开连接。

    单数据库模式(S)

    在数据库树视图中,仅显示并启用您在连接设置中指定的数据库。

    连接到数据源时,GoLand 可以检索并显示该数据源拥有的所有数据库。 但在某些情况下(例如,在 PgBouncer 的某些设置下),您只能访问或允许访问特定数据库。 在启用 单数据库模式(S) 的数据库树视图中,仅显示您在连接设置中指定的数据库。

    建议将此设置用于 PostgreSQL、Azure SQL 数据库、Greenplum、Amazon Redshift。

    启动脚本

    每次建立连接时运行一个 SQL 查询。

    要在启动脚本中使用 内置 IDE 宏 ,请点击 插入宏

    注意 :如果清除 单会话模式 复选框,则每个新的 查询控制台 都会创建一个新连接。

    自省

    自动同步

    自动同步数据库的实际状态。 数据库的状态是指您在 数据库 工具窗口中看到的数据库树视图。

    如果选中 自动同步 复选框,数据源视图将自动更新:

    • 当您在 数据源和驱动程序 对话框中点击 确定 时。

    • 在与数据源关联的 数据库控制台中运行 DDL SQL 语句时。

      从 2024.2 版开始,对于 Oracle 和 Microsoft SQL Server,GoLand 会分析哪些对象可能会被查询修改,并仅刷新这些对象的集合。

    如果清除了 自动同步 复选框,则仅在您点击 刷新 按钮 刷新按钮 或在工具栏中按下 Ctrl+F5 时, 数据库 工具窗口中的数据源视图才会与数据库的实际状态同步。

    加载以下对象的源

    为所选模式类别加载视图、过程、包及其他数据库对象的源代码:所有模式(所有架构 )、排除系统模式的所有模式(除系统架构之外的所有架构 )或禁用此功能()。

    若要同时更改多个数据源的此设置,请选择相应的数据源。 右键点击所选项,依次选择 加载源代码并选择一个选项。

    默认级别

    数据库对象的默认自动导入级别。

    使用会话模板

    选择用于您会话的 模板

    编辑过时的DDL 时发出警告

    如果缓存的 DDL 与数据库中的实际 DDL 不一致,则显示通知。

    每次打开源代码时,GoLand 都会显示在索引过程中加载的版本。 但如果他人从其他工作站修改了源代码,则已索引版本就会过时。

    如果您的版本早于数据库中的版本,您会看到以下通知: 缓存对象与数据库中的对象不同

    跟踪数据库/架构创建和删除

    当您创建、删除或重命名架构时,GoLand 会在自动导入范围窗口中更新可用架构列表。 要查看自动导入范围,请点击 数据库 工具窗口中数据源名称旁边的按钮。

    内省范围窗口

    为没有内省的系统目录使用预内省的对象

    切换是否使用系统目录中预导入的对象。

    如需了解有关自动导入和系统目录的更多信息,请参阅 系统目录中预先内省的对象

    自动导入间隔 N 分钟

    以指定的分钟数为间隔对数据源执行一次自动导入。

    虚拟对象和特性

    定义 external-data.xml 的路径,该路径存储虚拟外键的关系、虚拟列的表达式和虚拟视图的语句。

    如需了解有关虚拟数据库对象的更多信息,请参阅 虚拟对象相关主题

    其他

    代码样式

    选择要用于架构的代码样式。 如需了解有关代码样式自定义的更多信息,请参阅 SQL 的代码样式

    连接前

    选择 GoLand 在首次连接之前(即 JDBC 驱动程序开始工作时)将要执行的任务。 任务将依次执行。

    会话模板

    为您的会话创建模板。 模板设置将覆盖数据源的常规连接设置。 在模板中,您可以设置以下选项: 身份验证只读启动脚本驱动程序

    SSH/SSL

    SSH/SSL 选项卡包含 SSHSSL 连接的设置。

    数据源与驱动对话框:数据源设置的 SSH/SSL 选项卡
    SSH

    项目

    描述

    使用SSH 隧道(H)

    选中此复选框以启用通过 SSH 连接。 然后从列表中选择一个已创建的 SSH 配置,或点击 浏览按钮 并按照 创建 SSH 配置 中所述创建新配置。

    SSH 配置

    选择要用于连接的 SSH 配置。

    要创建新的 SSH 配置,请点击 添加 SSH 配置 按钮(浏览按钮)。 或者,按下 Shift+Enter

    要复制现有的 SSH 配置,请点击 复制 按钮(复制配置按钮)。

    SSL

    项目

    描述

    使用 SSL 隧道

    启用以配置 SSL 连接的相关设置。

    复制自

    从现有数据源复制 SSH 设置。

    点击链接并选择相应的数据源。

    CA 文件(A)

    指定 SSL 证书颁发机构(CA)证书文件的路径。 证书文件必须与服务器使用的证书相同。

    使用信任库

    选择要使用其所含证书的信任库。

    • IDE :使用 IDE 接受的证书。 您可以在 设置 | 外观与行为 | 系统设置 | 服务器证书 中添加新的受信证书。

    • JAVA :使用 JAVA 信任库的证书。

    • 系统 :使用系统信任库的证书。

    JAVA系统 证书可能需要更新。

    客户端证书文件

    指定您的(客户端)公钥证书文件路径。

    客户端密钥文件(K)

    指定您的(客户端)私钥文件路径。

    架构

    Select the databases and schemas to be shown in the 数据库 tool window .

    数据源与驱动对话框:数据源设置的架构选项卡

    说明

    刷新按钮

    刷新数据库和架构列表。

    全部展开按钮

    展开所有树中的节点。

    全部折叠按钮

    折叠所有树中的节点。

    筛选字段

    筛选树中的内容。仅显示名称包含指定文本的数据库和架构。 仅显示名称包含指定文本的数据库和架构。

    架构模式(P)

    Define a pattern to select the necessary databases and schemas. 若要获取所用语法的信息,请将插入符号置于该字段中并按下 Ctrl+Q

    • @ :当前数据库或架构。

    • *: every database or schema. 您可以在 *: 之后列出架构。

    请参考以下示例:

    • *:* :所有数据库中的全部架构。

    • @:* :当前数据库中的所有架构。

    • @:@ :仅当前架构。

    • *:dbo|@:@|db1:s1,s2,s3 :所有数据库中的 dbo 架构、当前架构、 db1 数据库中的 s1,s2,s3 架构。

    对象筛选器(F)

    为每个数据源限制在 数据库 工具窗口中显示的表和其他数据库对象的集合。

    例如,如果将解析范围限制为 table:actor.* ,则在 数据库 工具窗口(视图(V) | 工具窗口 | 数据库 )中仅可访问 actor 表。

    All other tables will be out of the scope. GoLand 不会解析未在 数据库 工具窗口中显示的对象。

    对象未解析

    在为 对象筛选器(F) 字段编写表达式时使用以下模式。

    <类型>:[-]<模式> ,其中:

    • <类型> 可以是 aggregate、collation、event、fdw、ftable、mview、operator、package、role、routine、sequence、synonym、table、user、view、vtable 中的任意一个。

    • <模式> 是一个正则表达式。 要排除某项,请在前面添加 - (减号)。 有关正则表达式的更多信息,请参阅 JavaTM 2 Platform Standard Edition 5.0 API 规范中的 Class Patterns

    显示内部系统架构

    显示或隐藏内部系统架构(例如, pg_toastpg_temp)。 该选项仅适用于 PostgreSQL。

    显示模板数据库

    显示或隐藏模板数据库(例如, template1template0)。 该选项仅适用于 PostgreSQL。

    高级

    数据源与驱动对话框:数据源设置的高级选项卡

    高级 选项卡包含数据库连接属性、选项及 JVM 数据库驱动程序的环境变量。

    高级 选项卡中的表显示了一组连接选项,它们作为键值对传递给数据库驱动程序。

    当在 名称 列选择单元格时,会在表格下方显示相应选项的说明。

    要添加新行,请开始在最后一行编辑值,其中显示 <user defined> 和 <value>。 新行将自动添加到表中。

    说明

    虚拟机选项

    JVM 的数据库驱动程序选项。

    对于某些 Oracle Database 版本(例如 Oracle 版本 9),当您与数据库服务器位于不同时区时,可能会出现连接问题。 您可以在 VM 选项 字段中指定时区的时间偏移(例如 -Duser.timezone=UTC+03:00)。 或者,在 高级 选项卡中的表内,将变量 oracle.jdbc.timezoneAsRegion 设置为 false

    虚拟机环境

    数据库驱动程序 JVM 的环境变量。

    例如,在 Oracle 数据库中与编码相关的问题可通过设置变量 NLS_LANG (如 NLS_LANG=Russian_CIS.CL8MSWIN1251 )来解决。 有关详细信息,请参阅 Oracle NLS_LANG 常见问题

    工作目录

    处理与数据源交互过程的工作目录。同时,所有相对路径都相对于该目录进行解析(例如驱动程序属性中的路径)。 同时,所有相对路径都相对于该目录进行解析(例如驱动程序属性中的路径)。

    例如,如果创建基于文件的数据库(如 SQLite)且未设置 SQLITE 文件路径,则该文件将在此工作目录中创建。

    有关详细信息,请参阅您的数据库管理系统文档。

    DDL 数据源

    DDL 数据源由其名称定义,可引用一个或多个 DDL 文件及另一个数据源(父数据源)。

    说明

    名称

    数据源名称。

    包含所需 DDL 定义的文件列表。

    • 添加按钮 Alt+Insert。 将一个或多个 DDL SQL 文件添加到数据源定义中。 在打开的对话框中,选择所需的文件。

    • 移除按钮Alt+Delete)。 从列表中移除所选文件。

    • 上移按钮Alt+Up)。 将所选文件在列表中上移一行。

    • 下移按钮Alt+Down)。 将所选文件在列表中下移一行。

    扩展

    可选地,您可以在 扩展 列表中选择另一个数据源作为父级。 结果是,您正在编辑的数据源将继承其父级的所有 DDL 定义。

    如果您不希望使用父数据源,请选择 <无>

    驱动

    驱动程序设置窗格包含以下选项卡: 常规选项高级

    常规

    常规 选项卡包含驱动程序文件、URL 模板和驱动程序类的设置。

    数据源与驱动对话框:驱动设置的常规选项卡

    项目

    描述

    要使用的驱动程序类的完全限定名称。

    驱动程序文件

    GoLand 使用 JDBC drivers 与数据库进行交互。 您可以从 GoLand 驱动程序仓库下载并使用驱动程序,也可以指定存储在计算机上的驱动程序。

    要下载并使用最新的驱动程序版本,请单击 下载 ver. N 链接。

    您还可以指定并使用具有特定版本号的驱动程序。 单击 ver. <version_number> 链接并选择您要使用的驱动程序版本。 所选版本将被自动下载并应用。

    您可以使用计算机中已有的驱动程序。 在这种情况下,请单击 添加 按钮 添加按钮 并选择驱动程序文件(JAR 扩展名)。

    URL 模板

    用于构建数据库 URL 的模板。 大括号中的文本表示变量。 请参阅以下示例:

    • {host} :数据库主机的域名或 IP 地址。

    • {port} :数据库端口号。

    • {database} :数据库或架构的名称。

    可选片段用方括号括起来,例如: [:{port}]

    模板名称与 URL option list 中选项的名称相对应。

    选项

    数据源与驱动对话框:驱动设置的选项选项卡

    项目

    描述

    连接

    事务控制

    为数据库事务设置 isolation level 以及事务提交的方式。

    • 自动 当您将本地更改提交到数据库服务器时,当前事务将自动提交。

    • 手动 提交到数据库服务器的更改将在一个可以提交或回滚的事务中进行累积。

    切换架构

    定义 GoLand 切换架构时使用的模式。

    • 自动 :自动或手动切换架构。

    • 手动 :仅手动切换架构。

    • 禁用 :不切换架构。

    启动脚本

    每次建立连接时运行的 SQL 查询。

    注意 :如果未选中 单会话模式 复选框,每个新的 查询控制台 都会创建一个新连接。

    保持活动查询

    会话保持查询,将在连接保持活动状态时运行。

    内省

    自动同步

    auto sync option 的默认设置。

    加载以下对象的源

    为所选架构类别加载数据库对象的源代码。

    发送应用程序信息

    连接到数据库服务器时,如果选中该复选框,GoLand 会发送其自身的信息。

    连接

    方言

    与相应数据源关联的 SQL 方言。

    代码样式

    选择用于使用此驱动程序的数据源的代码样式。 有关代码样式自定义的更多信息,请参阅 Code styles for SQL

    设置同步源的格式

    在同步后将代码样式应用于数据库对象的源代码。

    高级

    高级 选项卡包括 JVM 选项、环境变量,以及可作为键值对传递给数据库驱动程序的选项。

    要开始编辑表中的值,请双击相应的 字段。

    要添加一行,请开始编辑最后一行中的值,其中显示 <user&#xa0;defined> 和 <value>。 新行将自动添加到表中。

    数据源与驱动对话框:驱动设置的高级选项卡

    项目

    描述

    VM 选项

    运行数据库驱动程序的 JVM 的默认选项。 驱动程序作为 JVM 中的独立进程启动。

    VM 环境

    数据库驱动程序 JVM 的环境变量。

    例如,通过设置 NLS_LANG 变量(如 NLS_LANG=Russian_CIS.CL8MSWIN1251 ),可以解决 Oracle 数据库中的编码相关问题。 如需了解更多信息,请参阅 Oracle NLS_LANG FAQ

    专家选项

    描述

    禁用增量内省

    不要执行增量内省。 该选项适用于 Oracle、Microsoft SQL Server、PostgreSQL 等数据库。

    使用增量内省时,内省器会检测在上次内省后数据库中发生更改的对象,并仅加载这些对象。 启用此选项后,内省器将始终加载所有对象。 这可能会显著增加内省时间。

    不在对pgdatabase 的查询中使用 xmin

    在查询 pg_database 表时,不要使用 xmin 属性。 当 xminpg_database 中不存在时,请使用此变通方法。 请注意,您的数据库可能已损坏。 该选项仅适用于 PostgreSQL。

    使用JDBC 元数据内省(M)

    切换到基于 JDBC 的内省器。 适用于所有数据库。

    为了检索有关数据库对象(数据库元数据)的信息,GoLand 使用以下内省器:

    • 本地内省器(某些 DBMS 可能不支持)。 本地内省器使用特定于 DBMS 的表和视图作为元数据来源。 它可以检索特定于 DBMS 的详细信息,并生成关于数据库对象的更精确图示。

    • 基于 JDBC 的内省器(适用于所有 DBMS)。 基于 JDBC 的内省器使用 JDBC 驱动程序提供的元数据。 它只能检索有关数据库对象及其属性的标准信息。

    当本地内省器失败或不可用时,建议使用基于 JDBC 的内省器。

    当数据库服务器版本低于 GoLand 支持的最低版本时,本地内省器可能无法正常工作。

    您可以尝试切换到基于 JDBC 的内省器,以修复从数据库检索结构信息的问题。 例如,当数据库中存在的 schema 或 schema 下的数据库对象未显示在 数据库 工具窗口中时。

    隔离类路径

    隔离 JDBC 驱动程序使用的类路径。

    使用 IDE 代理设置

    将 IDE 的代理设置传递给 JDBC 进程。

    Kubernetes

    借助 GoLand,您可以连接到在 Kubernetes 集群中运行的数据库。

    对于没有专用端口的嵌入式数据库(例如 SQLite、Apache Derby 或 HSQLDB), Kubernetes 选项卡不可用。

    描述

    使用Kubernetes 端口转发

    启用端口转发。

    集群

    选择要使用的 Kubernetes 集群。

    命名空间

    选择命名空间,该命名空间决定可用资源的范围。

    资源类型

    选择资源类型。

    资源

    选择要连接的资源。

    主机端口

    输入用于转发数据的本地端口。

    容器端口

    输入集群资源的远程端口。

    DDL 映射

    数据源与驱动对话框:DDL 映射设置列表

    描述

    名称

    DDL 映射的名称。

    数据源

    设置常规数据源。

    DDL 数据源

    设置 DDL 数据源。

    范围

    设置要映射到 DDL 数据源 SQL 文件的常规数据源数据库对象的范围。

    问题

    数据源和驱动程序 对话框中,如果检测到数据源存在潜在问题,则会在 问题 菜单选项旁显示一个数字。 单击 问题 可查看问题列表及解决选项。

    检测到问题
    最后修改日期: 2025年 9月 26日