数据源和驱动程序对话框
启用 数据库工具和 SQL 插件
此功能依赖于 数据库工具和 SQL 插件,该插件在 PhpStorm 中默认捆绑并启用。 如果相关功能不可用,请确保没有禁用该插件。
按 Ctrl+Alt+S 打开设置,然后选择 。
打开 已安装 选项卡,找到 数据库工具和 SQL插件,然后选择插件名称旁边的复选框。
要访问 数据源和驱动程序 对话框,请执行以下操作之一:
在 数据库 工具窗口中,点击 数据源属性 按钮
。
在 数据库 工具窗口中,点击 添加 按钮
并导航到 。
概述
在 数据源和驱动程序 对话框中,您可以管理 数据源和数据库驱动程序。

左侧窗格控件
当您从数据源和驱动程序列表中选择一个项目时,该项目的设置会显示在对话框的右侧。
工具栏
项目 | 快捷方式 | 描述 |
|---|---|---|
Alt+Insert | 创建数据源或驱动程序。 | |
Delete | 从列表中移除选中的项目。 | |
Ctrl+D | 创建所选数据源或驱动程序的副本。 | |
Ctrl+B | 导航到与所选数据源关联的驱动程序设置。 | |
| 将所选数据源移动到全局或项目级别。 有关全局和项目级别的更多信息,请参阅 数据源。 | |
| 在最近使用的项目之间切换。 |
上下文菜单
项目 | 快捷方式 | 描述 |
|---|---|---|
| Alt+Insert | 创建数据源或驱动程序。 |
| Delete | 从列表中移除选中的项目。 |
| Ctrl+D | 创建所选数据源或驱动程序的副本。 |
| Ctrl+B | 导航到与所选数据源关联的驱动程序设置。 |
| 将所选数据源移动到全局或项目级别。 有关全局和项目级别的更多信息,请参阅 数据源. | |
更改驱动程序 | 将数据源与驱动程序关联。 | |
| Ctrl+Alt+Z | 还原所选项目的更改。 |
加载源 | 加载所选模式类别的数据库对象的源代码。 | |
| Alt+F7 | 显示使用所选驱动程序的数据源。 |
数据源
数据源 部分包括常规数据源和 DDL 数据源的设置。
常规
常规数据源的设置窗格包括以下选项卡: 通用、 选项、 SSH/SSL、 架构、 高级。

有关管理和创建常规数据源的更多信息,请参阅 数据源。 要了解特定数据库的连接设置,请参阅专门的主题。
- 创建和配置不同数据库的数据源
通用
“ 通用” 选项卡包含需要为数据库连接指定的设置。
选项卡上的字段和控件集取决于 连接类型 列表中选择的选项。

