PhpStorm 2025.2 Help

数据库工具窗口

启用 数据库工具和 SQL 插件

此功能依赖于 数据库工具和 SQL 插件,该插件在 PhpStorm 中默认捆绑并启用。 如果相关功能不可用,请确保没有禁用该插件。

  1. Ctrl+Alt+S 打开设置,然后选择 Plugins

  2. 打开 已安装 选项卡,找到 数据库工具和 SQL插件,然后选择插件名称旁边的复选框。

概述

数据库 工具窗口中,您可以使用数据库和 DDL 数据源。 您可以查看和修改数据库中的数据结构,并执行其他相关任务。

可用的数据源显示为数据源、架构、表等的树状结构。

数据库窗口

如果当前没有定义数据源,请使用 New 命令 Alt+Insert 创建数据源并连接到数据库。 有关数据源的更多信息,请参阅 数据源 主题。

一旦 PhpStorm 连接到数据库, 数据库 工具窗口将显示 内省的数据库对象。 有关数据库树查看选项的更多信息,请参阅 查看选项 章节。 有关在 PhpStorm 中处理数据库对象的更多信息,请参阅相应的对象主题。

在此窗口中,大多数功能可以通过使用工具栏图标或上下文菜单命令来访问。 许多命令都有键盘快捷键。

浏览您的数据库

显示更多模式

数据库 工具窗口显示数据源的内省数据库和模式。 要在树中显示数据库或模式,请在数据源的模式选择器中选择它。

有关内省的更多信息,请参阅 术语表

  • 要在新数据源节点下查看更多模式,请单击 M 中的 N 按钮并选择您需要的模式。 PhpStorm 将进行内省并显示它们。

    在数据库工具窗口中选择要内省和显示的数据库和架构

查找数据库对象

  • 要在 数据库 工具窗口中搜索数据库对象,请开始输入对象的名称。 匹配的数据库对象将被高亮显示。

    要切换快速搜索过滤器,请单击 快速搜索过滤器图标快速搜索过滤器。 要在多个高亮项目之间移动,请按 UpDown

有关快速搜索的更多信息,请参阅 工具窗口中的 Speed Search

过滤数据库对象

您可以过滤数据库对象并隐藏您不需要查看的对象。 为此,请使用数据源设置中的对象过滤器或工具窗口项目过滤器。

  • 数据源设置中的对象过滤器

    例如,您可以过滤掉所有名称以 payment_ 开头的表。

    1. 要筛选数据库对象,请打开 数据源和驱动程序 对话框(Shift+Enter)。

    2. 在对话框的左侧窗格中,选择您要过滤数据库对象的数据源。

    3. 架构 选项卡中,导航到 对象筛选器 并输入模式。 在我们的示例中, table:-payment_.*

    在数据源设置对话框中过滤表
  • 工具窗口视图选项中的项目过滤器

    1. 在工具栏中,单击 视图选项图标查看选项 并选择 筛选图标过滤器

    2. 选择或取消选择您想要查看或隐藏的项目。

    3. 要确认选择,请单击 数据库 工具窗口中的任意区域。

    仅视图和表格会在数据库工具窗口中显示

复制数据源

  1. 数据库 工具窗口中,选择您要复制的数据源。

  2. 按下 Ctrl+C

    IDE 会复制包含连接设置的 XML 片段。

  3. 在目标 IDE 中,打开 数据库 工具窗口。

  4. 按下 Ctrl+V

    在打开的 数据源和驱动程序 中,在 密码 字段中输入密码。

  5. 点击 确定 保存您的新数据源并关闭对话框。

有关以 XML 格式复制数据源的更多信息,请参阅 在 IDE 实例之间共享数据源

将数据源分组到文件夹中

  • 要将数据源分组到文件夹中,请右键单击数据源并选择 移动到文件夹。 在 移动到文件夹 对话框中,您可以将数据源移动到现有文件夹或创建新文件夹。

有关分组数据源的更多信息,请参阅 将数据源分组到文件夹中

移动到文件夹

查看快速文档

  • 快速文档显示有关项目的信息。 要查看信息,请选择项目并按 Ctrl+Q

    数据库工具窗口中的快速文档弹出窗口中的表信息

