数据源和驱动程序对话框

要访问“数据源和驱动程序”对话框 ( Shift+Enter)，请执行以下操作之一：

在数据库工具窗口（查看|工具窗口|数据库）中，单击数据源属性按钮。
在数据库工具窗口（查看 | 工具窗口 | 数据库）中，单击添加按钮并导航到数据源 | <data_source_vendor>。

概述

在“数据源和驱动程序”对话框中，您可以管理数据源和数据库驱动程序。

数据源和驱动程序

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

工具栏

物品	捷径	描述
	`Alt+Insert`	创建数据源或驱动程序。
	`Delete`	从列表中删除选定的一个或多个项目。
	`Ctrl+D`	创建所选数据源或驱动程序的副本。
	`Ctrl+B`	导航到与所选数据源关联的驱动程序设置。
		将选定的数据源移动到全局或项目级别。有关全局和项目级别的更多信息，请参阅管理数据源。

上下文菜单

物品	捷径	描述
添加	`Alt+Insert`	创建数据源或驱动程序。
消除	`Delete`	从列表中删除选定的一个或多个项目。
复制	`Ctrl+D`	创建所选数据源或驱动程序的副本。
前往司机	`Ctrl+B`	导航到与所选数据源关联的驱动程序设置。
全球化或移至项目		将选定的数据源移动到全局或项目级别。有关全局和项目级别的更多信息，请参阅管理数据源。
更换驱动程序		将数据源与驱动程序相关联。
重置更改	`Ctrl+Alt+Z`	还原所选项目的更改。
负载源		为选定的模式类别加载数据库对象的源代码。
显示驱动程序用法	`Alt+F7`	显示使用所选驱动程序的数据源。
		在最近使用的项目之间切换。

数据源设置

数据源的设置窗格包括以下选项卡：General、Options、SSH/SSL、Schemas、Advanced。

一般的

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

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

物品	描述
连接类型	要用于数据库连接的连接类型。 URL only此选项通常用于直接编辑数据库连接 URL。当您选择此选项时，只有以下字段可用：用户、密码和URL。您应该在该字段中编辑 URL。如有必要，您的用户名和密码将在相应字段中指定，或者在 URL 中以适合您使用的 JDBC 驱动程序的格式指定。当使用任何其他选项时（选项是特定于 DBMS 的），PhpStorm 使用URL字段上方字段中的信息自动形成数据库连接 URL 。在所有这些情况下，通常您不需要编辑 URL（尽管您可以根据需要进行编辑）。
司机	驱动程序列表中要用于连接的驱动程序。
文件	数据库文件的路径。使用打开图标 ( ) 选择现有数据库文件。保存图标 ( ) 创建数据库文件的副本并更改复制位置的路径。
小路	数据库文件或文件夹的路径。使用打开图标 ( ) 选择现有数据库文件或文件夹。
主持人	数据库所在计算机的主机名（域名）或 IP 地址。如果数据库在您的本地计算机上，请指定localhost或127.0.0.1。如果您使用 SSH，则数据库主机必须可以通过运行 SSH 代理的计算机上的指定域名或 IP 地址访问。请参阅SSH/SSL 选项卡。
港口	数据库端口号。
数据库	目标数据库或架构的名称。
用户	您的数据库用户帐户的名称。
密码	数据库用户的密码。
保存	保存密码字段的设置。您可以选择以下选项来存储您的密码：从不：每次与数据库建立连接时都会提示密码。直到重新启动：仅保存当前 PhpStorm 运行的密码。如果退出 PhpStorm 并再次打开它，则必须再次提供密码。对于会话：密码仅保存在与数据库的当前连接会话中（直到您断开与它的连接）。您可以通过按断开连接图标 ( ) 或来终止连接`Ctrl+F2`。 Forever：密码保存在 PhpStorm 存储中。下次打开 PhpStorm 时无需提供密码。
创建数据库	向 URL 添加参数以创建数据库。此选项仅在某些数据库管理系统中可用（例如，在Apache Derby (Embedded)中）。
网址	PhpStorm 将用于连接到数据库的 URL。用于指定 URL 的用户界面会有所不同，具体取决于在连接类型列表中选择的选项。
测试连接	验证数据库连接设置是否正确，并且 PhpStorm 可以与数据库通信。要复制通信信息，请单击复制到剪贴板图标。

选项

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

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

