数据源与驱动程序对话框

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

在数据库工具窗口中，单击数据源属性按钮。
在数据库工具窗口中，单击添加按钮，然后导航到数据源 | <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。如果需要，您的用户名和密码需要在对应字段中指定，或者以所用 JDBC 驱动程序要求的格式包含在 URL 中。对于仅 URL 连接类型，JDBC URL 会以明文形式保存，并且还会显示在 IDE 日志文件和数据源信息中。其他连接类型使用其他选项（视具体 DBMS 而定）时，WebStorm 会根据 URL 字段上方的字段信息自动生成数据库连接 URL。在所有这些情况下，通常无需编辑 URL（但如果需要，您也可以进行编辑）。
驱动程序	从驱动程序列表中选择要用于连接的驱动程序。
文件	数据库文件的路径。使用打开图标（）选择现有数据库文件。保存图标（）会创建数据库文件的副本，并更改路径指向副本位置。
路径	数据库文件或文件夹的路径。使用打开图标（）选择现有数据库文件或文件夹。
主机	数据库所在计算机的主机名（域名）或 IP 地址（IPv4 或 IPv6）。如果数据库位于本地计算机上，请指定 localhost 或 127.0.0.1 。如果使用 SSH，则必须能够在运行 SSH 代理的计算机上通过指定的域名或 IP 地址访问数据库主机。请参阅 SSH/SSL 选项卡。
端口	数据库端口号。
数据库	目标数据库或架构的名称。
用户	数据库用户账户的名称。
密码	数据库用户的密码。
保存	保存密码字段的设置。您可以选择以下密码保存选项：您可以选择以下密码保存选项：从不：每次连接数据库时都会提示输入密码。直到重启：密码仅在当前 WebStorm 会话中保存。如果退出 WebStorm 并重新打开，您需再次输入密码。对于会话：密码仅在当前数据库连接会话中保存（直到断开连接）。您可以通过点击停用图标（）或使用 `Ctrl+F2` 终止连接。永久：密码已保存在 WebStorm 存储中。下次打开 WebStorm 时，无需再次输入密码。 IDE 密码设置：点击可访问 IDE 密码存储设置。您也可以通过打开外观与行为 \| 系统设置 \| 密码设置页面 `Ctrl+Alt+S` 来访问这些设置。有关 IDE 密码设置的详细信息，请参阅密码主题。
创建数据库	向 URL 添加参数以创建数据库。此选项仅在某些数据库管理系统中可用（例如， Apache Derby（嵌入式））。
URL	WebStorm 将使用该 URL 连接到数据库。指定 URL 的用户界面因选择的连接类型列表项而异。对于仅 URL 连接类型， URL 字段内容将以明文形式存储，并可在 IDE 日志文件和数据源设置文件中查看。请使用指定字段提供敏感的连接信息，而不是将其放入 URL 字段中。
测试连接	验证数据库连接设置是否正确，以及 WebStorm 是否可以与数据库通信。要复制通信信息，请点击复制。

选项

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

选项卡中的字段和控件集根据连接类型列表中选择的选项而有所不同。