滚动到编辑器中打开的对象

  • 要在数据库树中滚动到数据库对象,请将插入点放在代码编辑器中对象名称上。 然后,在 数据库 工具窗口工具栏中,单击 从编辑器滚动从编辑器滚动

    相应的节点将打开,对象将在数据库树中高亮显示。

创建快速表备份

  • 在进行任何重要数据操作之前,您可以创建快速表备份。 为此,请将表拖动到原始模式并在 Import 对话框中创建表的副本。

有关对话框的更多信息,请参阅 导入对话框

数据库 工具窗口中,您可以切换 Speed Search Filter 的结果。

  1. 开始键入要查找的数据库对象名称。

  2. 请点击 筛选按钮快速搜索过滤器 工具栏。

调整树视图

切换非主要对象的分组

  • 默认情况下,非主要对象分组在 数据库对象服务器对象 节点中。 要切换此分组,请单击工具栏中的 视图选项图标查看选项 ,导航到 分组查看 并单击 数据库和服务器对象

有关视图选项的更多信息,请参阅 数据库主题。

  • 分组已启用

    已启用次要对象分组
  • 分组已禁用

    已禁用次要对象分组

为数据源及其对象分配颜色

  1. 数据源和驱动程序 对话框(Shift+Enter )中,点击 名称 字段末尾的圆圈并选择颜色。

  2. 应用更改并关闭对话框。

有关为数据源分配颜色的更多信息,请参阅 为数据源分配颜色为查询控制台和网格分配颜色

为数据源分配颜色

显示树缩进指南

数据库 工具窗口中,您可以显示标记缩进级别的垂直线,以帮助您更好地理解数据库中对象的层次结构。

  1. Ctrl+Alt+S 打开设置,然后选择 外观与行为 | 外观

  2. 树视图 部分,启用 显示缩进指示线 选项。

  • 树缩进指南已启用

    已启用显示树缩进指南设置
  • 树缩进指南已禁用

    已禁用显示树缩进指南设置

显示注释和最后刷新日期

您可以查看数据库树中对象的注释和最后刷新时间戳。

  • 在工具栏中,单击 视图选项图标视图选项 ,导航到 节点详细信息 并选择 注释架构刷新时间

参考信息

标题工具栏

您可以右键单击窗口标题并使用上下文菜单配置其 查看模式 ,将窗口与不同的 工具窗口栏 关联,或调整大小并隐藏窗口。

您也可以使用工具栏按钮:

项目

快捷方式

描述

从编辑器滚动

当编辑器区域处于焦点时,会自动将焦点设置到 数据库 工具窗口中的对象名称上。

全部展开

Ctrl+NumPad +

展开当前视图中的所有节点。

全部折叠

Ctrl+NumPad -

折叠当前视图中所有展开的节点。

隐藏工具窗口

Shift+Escape

隐藏工具窗口。

要隐藏所有工具窗口,请按 Ctrl+Shift+F12

标题上下文菜单

项目

描述

从编辑器自动滚动

使在编辑器中打开的数据库对象在 数据库 工具窗口中自动选中。 禁用 从编辑器滚动从编辑器滚动 设置。

显示查询控制台工具栏

查询控制台标签页 中显示工具栏。

Speed Search 图标 快速搜索

打开 工具窗口中的 Speed Search功能的输入字段。

显示工具栏

数据库 工具窗口中显示工具栏。

视图模式

此选项允许您控制工具窗口的一般外观与行为。 有关完整信息,请参阅 工具窗口视图模式

移至

要将工具窗口与不同的 工具窗口栏关联起来,请选择此命令,然后选择目标工具窗口栏(顶部左侧底部右侧)。 有关完整信息,请参考 移动工具窗口 章节。

调整大小

要通过移动工具窗口的某个边界来调整其大小,请选择此命令,然后选择必要的 延展至 选项。

请注意,此命令在浮动模式下不可用。

从边栏中移除

此命令隐藏工具窗口,从工具窗口栏中移除相关的 工具窗口按钮 ,并从 快速访问菜单tb showntb hidden )中移除工具窗口。

要重新打开工具窗口(并恢复相关功能),请使用主菜单: 视图 | 工具窗口 | <Window Name> 或按 Alt+1

帮助

此命令在 PhpStorm 在线帮助中打开 Project 工具窗口的描述。