物品	描述
只读	设置只读状态。选中该复选框以保护数据源免受意外数据修改。如果选中该复选框，则无法在数据编辑器中修改数据。如果驱动程序不支持只读状态，则可以在查询控制台中修改数据。
事务控制	设置数据库事务的隔离级别和事务提交的模式。 Auto：当您将本地更改提交到数据库服务器时，将自动提交当前事务。手动：提交到数据库服务器的更改累积在可以提交或回滚的事务中。
切换架构	定义 PhpStorm 用于切换模式的模式。自动：自动或手动切换模式。启用此选项后，之前配置的搜索路径/当前架构会在 IDE 重新启动之间自动恢复。手动：仅手动切换模式。禁用：不切换模式。
单会话模式	启用单会话模式。单会话模式意味着数据源和所有控制台使用同一个会话。此模式允许您查看数据库树中的临时对象，或在不同的控制台中使用相同的事务。有关控制台的更多信息，请阅读查询控制台。
每 N 秒运行一次 keep-alive 查询	运行保持活动查询以保持连接活动。您可以在驱动程序设置中为不受支持的数据库定义自定义查询。
N秒后自动断开	在指定的秒数后断开与数据库的连接。
启用 DBMSOUTPUT	（Oracle、IBM Db2 LUW）默认为新会话启用 DBMS_OUTPUT。
单库模式	在数据库树视图中，仅显示并启用您在连接设置中指定的数据库。当您连接到数据源时，PhpStorm 可以检索并显示数据源拥有的所有数据库。但在某些情况下（例如，使用 PgBouncer 的某些设置），您可以或被允许仅使用某个数据库。在启用了单一数据库模式的数据库树视图中，您只能看到您在连接设置中指定的数据库。考虑将此设置用于 PostgreSQL、Azure SQL 数据库、Greenplum、Amazon Redshift。
启动脚本	每次建立连接时运行 SQL 查询。注意：如果清除单会话模式复选框，每个新查询控制台都会创建一个新连接。
自动同步	自动同步数据库的实际状态。数据库的状态是指您在“数据库”工具窗口中看到的数据库树视图。如果选中自动同步复选框，数据源的视图会自动更新：在“数据源和驱动程序”对话框中单击“确定”时。在与数据源关联的数据库控制台中运行 DDL SQL 语句时。如果清除“自动同步”复选框，则“数据库”工具窗口中的数据源视图只有在单击“刷新”按钮或按`Ctrl+F5`)时才会与数据库的实际状态同步。
加载源	为选定的模式类别加载视图、过程、包和其他数据库对象的源代码：所有模式 ( All schemas )、不包括系统模式的所有模式 ( All excl. system schemas )，或禁用该功能 ( None )。要同时更改多个数据源的此设置，请选择相应的数据源。右键单击选择并导航到加载源并选择一个选项。
编辑过时的 DDL 时发出警告	如果缓存的 DDL 与数据库中的实际 DDL 不同，则显示通知。每次打开源代码时，PhpStorm 都会向您显示在索引过程中加载的版本。但是，如果有人从另一个工作站更改源代码，索引版本就会过时。如果您的版本比数据库中的版本旧，您会看到以下通知：`Cached object differs from the object in the database`。
对未自省的系统目录使用预先自省的对象	切换系统目录的预检对象的使用。有关自省和系统目录的更多信息，请参阅系统目录中的预自省对象。
虚拟对象和属性	定义存储虚拟外键关系的external-data.xml的路径。这些关系用于自动完成列表、数据导航和图表。有关虚拟对象和属性的更多信息，请参阅有关创建虚拟外键的过程。
代码风格	选择要用于架构的代码样式。有关代码样式自定义的更多信息，请阅读SQL 的代码样式。
连接前	选择 PhpStorm 将在第一次连接之前执行的任务（在 JDBC 驱动程序工作的进程开始时）。任务按顺序运行。

专家选项