项目	说明
连接
Read-only	设置只读状态。选中该复选框可防止意外修改数据源中的数据。如果选中该复选框，您将无法在数据编辑器中修改数据。如果驱动程序不支持只读状态，仍可能在查询控制台中修改数据。
事务控制	设置数据库事务的隔离级别以及事务提交的方式。自动：提交本地更改到数据库服务器时，当前事务将自动提交。手动：提交到数据库服务器的更改将累计进一个事务，该事务可以提交也可以回滚。
切换架构	定义 WebStorm 用于切换模式的方式。自动：自动或手动切换模式。启用该选项后，在 IDE 重启之间会自动恢复先前配置的搜索路径或当前模式。手动：仅手动切换模式。禁用：不切换模式。
时区	选择要与数据源一起使用的时区。例如，选择您的数据源所连接主机的时区。
单会话模式	启用单会话模式。单会话模式表示数据源和所有控制台使用相同的会话。该模式可让您在数据库树中查看临时对象，或在不同的控制台中使用相同的事务。如需了解有关控制台的更多信息，请参阅查询控制台。
保持活动查询的运行间隔	运行 keep-alive 查询以保持连接持续有效。您可以在驱动程序设置中为不受支持的数据库定义自定义查询。
此时间后自动断开	在指定秒数后断开数据库连接。
单数据库模式(S)	在数据库树视图中，仅显示并启用您在连接设置中指定的数据库。当连接到数据源时，WebStorm 可以检索并显示该数据源中所有数据库。但在某些情况下（例如，使用特定 PgBouncer 设置时），您只能使用某个数据库或被允许仅使用某个数据库。启用单数据库模式(S) 后，在数据库树视图中只会显示您在连接设置中指定的数据库。建议在 PostgreSQL、Azure SQL 数据库、Greenplum、Amazon Redshift 中使用该设置。
启动脚本	每次建立连接时运行 SQL 查询。如要在启动脚本中使用内置 IDE 宏，请点击插入宏。注意：如果取消选中单会话模式复选框，则每个新的查询控制台都会创建一个新连接。
反射
自动同步	自动同步数据库的实际状态。数据库的状态指的是您在数据库工具窗口中看到的数据库树视图。如果选中自动同步复选框，数据源视图将自动更新：在数据源和驱动程序对话框中点击确定时。在与数据源关联的数据库控制台中运行 DDL SQL 语句时。从 2024.2 版本开始，对于 Oracle 和 Microsoft SQL Server，WebStorm 会分析查询可能修改的对象，并仅刷新这些对象的集合。如果该语句间接修改了任何其他对象， IDE 可能会遗漏此类修改。在这种情况下，点击刷新，在项目工具窗口的工具栏中执行完整模型刷新操作。如果未选中自动同步复选框，数据库工具窗口中数据源的视图仅在您点击刷新按钮或按下 `Ctrl+F5` 时同步至数据库的实际状态。
加载以下对象的源	为所选类别的架构加载视图、过程、程序包及其他数据库对象的源代码：所有架构（所有架构）、排除系统架构的所有架构（除系统架构之外的所有架构）或禁用该功能（无）。要同时更改多个数据源的此设置，请选择相应数据源。右键点击所选项，转到 Load Sources 并选择一个选项。
默认级别	数据库对象的默认内省级别。
使用会话模板	选择一个用于会话的模板。
编辑过时的DDL 时发出警告	如果缓存的 DDL 与数据库中的实际 DDL 不同，则显示通知。每次打开源代码时，WebStorm 会显示在索引过程中加载的版本。但如果有人在其他工作站更改了源代码，则已索引版本将过时。如果您的版本早于数据库中的版本，您将会看到以下通知： `Cached object differs from the object in the database`。
跟踪数据库/架构创建和删除	当您创建、删除或重命名架构时，WebStorm 会在内省范围窗口中更新可用架构列表。要查看内省范围，请点击数据库工具窗口中数据源名称旁的按钮。
为没有内省的系统目录使用预内省的对象	切换是否使用系统目录的预内省对象。有关内省和系统目录的更多信息，请参阅系统目录中的预分析对象。
自动内省间隔 N 分钟	按指定时间间隔（分钟）对数据源执行一次内省。
虚拟对象和特性	定义 external-data.xml 的路径，用于存储虚拟外键的关系、虚拟列的表达式以及虚拟视图的语句。有关虚拟数据库对象的更多信息，请参阅 Virtual objects section topics。
其他
代码样式	选择要用于架构的代码样式。有关代码样式自定义的更多信息，请参阅 Code styles for SQL。
连接前	选择 WebStorm 在首次连接之前（JDBC 驱动程序启动过程中的开始阶段）将要执行的任务。任务按照顺序依次运行。
会话模板	为您的会话创建模板。模板设置将覆盖数据源的常规连接设置。在模板中，您可以设置以下选项：身份验证、只读、启动脚本、驱动程序。

SSH/SSL

SSH/SSL 选项卡包含用于 SSH 或 SSL 连接的设置。

SSH

项	描述
使用SSH 隧道(H)	选中此复选框以启用通过 SSH 连接。然后从列表中选择一个已创建的 SSH 配置，或点击并按创建 SSH 配置中的说明创建新配置。
SSH 配置	选择用于连接的 SSH 配置。要创建新的 SSH 配置，请点击添加 SSH 配置按钮（）。或者，按下 `Shift+Enter`。要复制现有 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)	指定您（客户端）私钥文件的路径。

架构

选择要在数据库工具窗口中显示的数据库和 schemas。

项	描述
	刷新数据库和架构的列表。
	展开所有树中的所有节点。
	折叠所有树中的所有节点。
	筛选树中的内容。仅显示名称包含指定文本的数据库和架构。