项目 | 描述 |
|---|---|
连接类型 | 一种用于数据库连接的连接类型。
|
驱动程序 | 请从 驱动程序 列表中指定您要用于连接的驱动程序。 |
File | 数据库文件路径。 请使用 打开 图标 ( 保存 图标 ( |
Path | 指向数据库文件或文件夹的路径。 使用 打开 图标( |
主机 | 计算机上数据库所在的主机名(域名)或 IP 地址(IPv4 或 IPv6)。 如果数据库在您的本地计算机上,请指定 localhost 或 127.0.0.1 。 如果您使用 SSH,数据库主机必须能够通过指定的域名或 IP 地址从运行 SSH 代理的计算机进行访问。 请查看 SSH/SSL 选项卡。 |
端口 | 数据库端口号。 |
数据库 | 目标数据库或架构的名称。 |
User | 您的数据库用户帐户的名称。 |
密码 | 数据库用户的密码。 |
保存 | 为密码字段保存设置。 您可以选择以下选项来存储您的密码:
|
创建数据库 | 向 URL 添加参数以创建数据库。 此选项仅在某些数据库管理系统中可用(例如,在 Apache Derby(嵌入式) 中)。 |
URL | PhpStorm 将使用的连接到数据库的 URL。 根据在 连接类型 列表中选择的不同选项,指定URL的用户界面会有所不同。 |
测试连接 | 验证数据库连接设置是否正确,以及 PhpStorm 是否可以与数据库通信。 要复制通信信息,请点击 复制。 |
选项
选项 选项卡包含数据库连接的设置。
选项卡上的字段和控件集取决于 连接类型 列表中选择的选项。

项目 | 描述 |
|---|---|
连接 | |
Read-only | 设定只读状态。 选中复选框以防止数据源意外修改。 如果选中复选框,您无法在 数据编辑器中修改数据。 如果驱动程序不支持只读状态,则可以在 查询控制台 中修改数据。 |
事务控制 | 将数据库事务的 isolation level和事务提交的模式设置。
|
切换架构 | 定义一个 PhpStorm 用来切换 schema 的模式。
|
时区 | 请选择用于数据源的时区。 例如,选择数据源连接的主机所在的时区。 |
单会话模式 | 启用 单会话模式。 单会话模式 表示数据源和所有控制台使用相同的会话。 此模式允许您在数据库树中查看临时对象,或在不同的 console 中使用相同的事务。 有关控制台的更多信息,请参阅 查询控制台。 |
保持活动查询的运行间隔 | 运行 keep-alive 查询以保持连接活跃。 您可以在驱动程序设置中为不受支持的数据库定义自定义查询。 |
此时间后自动断开 | 在指定的秒数后从数据库断开连接。 |
单数据库模式(S) | 在数据库树视图中,仅显示和启用您在连接设置中指定的数据库。 当您连接到数据源时,PhpStorm 可以检索并显示数据源拥有的所有数据库。 但是在某些情况下(例如,使用某些 PgBouncer 设置),您只能或被允许仅使用某个特定的数据库。 在启用了 单数据库模式(S) 的数据库树状视图中,您只会看到连接设置中指定的数据库。 请考虑为 PostgreSQL、Azure SQL 数据库、Greenplum、Amazon Redshift 使用此设置。 |
启动脚本 | 每次建立连接时运行 SQL 查询。 要在您的启动脚本中使用 内置 IDE 宏 ,请点击 插入宏。 注意 :如果清除 单会话模式 复选框,则每个新的 查询控制台 都会创建一个新连接。 |
内省 | |
自动同步 | 自动同步数据库的实际状态。 数据库的状态是指您在 数据库 工具窗口中看到的数据库树视图。 如果选中 自动同步 复选框,则数据源的视图会自动更新:
如果清除了 自动同步 复选框,则只有在单击 刷新 按钮 |
加载以下对象的源 | 加载所选架构类别的视图、程序、包和其他数据库对象的源代码:所有架构(所有架构 ),所有架构(不包括系统架构)(除系统架构之外的所有架构 ),或禁用此功能(无)。 若要同时更改多个数据源的此设置,请选择相应的数据源。 右键点击选择区域,导航到 Load Sources并选择一个选项。 |
默认级别 | 数据库对象的默认内省级别。 |
使用会话模板 | 请为您的会话选择一个 模板。 |
编辑过时的DDL 时发出警告 | 如果缓存的 DDL 与数据库中的实际 DDL 不同,则显示通知。 每次您打开源代码时,PhpStorm 会显示在索引过程中加载的版本。 但如果有人从另一个工作站更改了源代码,则索引版本将变得过时。 如果您的版本比数据库中的版本旧,您将看到以下通知: |
跟踪数据库/架构创建和删除 | 当您创建、删除或重命名模式时,PhpStorm 会更新自省范围窗口中可用模式的列表。 要查看内省范围,请单击 数据库 工具窗口中数据源名称旁边的按钮。 ![]() |
为没有内省的系统目录使用预内省的对象 | 切换是否使用预解析对象来进行系统目录。 有关内省和系统目录的更多信息,请参阅 来自系统目录的预内省对象。 |
自动自省间隔 N 分钟 | 在指定的分钟数内对数据源运行一次自省。 |
虚拟对象和特性 | 定义了一个存储虚拟外键关系、虚拟列表达式和虚拟视图语句的路径 external-data.xml 。 有关虚拟数据库对象的更多信息,请参阅 虚拟对象部分主题。 |
其他 | |
代码样式 | 请选择您希望用于架构的代码样式。 有关代码样式自定义的更多信息,请参阅 SQL 代码样式。 |
连接前 | 选择 PhpStorm 在首次连接前将执行的任务(在 JDBC driver 工作的过程中开始执行)。 任务按顺序运行。 |
会话模板 | 为您的会话创建模板。 模板设置会覆盖数据源的一般连接设置。 在模板中,您可以设置以下选项: 身份验证、 只读、 启动脚本、 驱动程序。 |
SSH/SSL
SSH/SSL 选项卡包括 SSH 或 SSL 连接的设置。

SSH
项目 | 描述 |
|---|---|
使用SSH 隧道(H) | 选中此复选框以启用通过 SSH 连接。 然后从列表中选择一个已创建的 SSH 配置,或单击 |
SSH 配置 | 请选择 SSH 配置用于连接。 要创建新的 SSH 配置,请点击 添加 SSH 配置 按钮 ( 要复制现有的 SSH 配置,请点击 复制 按钮 ( |
SSL
项目 | 描述 |
|---|---|
使用 SSL 隧道 | 启用配置 SSL 连接的设置。 |
复制自 | 复制现有数据源的 SSH 设置。 点击链接并选择相应的数据源。 |
CA 文件(A) | 指定 SSL 证书颁发机构 (CA) 证书文件的路径。 证书文件必须与服务器使用的证书相同。 |
使用信任库 | 选择信任库以使用其中包含的证书。
JAVA 和 System 证书可能需要更新。 |
客户端证书文件 | 指定到您的(客户端)公钥证书文件的路径。 |
客户端密钥文件(K) | 指定路径到您的(客户端)私钥文件。 |
架构
选择要在 数据库 工具窗口中显示的数据库和 模式。

项目 | 描述 |
|---|---|
刷新数据库和模式的列表。 | |
展开所有树中的所有节点。 | |
折叠所有树中的所有节点。 | |
| 筛选树中的内容。 仅显示名称包含指定文本的数据库和架构。 |
架构模式(P) | 定义一个模式以选择所需的数据库和模式。 要获取关于语法的相关信息,请将光标放入该字段并按 Ctrl+Q。
请考虑以下示例:
|
对象筛选器(F) | 限制在每个数据源的 数据库 工具窗口中显示的表和其他数据库对象的集合。 例如,如果您将解析范围限制为 所有其他表格将不在范围内。 PhpStorm 不解析未显示在 数据库 工具窗口中的对象。 ![]() 请使用以下模式为 对象筛选器(F) 字段撰写表达式。
|
显示内部系统架构 | 显示或隐藏内部系统架构(例如, |
显示模板数据库 | 显示或隐藏模板数据库(例如, |
高级

高级 选项卡包括数据库连接属性、选项和 JVM 数据库驱动程序的环境变量。
高级 选项卡上的表格显示了一组连接选项,这些选项作为键值对传递给数据库驱动程序。
当您选择 名称 列中的单元格时,对应选项的描述会显示在表格下方。
要添加一行,请开始编辑最后一行中的值,其中显示 <user defined> 和 <value>。 会自动向表中添加一行。
项目 | 描述 |
|---|---|
虚拟机选项 | 数据库驱动程序的 JVM 选项。 对于某些 Oracle Database 版本(例如,Oracle version 9),当您和您的数据库服务器位于不同时区时,可能会出现连接问题。 您可以在 VM Option 字段中指定您的时区时间偏移量(例如, |
虚拟机环境 | 用于数据库驱动程序 JVM 的环境变量。 例如,通过设置 |
工作目录 | 处理数据源的进程的工作目录。 此外,所有相对路径都是相对于此目录解析的(例如,驱动属性中的路径)。 例如,若您创建一个基于文件的数据库(如 SQLite)且未设置 SQLITE 文件路径,则该文件将会在此工作目录中创建。 |
欲了解更多信息,请参阅您的 DBMS 文档。
DDL 数据源
DDL 数据源由其名称定义,可以引用一个或多个 DDL 文件及另一个数据源(父数据源)。
项目 | 描述 |
|---|---|
名称 | 数据源名称。 |
源 | 包含必要的 DDL 定义的文件列表。
|
扩展 | 您可以选择在 扩展 列表中将另一个数据源作为父级。 结果是,您正在编辑的数据源继承了其父级的所有 DDL 定义。 如果您不想使用父数据源,请选择 <none>。 |
驱动程序
驱动程序的设置窗格包括以下选项卡: 常规、 选项、 高级。
通用
常规 选项卡包含驱动程序文件、URL 模板和驱动程序类的设置。

项目 | 描述 |
|---|---|
类 | 所使用的驱动程序类的完全限定名称。 |
驱动程序文件 | PhpStorm 使用 JDBC drivers 与数据库进行交互。 您可以从 PhpStorm 驱动程序库下载并使用驱动程序,或指定您存储在电脑上的驱动程序。 若要下载并使用最新的驱动程序版本,点击 下载版本 N 链接。 您还可以指定并使用具有特定版本号的驱动程序。 请点击 版本 <version_number> 链接并选择您想使用的驱动程序版本。 所选版本将被自动下载和应用。 您可以使用计算机上已有的驱动程序。 在这种情况下,请点击 Add 按钮 |
URL 模板 | 用于构建数据库 URL 的模板。 花括号中的文本代表变量。 请考虑以下示例:
可选片段用方括号表示,例如 模板名称对应于 URL option list中的选项名称。 |
选项

项目 | 描述 |
|---|---|
连接 | |
事务控制 | 将数据库事务的 isolation level和事务提交的模式设置。
|
切换架构 | 定义一个 PhpStorm 用来切换 schema 的模式。
|
启动脚本 | 每次建立连接时将运行的 SQL 查询。 注意 :如果清除 单会话模式 复选框,则每个新的 查询控制台 都会创建一个新连接。 |
保持活动查询 | 一个保持连接的保活查询。 |
自省 | |
自动同步 | 默认设置为 auto sync option。 |
加载以下对象的源 | 加载所选模式类别的数据库对象的源代码。 |
发送应用程序信息 | 当连接到数据库服务器时,如果选中此复选框,PhpStorm 会发送关于自身的信息。 |
连接 | |
方言 | 与相应数据源相关联的 SQL 方言。 |
代码样式 | 选择您希望用于使用此驱动程序的数据源的代码样式。 有关代码样式自定义的更多信息,请参阅 SQL 代码样式。 |
设置同步源的格式 | 在同步后将代码样式应用于数据库对象的源代码。 |
高级
高级 选项卡包括 JVM 选项、环境变量和可以作为键值对传递给数据库驱动程序的选项。
要开始编辑表格中的值,双击相应的 值 字段。
要添加一行,请开始编辑最后一行中的值,其中显示 <user defined> 和 <value>。 会自动在表格中添加新行。

项目 | 描述 |
|---|---|
VM 选项 | 数据库驱动程序运行的 JVM 的默认选项。 驱动程序作为单独的进程在 JVM 中启动。 |
VM 环境 | 用于数据库驱动程序 JVM 的环境变量。 例如,通过设置 |
专家选项
项目 | 描述 |
|---|---|
禁用增量内省 | 请勿执行增量内省。 此选项适用于 Oracle、Microsoft SQL Server、PostgreSQL 和类似数据库。 通过增量自省,自省器检测到数据库中在上次自省后更改的对象,并仅加载这些对象。 启用此选项时,探查器将始终加载所有对象。 这可能会大大增加内省时间。 |
不在对pgdatabase 的查询中使用 xmin | 查询 |
使用JDBC 元数据内省(M) | 切换到基于 JDBC 的 introspector。 适用于所有数据库。 要检索有关数据库对象(DB 元数据)的信息,PhpStorm 使用以下内省器:
在原生 introspector 失败或不可用时,考虑使用基于 JDBC 的 introspector。 如果数据库服务器版本低于 PhpStorm 支持的最低版本,本机内省器可能会失败。 您可以尝试切换到基于 JDBC 的分析器,以解决从您的数据库检索数据库结构信息时出现的问题。 例如,当数据库中存在的模式或模式级别以下的数据库对象未显示在 数据库 工具窗口中时。 |
隔离类路径 | 隔离 JDBC 驱动程序使用的类路径。 |
使用 IDE 代理设置 | 将 IDE 代理设置传递给 JDBC 进程。 |
Kubernetes
通过 PhpStorm,您可以连接到在 Kubernetes 集群中运行的数据库。
嵌入式数据库(例如,SQLite、Apache Derby 或 HSQLDB)没有专用端口时,不可用 Kubernetes 选项卡。
项目 | 描述 |
|---|---|
使用Kubernetes 端口转发 | 启用端口转发。 |
集群 | 请选择要使用的 Kubernetes 集群。 |
命名空间 | 选择命名空间,确定可用资源集。 |
资源类型 | 请选择资源类型。 |
资源 | 请选择一个资源进行连接。 |
主机端口 | 请输入一个本地端口以转发数据。 |
容器端口 | 输入集群资源的远程端口。 |
DDL Mappings

项目 | 描述 |
|---|---|
名称 | DDL 映射的名称。 |
数据源 | 设置常规数据源。 |
DDL Data Source | 设置 DDL 数据源。 |
范围 | 设置将映射到 DDL 数据源 SQL 文件的常规数据源数据库对象的范围。 |
问题
在 数据源与驱动程序 对话框中,如果检测到数据源的潜在问题, 问题 菜单选项旁边会显示一个数字。 单击 问题 将显示问题列表以及解决问题的选项。


