DataGrip 2025.2 Help

数据源和驱动程序对话框

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

  • 数据库资源管理器 中,单击 数据源属性 按钮 数据源属性按钮

  • 数据库资源管理器 中,单击 添加 按钮 "添加"按钮 ,然后导航到 数据源 | <data_source_vendor>

  • 请导航至 文件(F) | 数据源

概述

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

数据源和驱动程序对话框

左侧窗格控件

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

工具栏

项目

快捷方式

描述

"添加"按钮

Alt+Insert

创建数据源或驱动程序。

移除图标

Delete

从列表中移除选中的项目。

重复图标

Ctrl+D

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

前往 Driver 图标

Ctrl+B

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

全局化图标 项目中移动图标

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

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

返回图标 前进图标

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

上下文菜单

项目

快捷方式

描述

"添加"按钮 添加

Alt+Insert

创建数据源或驱动程序。

    移除图标 移除

    Delete

    从列表中移除选中的项目。

    重复图标 重复

    Ctrl+D

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

    前往 Driver 图标 转到驱动程序

    Ctrl+B

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

    全局化图标 设为全局

    项目中移动图标 移至项目

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

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

    数据源.

    更改驱动程序

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

    重置更改图标 重置更改

    Ctrl+Alt+Z

    还原所选项目的更改。

    加载源

    加载所选模式类别的数据库对象的源代码。

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

    Alt+F7

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

    数据源

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

    常规

    常规数据源的设置窗格包括以下选项卡: 通用选项SSH/SSL架构高级

    数据源和驱动程序对话框的常规选项卡

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

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

    通用

    通用” 选项卡包含需要为数据库连接指定的设置。

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

    数据源和驱动程序对话框:数据源设置的一般选项卡

    项目

    描述

    连接类型

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

    • URL only

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

      当您选择此选项时,仅以下字段可用: User密码URL

      您应该在该字段中直接编辑 URL。 如果需要,您的用户名和密码应在相应字段中指定,或在 URL 中以适合您使用的 JDBC 驱动程序的格式指定。

    • 其他连接类型

      当使用其他任何选项(这些选项是 DBMS 特定的)时,DataGrip 将使用 URL 字段上方字段中的信息自动生成数据库连接 URL。 在所有这些情况下,通常您不需要编辑 URL(不过,如果您愿意,也可以)。

    驱动程序

    请从 驱动程序 列表中指定您要用于连接的驱动程序。

    File

    数据库文件路径。

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

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

    Path

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

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

    主机

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

    如果您使用 SSH,数据库主机必须能够通过指定的域名或 IP 地址从运行 SSH 代理的计算机进行访问。 请查看 SSH/SSL 选项卡

    端口

    数据库端口号。

    数据库

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

    User

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

    密码

    数据库用户的密码。

    保存

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

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

    • 直到重启 :密码仅保存在当前 DataGrip 运行期间。 如果您退出 DataGrip 并重新打开,则需要再次提供密码。

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

    • 永久 :密码已保存在 DataGrip 存储中。 下次打开 DataGrip 时,您无需提供密码。

    • IDE 密码设置 :点击以访问 IDE 密码存储设置。 您还可以通过打开 外观与行为 | 系统设置 | 密码 设置页面&#xa0; Ctrl+Alt+S 访问它们。 有关 IDE 密码设置的更多信息,请参阅 密码 主题。

    创建数据库

    向 URL 添加参数以创建数据库。 此选项仅在某些数据库管理系统中可用(例如,在 Apache Derby(嵌入式) 中)。

    URL

    DataGrip 将使用的连接到数据库的 URL。 根据在 连接类型 列表中选择的不同选项,指定URL的用户界面会有所不同。

    测试连接

    验证数据库连接设置是否正确,以及 DataGrip 是否可以与数据库通信。 要复制通信信息,请点击 复制

    选项

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

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

    数据源和驱动程序对话框:数据源设置的选项卡

    项目

    描述

    连接

    Read-only

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

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

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

    事务控制

    将数据库事务的 isolation level和事务提交的模式设置。

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

    • 手册 :提交到数据库服务器的变更会累积在一个事务中,该事务可以提交或回滚。

    切换架构

    定义一个 DataGrip 用来切换 schema 的模式。

    • 自动 :自动或手动切换模式。 启用此选项时,之前配置的搜索路径或当前架构会在 IDE 重启之间自动恢复。

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

    • 禁用 :请勿更换架构。

    时区

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

    单会话模式

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

    保持活动查询的运行间隔

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

    此时间后自动断开

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

    单数据库模式(S)

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

    当您连接到数据源时,DataGrip 可以检索并显示数据源拥有的所有数据库。 但是在某些情况下(例如,使用某些 PgBouncer 设置),您只能或被允许仅使用某个特定的数据库。 在启用了 单数据库模式(S) 的数据库树状视图中,您只会看到连接设置中指定的数据库。

    请考虑为 PostgreSQL、Azure SQL 数据库、Greenplum、Amazon Redshift 使用此设置。

    启动脚本

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

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

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

    内省

    自动同步

    自动同步数据库的实际状态。 数据库的状态是指您在 数据库资源管理器 中看到的数据库树视图。

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

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

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

      从 2024.2 版本开始,对于 Oracle 和 Microsoft SQL 服务器,DataGrip 会分析查询可能修改的对象,并仅刷新这些对象的集合。

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

    加载以下对象的源

    加载所选架构类别的视图、程序、包和其他数据库对象的源代码:所有架构(所有架构 ),所有架构(不包括系统架构)(除系统架构之外的所有架构 ),或禁用此功能()。

    若要同时更改多个数据源的此设置,请选择相应的数据源。 右键点击选择区域,导航到 Load Sources并选择一个选项。

    默认级别

    数据库对象的默认内省级别。 有关自省级别的更多信息,请参阅 内省级别 主题。

    使用会话模板

    请为您的会话选择一个 模板

    编辑过时的DDL 时发出警告

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

    每次您打开源代码时,DataGrip 会显示在索引过程中加载的版本。 但如果有人从另一个工作站更改了源代码,则索引版本将变得过时。

    如果您的版本比数据库中的版本旧,您将看到以下通知: Cached object differs from the object in the database

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

    当您创建、删除或重命名模式时,DataGrip 会更新自省范围窗口中可用模式的列表。 要查看内省范围,请单击 数据库资源管理器 中数据源名称旁边的按钮。

    自省范围窗口

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

    切换是否使用预解析对象来进行系统目录。

    有关内省和系统目录的更多信息,请参阅 来自系统目录的预内省对象

    自动自省间隔 N 分钟

    在指定的分钟数内对数据源运行一次自省。

    虚拟对象和特性

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

    有关虚拟数据库对象的更多信息,请参阅 虚拟对象部分主题

    其他

    代码样式

    请选择您希望用于架构的代码样式。 有关代码样式自定义的更多信息,请参阅 SQL 代码样式

    连接前

    选择 DataGrip 在首次连接前将执行的任务(在 JDBC driver 工作的过程中开始执行)。 任务按顺序运行。

    会话模板

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

    SSH/SSL

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

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

    项目

    描述

    使用SSH 隧道(H)

    选中此复选框以启用通过 SSH 连接。 然后从列表中选择一个已创建的 SSH 配置,或单击 “浏览”按钮 并按照 使用 SSH 连接到数据库 中的描述创建一个新配置。

    SSH 配置

    请选择 SSH 配置用于连接。

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

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

    本地端口(L)

    请指定要转发连接的本地端口号。 没有默认值,这意味着 DataGrip 动态选择端口号。

    SSL

    项目

    描述

    使用 SSL 隧道

    启用配置 SSL 连接的设置。

    复制自

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

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

    CA 文件(A)

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

    使用信任库

    选择信任库以使用其中包含的证书。

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

    • JAVA :使用 JAVA truststore 证书。

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

    JAVASystem 证书可能需要更新。

    客户端证书文件

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

    客户端密钥文件(K)

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

    架构

    选择要在 数据库资源管理器 中显示的数据库和 架构

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

    项目

    描述

    刷新按钮

    刷新数据库和模式的列表。

    “全部展开”按钮

    展开所有树中的所有节点。

    “全部折叠”按钮

    折叠所有树中的所有节点。

    筛选字段

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

    架构模式(P)

    定义一个模式以选择所需的数据库和模式。 要获取关于语法的相关信息,请将光标放入该字段并按 Ctrl+Q

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

    • * :每个数据库或架构。 您可以在 *: 之后列出 schema。

    请考虑以下示例:

    • *:* :所有数据库中的所有 schema。

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

    • @:@ :仅当前架构

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

    对象筛选器(F)

    限制在 数据库资源管理器 中为每个数据源显示的表和其他数据库对象的集合。

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

    所有其他表格将不在范围内。 DataGrip 不解析未显示在 数据库资源管理器 中的对象。

    对象未解析

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

    <type>:[-]<pattern> ,其中:

    • <type> 可能是 aggregate、collation、event、fdw、ftable、mview、operator、package、role、routine、sequence、synonym、table、user、view、vtable。

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

    显示内部系统架构

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

    显示模板数据库

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

    高级

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

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

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

    当您选择 名称 列中的单元格时,对应选项的描述会显示在表格下方。

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

    项目

    描述

    虚拟机选项

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

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

    虚拟机环境

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

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

    工作目录

    处理数据源的进程的工作目录。 此外,所有相对路径都是相对于此目录解析的(例如,驱动属性中的路径)。

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

    欲了解更多信息,请参阅您的 DBMS 文档。

    DDL 数据源

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

    项目

    描述

    名称

    数据源名称。

    包含必要的 DDL 定义的文件列表。

    • "添加"按钮 Alt+Insert. 向数据源定义添加 DDL SQL 文件。 在打开的对话框中,选择所需的文件。

    • "移除"按钮Alt+Delete)。 从列表中删除选定的文件。

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

    • “下移”按钮Alt+Down)。 将选定的文件在列表中向下移动一行。

    扩展

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

    如果您不想使用父数据源,请选择 <none>

    驱动程序

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

    通用

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

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

    项目

    描述

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

    驱动程序文件

    DataGrip 使用 JDBC drivers 与数据库进行交互。 您可以从 DataGrip 驱动程序库下载并使用驱动程序,或指定您存储在电脑上的驱动程序。

    若要下载并使用最新的驱动程序版本,点击 下载版本 N 链接。

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

    您可以使用计算机上已有的驱动程序。 在这种情况下,请点击 Add 按钮 "添加"按钮 ,然后选择驱动文件(带有 JAR 扩展名)。

    URL 模板

    用于构建数据库 URL 的模板。 花括号中的文本代表变量。 请考虑以下示例:

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

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

    • {database} :数据库或模式的名称。

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

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

    选项

    数据源和驱动程序对话框:驱动程序设置选项卡

    项目

    描述

    连接

    事务控制

    将数据库事务的 isolation level和事务提交的模式设置。

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

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

    切换架构

    定义一个 DataGrip 用来切换 schema 的模式。

    • 自动 :自动或手动切换模式。

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

    • 禁用 :请勿更换架构。

    启动脚本

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

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

    保持活动查询

    一个保持连接的保活查询。

    内省

    自动同步

    默认设置为 auto sync option

    加载以下对象的源

    加载所选模式类别的数据库对象的源代码。

    发送应用程序信息

    当连接到数据库服务器时,如果选中此复选框,DataGrip 会发送关于自身的信息。

    连接

    方言

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

    代码样式

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

    设置同步源的格式

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

    高级

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

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

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

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

    项目

    描述

    VM 选项

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

    VM 环境

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

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

    专家选项

    项目

    描述

    禁用增量内省

    请勿执行增量内省。 此选项适用于 Oracle、Microsoft SQL 服务器、PostgreSQL 和类似数据库。

    通过增量自省,自省器检测到数据库中在上次自省后更改的对象,并仅加载这些对象。 启用此选项时,探查器将始终加载所有对象。 这可能会大大增加内省时间。

    不在对pgdatabase 的查询中使用 xmin

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

    使用JDBC 元数据内省(M)

    切换到基于 JDBC 的 introspector。 适用于所有数据库。

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

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

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

    在原生 introspector 失败或不可用时,考虑使用基于 JDBC 的 introspector。

    如果数据库服务器版本低于 DataGrip 支持的最低版本,本机内省器可能会失败。

    您可以尝试切换到基于 JDBC 的分析器,以解决从您的数据库检索数据库结构信息时出现的问题。 例如,当您的数据库中存在的架构或架构级别以下的数据库对象未显示在 数据库资源管理器 中时。

    隔离类路径

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

    使用 IDE 代理设置

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

    Kubernetes

    通过 DataGrip,您可以连接到在 Kubernetes 集群中运行的数据库。

    嵌入式数据库(例如,SQLite、Apache&#xa0;Derby 或 HSQLDB)没有专用端口时,不可用 Kubernetes 选项卡。

    项目

    描述

    使用Kubernetes 端口转发

    启用端口转发。

    集群

    选择要使用的 Kubernetes 集群。

    命名空间

    选择命名空间,确定可用资源集。

    资源类型

    请选择资源类型。

    资源

    请选择一个资源进行连接。

    主机端口

    请输入一个本地端口以转发数据。

    容器端口

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

    DDL Mappings

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

    项目

    描述

    名称

    DDL 映射的名称。

    数据源

    设置常规数据源。

    DDL Data Source

    设置 DDL 数据源。

    范围

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

    问题

    数据源与驱动程序 对话框中,如果检测到数据源的潜在问题, 问题 菜单选项旁边会显示一个数字。 单击 问题 将显示问题列表以及解决问题的选项。

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