工具栏

数据库工具窗口工具栏
新图标

新建

创建新的数据源、查询控制台或驱动程序。

适用于:数据源及其元素。

数据源属性图标

数据源属性 Shift+Enter

打开 数据源和驱动程序对话框以管理您的数据源及其设置。

适用于:所有节点类型。

刷新图标

刷新 Ctrl+F5

更新所选元素的视图(即将元素的视图与其在数据库中的实际状态同步)。

另请参阅, 数据源和驱动程序对话框

适用于:数据源及其元素。

停用图标

停用 Ctrl+F2

关闭所选数据库或数据源的连接。

适用于:具有活动连接的数据源及其元素。

跳转到查询控制台图标

跳转到查询控制台… Ctrl+Shift+F10

打开所选数据源的 query consoles 列表。

适用于:数据源及其元素。

编辑数据图标

编辑数据 F4

在数据编辑器中打开对象的表格视图。 此选项适用于 表、视图和 物化视图。

适用于:数据源中的相应元素。

DDL

转到DDL Ctrl+B

打开所选对象的 DDL 脚本。

例如,如果您在 SELECT 语句中按下此快捷键,您将看到该表格的 DDL(CREATE TABLE 语句)。

转到声明

适用于:数据源中的相应元素。

“比较结构”图标

比较结构… Ctrl+D

迁移 对话框 中比较两个数据库对象的结构。 比较结果显示在 差异查看器 中。

适用于:所选类型相同的两个数据库对象。

视图选项

打开数据库对象树查看选项列表,包括项目过滤器。 有关选项的更多信息,请参阅 查看选项 章节。

适用于:所有项。

查看选项

视图选项通常定义在工具窗口中显示的内容及其显示方式。 要查看或更改这些选项,请单击工具栏上的 视图选项

数据库工具窗口中的查看选项菜单项
筛选图标筛选

打开可供筛选的数据库对象列表。 数据库对象的列表取决于所选数据库。 要查看可用数据库对象及其图标的完整列表,请前往 数据源及其元素的图标

过滤器图标角落的绿色点表示过滤器已开启,并且一些对象已被过滤。

除视图和表外,所有内容均被过滤掉

仅视图和表格会在数据库工具窗口中显示

没有任何过滤

在数据库工具窗口中查看所有项目

在组中查看 | 数据源

显示数据源的文件夹。

有关创建文件夹的更多信息,请参阅 将数据源分组到文件夹中 章节。

在组中查看 | 数据库和架构

显示数据库和架构的文件夹。

在组中查看 | 服务器和数据库对象

显示服务器和数据库对象的文件夹, 服务器对象数据库对象 分别对应。 此设置涉及用户、角色、表空间、模块、外部数据包装器和其他不常用的对象。

在组中查看 | 对象元素

此选项定义了表格元素的显示方式。

  • 开启时,列、索引、主键和外键约束以及触发器有各自的独立节点(显示为文件夹)。 这些元素出现在相应的组中。

  • 关闭时,不会有这样的分组,并且通常情况下只会显示表格的列。

在组中查看 | 架构对象

定义模式元素的显示方式。

  • 启用时,表、视图和存储例程分别显示为节点(以文件夹形式显示)。 表、视图和例行程序(过程和函数)作为相应组的元素显示。

  • 如果关闭,则不会对表、视图和例程进行显式分组。 表格和视图之后是过程和函数。

在组中查看 | 分离过程和函数

在 Microsoft SQL Server、Oracle 和 PostgreSQL 中,将过程和函数分到不同的文件夹中。

在组中查看 | 将约束和类似对象放在架构下

显示架构命名空间中存在的对象名称的节点。 例如,键、 CHECK 约束、索引、触发器、规则和其他对象的节点。

您可以在以下情况下使用此选项:

  • 使用快速搜索在架构中查找对象。

  • 查看表节点下的列。 若要执行此操作,请关闭 空组

在组中查看|按字母顺序排序

按字母顺序排列数据库对象。 当选项被禁用时,应用自然排序顺序。

显示元素 | 所有命名空间

即使未选择用于 introspection ,也显示所有数据库和架构。

  • 所有命名空间 选项被禁用时,未选择进行内省的数据库不会出现在 数据库 工具窗口中。

  • 所有命名空间 选项被启用时,未选择进行内省的数据库会显示在 数据库 工具窗口中。