使用 JDBC 元数据进行自省	切换到基于 JDBC 的内省。适用于所有数据库。为了检索有关数据库对象（数据库元数据）的信息，PhpStorm 使用以下自省器：本地自省器（某些 DBMS 可能不可用）。本机自省器使用特定于 DBMS 的表和视图作为元数据的来源。它可以检索特定于 DBMS 的详细信息并生成更精确的数据库对象图。基于 JDBC 的内省（适用于所有 DBMS）。基于 JDBC 的内省器使用 JDBC 驱动程序提供的元数据。它只能检索有关数据库对象及其属性的标准信息。当本机自检器失败或不可用时，请考虑使用基于 JDBC 的自检器。当您的数据库服务器版本低于 PhpStorm 支持的最低版本时，本机内省可能会失败。您可以尝试切换到基于 JDBC 的内省来解决从数据库中检索数据库结构信息的问题。例如，当数据库中存在的架构或架构级别以下的数据库对象未显示在“数据库”工具窗口中时。
禁用增量内省	不要执行增量内省。该选项适用于 Oracle、Microsoft SQL Server、PostgreSQL 和类似数据库，. 使用增量内省，内省检测器在上次内省之后检测数据库中更改的对象并仅加载这些对象。当您启用此选项时，自省器始终加载所有对象。它可能会大大增加自省时间。
获取 LONG 值	选择如何从属于 Oracle 目录视图的 LONG 列下载值。该选项仅适用于 Oracle。默认选项是 XML，因为它具有更好的性能。如果 Oracle XML 文本生成器出现错误，请考虑使用常规方式。请注意，传统方式可能会增加自省时间，尤其是当对服务器的 ping 时间较长时。
内省服务器对象	对服务器对象运行自省。该选项仅适用于 Oracle。
不要在对 pgdatabase 的查询中使用 xmin	不要在对表`xmin`的查询中使用该属性。在中不存在`pg_database`时使用此解决方法。请注意，您的数据库可能已损坏。该选项仅适用于 PostgreSQL。`xminpg_database`
注册 REGEXP 函数	注册 REGEXP 函数实现。默认情况下，此实现在 SQLite 中不可用。该选项仅适用于 SQLite。
对源代码使用 SHOW CREATE	使用 SHOW CREATE 语句为对象源代码生成 CREATE 语句。触发器和例程的源代码在`information_schema`MySQL 中被破坏（参见bugs.mysql.com 上的 Bug #66414）。该选项仅适用于 MySQL。
自动分配 sessionid	`session_id`为每个连接生成一个唯一的。使用`session_id`，您可以使用不同的会话语句（例如，USE）。该选项仅适用于 ClickHouse。

SSH/SSL

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

SSH

物品	描述
使用 SSH 隧道	选中此复选框以启用通过 SSH 连接。然后选择一个已创建的 SSH 配置，或单击并按照创建 SSH 配置中所述创建新配置。

SSL

物品	描述
使用 SSL 隧道	启用用于配置 SSL 连接的设置。
复制自	从现有数据源复制 SSH 设置。单击链接并选择相应的数据源。
证书文件	指定 SSL 证书颁发机构 (CA) 证书文件的路径。证书文件必须与服务器使用的证书相同。
客户证书文件	指定（客户端）公钥证书文件的路径。
客户端密钥文件	指定（客户端）私钥文件的路径。

模式

选择要在“数据库”工具窗口中显示的数据库和模式。

物品	描述
	刷新数据库和模式的列表。
	展开所有树中的所有节点。
	折叠所有树中的所有节点。
	过滤树中的内容。仅显示名称包含指定文本的数据库和模式。
模式模式	定义一个模式来选择必要的数据库和模式。要获取有关要使用的语法的信息，请将插入符号放在字段中并按`Ctrl+Q`。 `@`：当前数据库或模式。 ``: 每个数据库或模式。您可以在`:`. 考虑以下示例： `:`：所有数据库中的所有模式。 `@:`：来自当前数据库的所有模式 `@:@`：仅当前架构 `:dbo\|@:@\|db1:s1,s2,s3`：`dbo`来自所有数据库的架构，当前架构，`s1,s2,s3`来自`db1`数据库的架构。
对象过滤器	限制每个数据源的数据库工具窗口中显示的表集和其他数据库对象。例如，如果您将解析范围限制为`table:actor.*`，则只能`actor`在数据库工具窗口（查看 \| 工具窗口 \| 数据库）中访问表。所有其他表都将超出范围。PhpStorm 不解析未显示在数据库工具窗口中的对象。为对象过滤器字段编写表达式时，请使用以下模式。 `<type>:[-]<pattern>`，在哪里： `<type>`可能是聚合、排序规则、事件、fdw、ftable、mview、运算符、包、角色、例程、序列、同义词、表、用户、视图、vtable。 `<pattern>`是一个正则表达式。要排除项目，请在前面加上`-`（减号）。有关正则表达式的更多信息，请参阅JavaTM 2 平台标准版 5.0 API 规范中的类模式。
显示内部系统架构	显示或隐藏内部系统模式（例如，`pg_toast`或`pg_temp`）。该选项仅适用于 PostgreSQL。
显示模板数据库	显示或隐藏模板数据库（例如`template1`, `template0`）。该选项仅适用于 PostgreSQL。