架构模式(P)	定义一个模式，以选择所需的数据库和架构。要获取使用语法的信息，请将插入符放置在该字段中并按下 `Ctrl+Q`。 `@` ：当前数据库或架构。 `` ：每个数据库或架构。您可以在 `:` 之后列出架构。请参考以下示例： `:` ：所有数据库中的所有架构。 `@:` ：当前数据库中的所有架构 `@:@` ：仅当前架构 `:dbo\|@:@\|db1:s1,s2,s3` ：所有数据库中的 `dbo` 架构、当前架构、 `db1` 数据库中的 `s1,s2,s3` 架构。
对象筛选器(F)	限制在每个数据源的数据库工具窗口中显示的表和其他数据库对象的集合。例如，如果将解析范围限制为 `table:actor.*` ，则仅会在数据库工具窗口（视图(V) \| 工具窗口 \| 数据库）中访问 `actor` 表。所有其他表将超出范围。 WebStorm 不会解析未在数据库工具窗口中显示的对象。在为对象筛选器(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_toast` 或 `pg_temp`）。该选项仅适用于 PostgreSQL。
显示模板数据库	显示或隐藏模板数据库（例如 `template1`、 `template0`）。该选项仅适用于 PostgreSQL。

高级

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

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

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

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

项	说明
虚拟机选项	用于数据库驱动程序的 JVM 选项。对于某些 Oracle 数据库版本（例如 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 文件的路径，则该文件将在此工作目录中创建。

项

说明

虚拟机选项

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

对于某些 Oracle 数据库版本（例如 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 文件的路径，则该文件将在此工作目录中创建。

有关更多信息，请参阅您的 DBMS 文档。

DDL 数据源

DDL 数据源通过其名称定义，并可引用一个或多个 DDL 文件及另一个数据源（父数据源）。

项	说明
名称	数据源名称。
源	包含所需 DDL 定义的文件列表。 `Alt+Insert`。将一个或多个 DDL SQL 文件添加到数据源定义中。在打开的对话框中，选择所需的文件。（`Alt+Delete`）。从列表中删除所选文件。（`Alt+Up`）。将所选文件在列表中上移一行。（`Alt+Down`）。将选定文件在列表中下移一行。
扩展	您可以在扩展列表中选择另一个数据源作为父级（可选）。因此，您正在编辑的数据源将继承其父级的全部 DDL 定义。如果不想使用父数据源，请选择 <无>。

项

说明

名称

数据源名称。

源

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

Alt+Insert。将一个或多个 DDL SQL 文件添加到数据源定义中。在打开的对话框中，选择所需的文件。
（Alt+Delete）。从列表中删除所选文件。
（Alt+Up）。将所选文件在列表中上移一行。
（Alt+Down）。将选定文件在列表中下移一行。

扩展

您可以在扩展列表中选择另一个数据源作为父级（可选）。因此，您正在编辑的数据源将继承其父级的全部 DDL 定义。

如果不想使用父数据源，请选择 <无>。

驱动程序

驱动的设置窗格包括以下选项卡：常规、选项、高级。

常规

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

项目	描述
类	要使用的驱动类的完全限定名称。
驱动程序文件	WebStorm 使用 JDBC drivers 与数据库交互。您可以从 WebStorm 的驱动存储库下载并使用驱动，也可以指定存储在本地计算机上的驱动。要下载并使用最新版本的驱动，请单击下载 ver. N 链接。您还可以指定并使用某一特定版本号的驱动。单击版本 <version_number> 链接并选择要使用的驱动版本。所选版本将自动下载并应用。您可以使用已存储在本地计算机上的驱动。此时，请单击添加按钮并选择驱动文件（扩展名为 JAR）。
URL 模板	用于构造数据库 URL 的模板。大括号中的文本表示变量。请参考以下示例： `{host}` ：数据库主机的域名或 IP 地址。 `{port}` ：数据库端口号。 `{database}` ：数据库或架构的名称。可选片段用方括号括起，例如： `[:{port}]`。模板名称与 URL option list 中的选项名称对应。

项目

描述

类

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

驱动程序文件

WebStorm 使用 JDBC drivers 与数据库交互。您可以从 WebStorm 的驱动存储库下载并使用驱动，也可以指定存储在本地计算机上的驱动。

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

您还可以指定并使用某一特定版本号的驱动。单击版本 <version_number> 链接并选择要使用的驱动版本。所选版本将自动下载并应用。

您可以使用已存储在本地计算机上的驱动。此时，请单击添加按钮并选择驱动文件（扩展名为 JAR）。

URL 模板

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

{host} ：数据库主机的域名或 IP 地址。
{port} ：数据库端口号。
{database} ：数据库或架构的名称。

可选片段用方括号括起，例如： [:{port}]。

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

选项

项目	描述
连接
事务控制	设置数据库事务的 isolation level 和事务提交模式。自动当您将本地更改提交到数据库服务器时，当前事务将自动提交。手动提交到数据库服务器的更改会累积在一个事务中，可提交或回滚。
切换架构	定义 WebStorm 切换架构时使用的模式。自动：自动或手动切换架构。手动：仅手动切换架构。禁用：不切换架构。
启动脚本	每次建立连接时将运行的 SQL 查询。注意：如果清除单会话模式复选框，每个新的查询控制台都会创建一个新的连接。
保持活动查询	用于保持连接活动的 keep-alive 查询。
内省
自动同步	auto sync option 的默认设置。
加载以下对象的源	为所选架构类别加载数据库对象的源代码。
发送应用程序信息	连接到数据库服务器时，如果选中此复选框，WebStorm 会发送其相关信息。
连接
方言	与相应数据源关联的 SQL 方言。
代码样式	选择要用于使用此驱动的数据源的代码风格。如需了解有关代码风格自定义的更多信息，请参阅 Code styles for SQL。
设置同步源的格式	同步后将代码风格应用于数据库对象的源代码。

高级

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

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

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

项目	描述
VM 选项	数据库驱动运行所依赖 JVM 的默认选项。驱动将在独立的 JVM 进程中启动。
VM 环境	数据库驱动 JVM 的环境变量。例如，在 Oracle 数据库中与编码相关的问题可通过设置 `NLS_LANG` 变量（如 `NLS_LANG=Russian_CIS.CL8MSWIN1251` ）来解决。如需了解更多信息，请参阅 Oracle NLS_LANG FAQ。

项目

描述

VM 选项

数据库驱动运行所依赖 JVM 的默认选项。驱动将在独立的 JVM 进程中启动。

VM 环境

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

例如，在 Oracle 数据库中与编码相关的问题可通过设置 NLS_LANG 变量（如 NLS_LANG=Russian_CIS.CL8MSWIN1251 ）来解决。如需了解更多信息，请参阅 Oracle NLS_LANG FAQ。

专家选项

项目	描述
禁用增量内省	不执行增量内省。该选项适用于 Oracle、Microsoft SQL Server、PostgreSQL 及类似数据库。启用增量内省后，分析器将检测数据库中自上次内省以来已更改的对象，并仅加载这些对象。启用该选项时，分析器将始终加载所有对象。这可能会大幅增加内省所需时间。
不在对pgdatabase 的查询中使用 xmin	请勿在针对 `pg_database` 表的查询中使用 `xmin` 属性。如果 `xmin` 在 `pg_database` 中不存在，请使用此变通方法。请注意，您的数据库可能已损坏。此选项仅适用于 PostgreSQL。
使用JDBC 元数据内省(M)	切换为基于 JDBC 的结构提取器。适用于所有数据库。为了检索有关数据库对象（数据库元数据）的信息，WebStorm 使用以下结构提取器：本机结构提取器（在某些 DBMS 中可能不可用）。本机结构提取器使用特定于 DBMS 的表和视图作为元数据来源。它可以检索 DBMS 特定的详细信息，并生成更精确的数据库对象概览。基于 JDBC 的结构提取器（适用于所有 DBMS）。基于 JDBC 的结构提取器使用 JDBC 驱动提供的元数据。它只能检索有关数据库对象及其属性的标准信息。当本机结构提取器失败或不可用时，建议使用基于 JDBC 的结构提取器。当您的数据库服务器版本低于 WebStorm 支持的最低版本时，本机结构提取器可能无法使用。您可以尝试切换为基于 JDBC 的结构提取器，以解决从数据库检索数据库结构信息的问题。例如，当工具窗口数据库中未显示数据库中存在的架构或架构级别以下的数据库对象时。
隔离类路径	隔离 JDBC 驱动使用的类路径。
使用 IDE 代理设置	将 IDE 的代理设置传递给 JDBC 进程。

Kubernetes

使用 WebStorm，可以连接到运行在 Kubernetes 集群中的数据库。

Kubernetes 选项卡对无专用端口的嵌入式数据库（例如 SQLite、Apache Derby 或 HSQLDB）不可用。

项目	说明
使用Kubernetes 端口转发	启用端口转发。
集群	选择要使用的 Kubernetes 集群。
命名空间	选择命名空间，以确定可用的资源集。
资源类型	选择资源类型。
资源	选择要连接的资源。
主机端口	输入要用于数据转发的本地端口。
容器端口	输入集群资源的远程端口。

DDL 映射

项目	说明
名称	DDL 映射的名称。
数据源	设置常规数据源。
DDL 数据源	设置 DDL 数据源。
作用域	设置常规数据源数据库对象的作用域，将其映射到 DDL 数据源的 SQL 文件。

问题

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

最后修改日期： 2025年 9月 26日