显示元素 | 空组

如果选择了 架构对象对象元素 选项,您可以选择显示或隐藏不包含元素的类别。

显示元素 | 中间节点

仅当父节点同级别没有其他对象时,显示或隐藏父节点。

显示元素 | 生成的对象

对于 Oracle,在树中显示或隐藏自动生成的对象。 涉及以下对象:

  • 物化视图日志

  • 物化视图的底层表

  • 辅助表

显示元素 | 虚拟对象

显示或隐藏以下对象:

  • 虚拟外键

  • 虚拟视图

  • 虚拟列

节点详情| 注释

显示数据库对象的注释。

节点详情| 架构刷新时间

显示上次为模式执行自省的本地日期和时间。

此功能目前不支持 ClickHouse、Redis、Apache Cassandra 和 Apache Hive。

上下文菜单

当您右键单击 数据库 工具窗口中的对象时,会显示上下文菜单操作。

属性图标属性 Shift+Enter

打开 数据源和驱动程序对话框以管理您的数据源及其设置。

适用于:数据源和 DDL 数据源节点。

新图标新建

创建新的数据源、角色、数据库、模式、查询控制台、表、列、索引、主键或外键。 所列选项取决于当前选择的元素。

适用于:数据源及其元素。

复制/粘贴 | 复制数据源 Ctrl+C

将包含连接设置的 XML 代码片段复制到剪贴板。

适用于:数据源节点。

复制/粘贴 | 复制引用(Y) Ctrl+Alt+Shift+C

将所选项目的完全限定名称复制到剪贴板。

适用于:数据源及其元素。

复制/粘贴 | 复制 Ctrl+D

创建所选数据源的副本。 在打开的 数据源和驱动程序 对话框中指定数据源的属性。

适用于:数据源和 DDL 数据源节点。

编辑数据图标编辑数据 F4

在数据编辑器中打开对象的表格视图。 此选项适用于 表、视图和 物化视图。

适用于:数据源中的相应元素。

移至文件夹… F6

将所选数据源移动到文件夹中。 如果尚未存在文件夹,请在出现的 移动到文件夹 弹窗中创建第一个文件夹。

有关分组数据源的更多信息,请参阅 将数据源分组到文件夹中

适用于:数据源和 DDL 数据源节点。

刷新图标刷新 Ctrl+F5

更新所选元素的视图(即将元素的视图与其在数据库中的实际状态同步)。

另请参阅, 数据源和驱动程序对话框

适用于:数据源及其元素。

停用图标停用 Ctrl+F2

关闭所选数据库或数据源的连接。

适用于:具有活动连接的数据源及其元素。

快速文档 Ctrl+Q

查看所选元素的基本信息。

要关闭文档弹出窗口,请按 Escape

适用于:数据源及其元素。

有关快速文档的详细信息,请参阅 快速文档

“比较结构”图标与以下结构对比 Ctrl+D

迁移 对话框 中比较两个数据库对象的结构。 比较结果显示在 差异查看器 中。

适用于:所选类型相同的两个数据库对象。

导航 | 转到DDL Ctrl+B

打开所选对象的 DDL 脚本。

例如,如果您在 SELECT 语句中按下此快捷键,您将看到该表格的 DDL(CREATE TABLE 语句)。

转到声明

适用于:数据源中的相应元素。

导航 |跳转到查询控制台… Ctrl+Shift+F10

打开所选数据源的 query consoles 列表。

适用于:数据源及其元素。

运行功能运行过程

运行所选函数或过程。

适用于:数据源元素:函数、过程。

内省级别

您可以更改整个数据库或特定模式的 introspection level。 子项继承父项设置的级别。

适用于:数据源节点。

SQL 脚本 | SQL 生成器… Ctrl+Alt+G

为数据库对象生成数据定义结构。 例如,您可以为单个表或架构中的所有表生成 DDL 文件。 此外,您可以自定义生成设置。 例如,您可以设置用于创建表的语法: CREATE TABLECREATE TABLE IF NOT EXISTS

适用于:数据源元素。

有关使用 SQL Generator 的更多信息,请参阅 为数据库对象生成 DDL 定义更改 SQL 生成器的输出设置 章节。