先进的

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

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

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

要添加一行，请开始编辑最后一行中的值，其中显示了 <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 定义。如果您不想使用父数据源，请选择<none>。

物品

描述

姓名

数据源名称。

来源

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

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

延长

或者，您可以在“扩展”列表中选择另一个数据源作为父数据源。因此，您正在编辑的数据源会从其父级继承所有 DDL 定义。

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

驱动程序设置

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

设置

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

物品	描述
班级	要使用的驱动程序类的完全限定名称。
JDBC 驱动程序	PhpStorm 使用JDBC 驱动程序与数据库交互。您可以从 PhpStorm 驱动程序库下载和使用驱动程序，或指定存储在计算机上的驱动程序。要下载和使用最新的驱动程序版本，请单击下载版本。N链接。您还可以指定和使用具有特定版本号的驱动程序。点击版本。<version_number>链接并选择您要使用的驱动程序版本。所选版本会自动下载并应用。您可以使用计算机上已有的驱动程序。在这种情况下，单击Add按钮并选择驱动程序文件（带有 JAR 扩展名）。
网址模板	用于构造数据库 URL 的模板。大括号中的文本代表变量。考虑以下示例： `{host}`：数据库主机的域名或IP地址。 `{port}`：数据库端口号。 `{database}`：数据库或模式的名称。可选片段在方括号中，例如，`[:{port}]`. 模板名称对应于URL 选项列表中的选项名称。

物品

描述

班级

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

JDBC 驱动程序

PhpStorm 使用JDBC 驱动程序与数据库交互。您可以从 PhpStorm 驱动程序库下载和使用驱动程序，或指定存储在计算机上的驱动程序。

要下载和使用最新的驱动程序版本，请单击下载版本。N链接。

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

您可以使用计算机上已有的驱动程序。在这种情况下，单击Add按钮并选择驱动程序文件（带有 JAR 扩展名）。

网址模板

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

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

可选片段在方括号中，例如，[:{port}].

模板名称对应于URL 选项列表中的选项名称。

选项

物品	描述
事务控制	设置数据库事务的隔离级别和事务提交的模式。自动当您将本地更改提交到数据库服务器时，当前事务会自动提交。手动提交到数据库服务器的更改累积在可以提交或回滚的事务中。
切换架构	定义 PhpStorm 用于切换模式的模式。自动：自动或手动切换模式。手动：仅手动切换模式。禁用：不切换模式。
启动脚本	每次建立连接时都会运行的 SQL 查询。注意：如果清除单会话模式复选框，每个新查询控制台都会创建一个新连接。
保活查询	将运行以保持连接处于活动状态的保持活动查询。
自动同步	自动同步选项的默认设置。
加载源	为选定的模式类别加载数据库对象的源代码。
发送申请信息	连接到数据库服务器时，如果选中此复选框，PhpStorm 会发送有关自身的信息。
方言	与相应数据源关联的 SQL 方言。
代码风格	选择要用于使用此驱动程序的数据源的代码样式。有关代码样式自定义的更多信息，请阅读SQL 的代码样式。
格式化同步的源	同步后将代码样式应用于数据库对象的源代码。

先进的

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

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

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

物品	描述
虚拟机选项	运行数据库驱动程序的 JVM 的默认选项。驱动程序在 JVM 中作为单独的进程启动。
虚拟机环境	数据库驱动程序 JVM 的环境变量。例如，Oracle 数据库中与编码相关的问题可以通过设置`NLS_LANG`变量（如`NLS_LANG=Russian_CIS.CL8MSWIN1251`）来解决。有关详细信息，请参阅Oracle NLS_LANG 常见问题解答。

物品

描述

虚拟机选项

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

虚拟机环境

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

问题

如果检测到潜在问题，则Problems右侧有一个数字。在这种情况下，如果您单击Problems，您会看到问题列表以及用于修复它们的控件。

最后修改时间：2021 年 11 月 22 日