SQL 脚本 | 请求并复制原始DDL

请求 DBMS 服务器获取或生成该对象的源文本,接收该文本并将其放入剪贴板。

适用于:数据源及其元素。

SQL 脚本 | 将DDL 生成到剪贴板 Ctrl+Alt+Shift+G

生成对象的 DDL 并将其复制到剪贴板。

适用于:数据源及其元素。

SQL 脚本 | 将DDL 生成到查询控制台 Ctrl+Alt+Shift+B

生成该对象的 DDL 并将其复制到查询控制台。

适用于:数据源及其元素。

对象操作| 重命名… Shift+F6

重命名选定项目。 请在打开的对话框中指定新名称。

适用于:数据源及其元素。

对象操作| 启用触发器/约束(E)

启用所选表的触发器和约束。

适用于:数据源元素:表。

对象操作| 禁用触发器/约束(D)

禁用所选表的触发器和约束。

适用于:数据源元素:表。

对象操作|修改注释

修改注释 对话框中修改数据库对象注释。

对象操作|修改权限

修改授权<object_name> 对话框中修改数据库对象的权限。

对象操作| 截断(T)…

移除选定表中的所有行。

适用于:数据源元素:表。

对象操作| 删除…对象操作|移除数据源 Delete

删除选定项。

适用于:数据源及其元素。

工具 | 管理显示的架构…

打开一个包含当前数据源的可用模式的弹出窗口。

另请参阅, 显示和隐藏模式

适用于:数据源及其元素。

工具 | 全文搜索 Shift+Ctrl+Alt+F

在您的数据库或一组数据库中搜索数据,而无需知道数据的确切位置。

适用于:数据源及其元素。

如需了解有关全文搜索的更多信息,请参阅 数据库中的全文搜索

工具 | 设置颜色…

打开 Database Color Settings 对话框 ,以设置或更改所选元素的颜色。

另请参阅, 为查询控制台和网格分配颜色

适用于:数据源及其元素。

工具 | 添加书签(B) F11

将选定项添加到书签。

适用于:数据源及其元素。

工具 | 脚本化扩展程序 | Generate POJOs.clj

为选定的表生成一个 Java 实体类。 在打开的对话框中,指定应生成 JAVA 类文件的目录。

适用于:数据源及其元素。

工具 | 脚本化扩展程序 | 转到脚本目录

切换到 生成 POJOs.clj 示例脚本文件所在的目录。

适用于:数据源及其元素。

导入/导出 | 导出数据到文件

将所选表格和视图的数据保存到文件中。 选择输出格式(例如,SQL Inserts、制表符分隔 (TSV)、JSON-Clojure.json.clj)。

适用于:数据源元素:表和视图。

导入/导出 | Import Data from File(s)…

将包含分隔符分隔值(CSV、TSV 等)的文本文件导入到您的数据库中。

如果当前选择了一个架构,PhpStorm 将为您导入的数据创建一个新表。 如果选择了一张表,PhpStorm 将尝试将数据添加到所选的表中。

适用于:数据库表。

导入/导出 | 复制表至 F5

创建所选表的副本。 您可以在不同的方案或数据源中创建副本。 例如,您可以将 actor 表格从 MySQL 拷贝到 PostgreSQL。

适用于:数据库表和视图。

导入/导出 | 转储到DDL 数据源

通过将常规数据源转储到根/存储库文件夹来创建您的 DDL 数据源。

适用于:数据源及其元素。

""" 导入/导出 | 使用'mysqldump' 导出…导入/导出 | 使用'pg_dump' 导出… """

为所选项目运行 mysqldump 或 pg_dump。 mysqldump 和 pg_dump 是 MySQL 和 PostgreSQL 的原生工具。 它们未集成到 PhpStorm 中。 您可以在 dev.mysql.compostgresql.org 阅读相关内容。

适用于:数据源节点。

导入/导出 | 使用'mysql' 还原…导入/导出 | 使用'psql' 还原…还原

运行 mysql、pg_restore 或 psql 恢复数据转储。 这些工具是 MySQL 和 PostgreSQL 的本地工具。 它们未集成到 PhpStorm 中。 您可以在 dev.mysql.compostgresql.org 阅读相关内容。

适用于:数据源节点。

图表 | 显示图表 Ctrl+Alt+Shift+U

在单独的编辑器标签页中查看所选数据源或表的 UML 类图。

适用于:数据源及其元素。

图表 | 显示图表弹出窗口 Ctrl+Alt+U

在弹出窗口中查看所选数据源或表的 UML 类图。

适用于:数据源及其元素。

诊断 | 转储Metadata 模型(M)

以 PhpStorm 内部格式生成数据库的诊断表示。 如果某些数据库对象存在于数据库中但未显示在 数据库 工具窗口中,此信息可能对支持团队有帮助。

适用于:数据源及其元素。

诊断 | 生成内省器诊断文件

生成包含以下信息的三个文件:

  • dataSource.txt :数据源。

  • introspector.txt :用于从数据库加载元数据的模块。

  • model.xml :数据库模型的一部分。

当内省功能无法正常工作时,此信息将有助于排查问题。

适用于:数据源及其元素。

诊断 | 显示JDBC 日志设置(S)…

打开 JDBC 日志设置 对话框 以配置 JDBC 驱动程序日志设置。

适用于:数据源及其元素。

诊断 | 强制刷新 Ctrl+Shift+F5

从缓存中删除数据源信息并重新加载。 此操作仅在数据源节点上可用。

适用于:数据源节点。

诊断 | 忘记此架构缓存

删除 PhpStorm 已收集的关于您的数据库的信息。 此操作仅在数据源节点上可用。

遇到数据结构显示错误或同步期间出现错误时,请使用此命令。

要检查这是否消除了问题,请使用 Synchronize command

适用于:数据源节点。

诊断 | 诊断模式

启用诊断模式,在该模式下 PhpStorm 会写入内省日志。

您可以通过单击 诊断日志已启动诊断日志已停止 通知弹窗中的链接访问日志文件,这些弹窗会在启用和禁用模式时出现。

日志文件的通知

图标

数据源及其元素

图标

描述

访问方法

访问方法

聚合

聚合

别名类型

别名类型

参数

参数

正文

正文

检查

检查

集群

集群

排序规则

排序规则

集合类型

集合类型

列

列。

如需了解更多关于列图标组合的信息,请参考 栏目可能的图标组合

数据文件

数据文件

数据库

数据库

只读

只读状态

DDL 数据源图标

DDL 数据源

默认

默认

异常

异常

扩展

扩展

外部模式

外部模式

外部数据包装器

外部数据包装器

外键

外键

外部表

外部表

Index

Index

键

物化日志

物化日志

物化视图

物化视图

对象属性

对象属性

对象类型

对象类型

运算符

运算符

包

主键

主键

投影

投影

数据源

数据源

Role

Role

例行程序

例行程序

规则

规则

计划事件

计划事件

架构

架构

序列

序列

服务器

服务器

存储过程或函数图标

存储过程或函数

同义词

同义词

Table

Table

表类型

表类型

表空间

表空间

触发器

触发器

User

User

用户映射

用户映射

变量

变量

视图

视图

虚拟列

虚拟列

虚拟外键

虚拟外键

虚拟视图

虚拟视图

虚拟表

虚拟表

栏目可能的图标组合

图标

外键

主键

索引

NOT NULL

列

带有外键的列

具有外键

带有主键的列

具有主键

索引列

索引

不接受 NULL 值的列

具有NOT NULL约束

不接受 NULL 值的索引列

索引

具有NOT NULL约束

带有主键和外键且不接受 NULL 值的索引列

具有外键

具有主键

索引

具有NOT NULL约束

带有主键和外键的索引列

具有外键

具有主键

索引

不接受 NULL 值的含有主键和外键的列

具有外键

具有主键

具有NOT NULL约束

包含主键和外键的列

具有外键

具有主键

不接受 NULL 值的带有外键的索引列

具有外键

索引

具有NOT NULL约束

不接受 NULL 值的外键列

具有外键

具有NOT NULL约束

带有外键且接受 NULL 值的索引列

具有外键

索引

带有主键且不接受 NULL 值的索引列

具有主键

索引

具有NOT NULL约束

不接受 NULL 值的主键列

具有主键

具有NOT NULL约束

带主键的索引列

具有主键

索引

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