数据库工具窗口
启用 数据库工具和 SQL 插件
此功能依赖于 数据库工具和 SQL 插件,该插件默认随 PyCharm 一起捆绑并启用。 如果相关功能不可用,请确保您未禁用该插件。
按 Ctrl+Alt+S 打开设置,然后选择 。
打开 已安装 选项卡,找到 数据库工具和 SQL 插件,并选中插件名称旁边的复选框。
概述
在 数据库 工具窗口中,您可以处理数据库和 DDL 数据源。 您可以查看并修改数据库中的数据结构,以及执行其他相关任务。
可用的数据源将以树状结构显示,包括数据源、架构、表等。

如果当前尚未定义数据源,请使用 新建 命令 Alt+Insert 创建数据源并连接到数据库。 有关数据源的更多信息,请参阅 数据源 主题。
一旦 PyCharm 连接到数据库, 数据库 工具窗口将显示 已内省的 数据库对象。 有关数据库树查看选项的更多信息,请参阅 视图选项 章节。 有关在 PyCharm 中处理数据库对象的更多信息,请参阅相应对象的主题。
此窗口中的大多数功能可通过工具栏图标或上下文菜单命令访问。 许多命令都有键盘快捷键。
浏览您的数据库
查找数据库对象
要在 数据库 工具窗口中搜索数据库对象,请开始输入对象名称。 匹配的数据库对象将被高亮显示。
要切换快速搜索过滤器,请点击
快速搜索筛选器。 要在多个高亮项目之间移动,请按 Up 和 Down。
有关快速搜索的更多信息,请参阅 工具窗口中的快速搜索。
筛选数据库对象
您可以筛选数据库对象并隐藏不需要查看的对象。 为此,请使用数据源设置中的对象过滤器或工具窗口的条目过滤器。
显示更多架构
数据库 工具窗口会显示数据源中已内省的数据库和架构。 要在树中显示某个数据库或架构,请在数据源的架构选择器中选择它。
有关内省的更多信息,请参阅 Glossary。
若要在新的数据源节点下查看更多架构,请点击 第 N 个,共 M 个 按钮并选择所需的架构。 PyCharm 将对其进行内省并显示。

在表中查看组
在 数据库 工具窗口中,点击一个对数据库对象进行分组的节点,然后按 F4。
有关切换分组视图的更多信息,请参阅 自定义对象视图。

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

滚动到编辑器中打开的对象
要在数据库树中滚动到某个数据库对象,请将插入符号置于代码编辑器中该对象名称上。 然后,在 数据库 工具窗口工具栏中,点击
从编辑器滚动。
相应的节点将会展开,并且该对象会在数据库树中高亮显示。
在树中使用文件夹
数据库 允许创建 文件夹 ,并在其中对数据源进行分组。 您还可以将一个文件夹移动到另一个文件夹中,并创建子文件夹。 文件夹配置存储在 .idea/db-forest-config.xml。 您可以将此配置文件添加到 VCS 以与同事共享,或者也可以在 VCS 中将其忽略。
将树项移动到文件夹
要在文件夹中对数据源进行分组,或将一个文件夹移动到另一个文件夹,请右键点击该条目并选择 。
在 移动到文件夹 弹出窗口中,选择要将该条目移动到的文件夹。 您可以将该条目移动到现有文件夹,创建一个新文件夹并将条目移入其中,或将条目移动到顶层。
有关对数据源进行分组的更多信息,请参阅 在文件夹中对数据源进行分组。

重新排序文件夹和数据源
要在树中移动文件夹和数据源,请使用 移动 上下文菜单操作及相应的快捷键。
要在列表中上移或下移条目,请选择 和 。 或者,按 Alt+Shift+Up 和 Alt+Shift+Down。
要将条目移动到树的最高级别,请选择 。

配置树视图
自定义对象视图
若要对数据源进行分组、启用或排序,请在 数据库 工具窗口工具栏上点击
视图选项 ,并选择所需选项。
在 数据库 工具窗口中,数据库对象树的视图会立即改变。
有关数据库树查看选项的更多信息,请参阅 视图选项。

切换非主要对象的分组
默认情况下,非主要对象会分组到 数据库对象 和 服务器对象 节点中。 要切换此分组,请在工具栏中点击
视图选项 ,转到 分组查看 并点击 数据库与服务器对象。
有关视图选项的更多信息,请参阅 数据库 主题。
已启用分组

已禁用分组

为数据源和数据库对象分配颜色
为更好地区分数据库,您可以为数据源分配颜色。 颜色可以在 数据库 、代码编辑器和数据编辑器的选项卡标题、代码编辑器和网格以及工具栏中启用。
在 数据库 工具窗口中,右键点击该数据源并转到 。
在 数据库颜色设置 对话框中,选择要分配的颜色及其启用位置。
有关此对话框中设置的详细信息,请参阅 数据库颜色设置对话框 参考主题。
应用更改并关闭对话框。
有关在其设置对话框中为数据源分配颜色的更多信息,请参阅 为数据源指定颜色。


显示树缩进参考线
在 数据库 工具窗口中,您可以显示标记缩进级别的竖线,帮助您更好地理解数据库中对象的层级结构。
按 Ctrl+Alt+S 打开设置,然后选择 。
在 树状视图 部分,启用 显示缩进参考线 选项。
树缩进参考线已启用

树缩进参考线已禁用

显示注释和上次刷新日期
您可以查看数据库树中对象的注释和上次刷新时间戳。
在工具栏中,点击
视图选项 ,转到 节点详细信息 并选择 注释 和 架构刷新时间。
效率技巧
创建快速表备份
在进行重大数据操作之前,您可以创建表的快速备份。 为此,请将表拖到原始架构,并在 导入 对话框中创建该表的副本。
有关该对话框的更多信息,请参阅 导入对话框。
参考信息
标题工具栏
您可以右键点击窗口标题,并使用上下文菜单配置其 查看模式 ,将该窗口关联到其他 工具窗口栏 ,或调整大小并隐藏该窗口。
您也可以使用工具栏按钮:
条目 | 快捷键 | 说明 |
|---|---|---|
当编辑器区域获得焦点时,自动将焦点设置到 数据库 工具窗口中的对象名称。 | ||
Ctrl+NumPad + | 展开当前视图中的所有节点。 | |
Ctrl+NumPad - | 折叠当前视图中已展开的所有节点。 | |
隐藏 Shift+Escape | 隐藏工具窗口。 要隐藏所有工具窗口,请按 Ctrl+Shift+F12。 |
标题上下文菜单
条目 | 说明 |
|---|---|
从编辑器自动滚动 | 使在编辑器中打开的数据库对象在 数据库 工具窗口中自动选中。 禁用 |
显示查询控制台工具栏 | 在 查询文件 选项卡中显示工具栏。 |
| 打开 工具窗口中的快速搜索 功能的输入字段。 |
显示工具栏 | 在 数据库 工具窗口中显示工具栏。 |
视图模式 | 此选项允许您控制工具窗口的一般外观和行为。 有关完整信息,请参阅 工具窗口视图模式。 |
移至 | 要将该工具窗口关联到其他 工具窗口栏 ,请选择此命令,然后选择目标工具窗口栏(顶部、 左侧、 底部 或 右侧)。 有关完整信息,请参阅 移动工具窗口 章节。 |
调整大小 | 要通过移动其某个边框来调整工具窗口大小,请选择此命令,然后选择所需的 拉伸到 选项。 请注意,此命令不适用于浮动模式。 |
从边栏中移除 | 此命令会隐藏工具窗口,从工具窗口栏中移除关联的 工具窗口按钮 ,并将该工具窗口从 快速访问菜单 ( 要再次打开该工具窗口(并恢复关联的功能),请使用主菜单: ,或按 Alt+1。 |
帮助 | 此命令会在 PyCharm 在线帮助中打开 项目 工具窗口的说明。 |
工具栏

新建
创建新的数据源、 查询文件 或驱动程序。
可用于:数据源和数据库对象。
数据源属性 Shift+Enter
打开 数据源和驱动程序对话框 以管理您的数据源及其设置。
可用于:所有节点类型。
刷新 Ctrl+F5
更新所选元素的视图(即将该元素的视图与其在数据库中的实际状态同步)。
See also, 数据源和驱动程序对话框。
可用于:数据源及其元素。
停用 Ctrl+F2
关闭所选数据源的数据库连接。
可用于:具有活动连接的数据源及其元素。
跳转到查询控制台… Ctrl+Shift+F10
打开所选数据源的 查询文件 列表。
可用于:数据源及其元素。
编辑数据 F4
打开对象在数据编辑器中的表视图。 此选项适用于表、视图和物化视图。
可用于:数据源中的相应元素。
DDL转到DDL Ctrl+B
打开所选对象的 DDL 脚本。
例如,如果您在
SELECT语句中的表名上按此快捷键,您将看到该表的 DDL(CREATE TABLE语句)。
可用于:数据源中的相应元素。
比较结构… Ctrl+D
在 迁移 对话框 中比较两个数据库对象的结构。 比较结果会显示在差异查看器中。
可用于:两个所选且类型相同的数据库对象。
视图选项
打开数据库对象树的视图选项列表,其中包含条目过滤器。 有关这些选项的更多信息,请参阅 视图选项 章节。
可用于:所有条目。
视图选项
视图选项通常用于定义工具窗口中显示的内容及其显示方式。 要查看或更改这些选项,请在工具栏上点击 视图选项。

筛选
打开可供筛选的数据库对象列表。 数据库对象列表取决于所选数据库。 要查看可用数据库对象及其图标的完整列表,请转到 数据源及其元素的图标。
过滤器图标角上的绿色圆点表示已启用过滤器,且某些对象被过滤掉。
在数据库工具窗口中仅选择显示视图和表

在数据库工具窗口中选择显示所有项

为数据库和架构显示文件夹。
分别为服务器对象和数据库对象显示文件夹, 服务器对象 和 数据库对象。 此设置与用户、角色、表空间、模块、外部数据封装器以及其他不常用对象相关。
此选项定义表元素的显示方式。
开启时,列、索引、主键和外键约束以及触发器会作为单独的节点显示(显示为文件夹)。 这些元素会显示在相应分组中。
关闭时,不进行此类分组,通常仅为表显示列。
定义架构元素的显示方式。
开启时,表、视图和存储例程会作为单独的节点显示(显示为文件夹)。 表、视图和例程(过程与函数)会作为相应分组中的元素显示。
关闭时,表、视图和例程不进行显式分组。 表和视图之后显示过程与函数。
在 Microsoft SQL Server 、 Oracle 和 PostgreSQL 中,将过程和函数分到不同的文件夹。
为存在于架构命名空间中的对象名称显示节点。 例如,键、
CHECK约束、索引、触发器、规则以及其他对象的节点。您可以在以下情况下使用此选项:
要借助快速搜索在架构内查找对象。
要查看表节点下的列。 要做到这一点,关闭 空组。
按字母顺序排序数据库对象。 当禁用该选项时,将应用自然排序顺序。
即使未选择进行 内省 ,也显示所有数据库和架构。
当 所有命名空间 选项被禁用时,未选择进行内省的数据库不会出现在 数据库 工具窗口中。
当 所有命名空间 选项被启用时,未选择进行内省的数据库会显示在 数据库 工具窗口中。
仅当与父级处于同一层级没有其他对象时,显示或隐藏父节点。
对于 Oracle,在树中显示或隐藏自动生成的对象。 涉及以下对象:
物化视图日志
物化视图的底层表
次级表
显示或隐藏以下对象:
虚拟外键
虚拟视图
虚拟列
显示数据库对象的注释。
显示架构上次执行内省的本地日期和时间。
该功能目前不支持 ClickHouse、Redis、Apache Cassandra 和 Apache Hive。
上下文菜单
上下文菜单操作会在您在 数据库 工具窗口中右键点击对象时出现。
属性 Shift+Enter
打开 数据源和驱动程序对话框 以管理您的数据源及其设置。
可用于:数据源和 DDL 数据源节点。
新建
创建新的数据源、角色、数据库、架构、查询文件、表、列、索引、主键或外键。 选项列表取决于当前所选元素。
可用于:数据源和数据库对象。
- Ctrl+C
将包含连接设置的 XML 代码片段复制到剪贴板。
可用于:数据源节点。
- Ctrl+Alt+Shift+C
将所选条目的完全限定名称复制到剪贴板。
可用于:数据源及其元素。
- Ctrl+D
创建所选数据源的副本。 在打开的 数据源和驱动程序 对话框中指定数据源的属性。
可用于:数据源和 DDL 数据源节点。
编辑数据 F4
打开对象在数据编辑器中的表视图。 此选项适用于表、视图和物化视图。
可用于:数据源中的相应元素。
- 移至文件夹… F6
将所选数据源移动到文件夹。 如果尚不存在文件夹,请在出现的 移动到文件夹 弹出窗口中创建第一个文件夹。
有关对数据源进行分组的更多信息,请参阅 在文件夹中对数据源进行分组。
可用于:数据源和 DDL 数据源节点。
刷新 Ctrl+F5
更新所选元素的视图(即将该元素的视图与其在数据库中的实际状态同步)。
另请参阅 数据源和驱动程序对话框。
可用于:数据源及其元素。
停用 Ctrl+F2
关闭所选数据源的数据库连接。
可用于:具有活动连接的数据源及其元素。
- 快速文档 Ctrl+Q
查看所选元素的基本信息。
要关闭文档弹出窗口,请按 Escape。
可用于:数据源及其元素。
有关快速文档的更多信息,请参阅 quick documentation。
与以下对象比较结构 Ctrl+D
在 迁移 对话框 中比较两个数据库对象的结构。 比较结果会显示在差异查看器中。
可用于:两个所选且类型相同的数据库对象。
- Ctrl+B
打开所选对象的 DDL 脚本。
例如,如果您在
SELECT语句中的表名上按此快捷键,您将看到该表的 DDL(CREATE TABLE语句)。
可用于:数据源中的相应元素。
- 跳转到查询控制台… Ctrl+Shift+F10
打开所选数据源的 查询文件 列表。
可用于:数据源及其元素。
运行函数 或 运行存储过程
运行所选函数或过程。
可用于:数据源元素:函数、过程。
- 内省级别
更改整个数据库或特定架构的 内省级别。 子级将继承为父级设置的级别。
可用于:数据源节点。
- Ctrl+Alt+G
生成数据库对象的数据定义结构。 例如,您可以为单个表或架构中的所有表生成 DDL 文件。 此外,您可以自定义生成设置。 例如,您可以设置用于创建表的语法:
CREATE TABLE或CREATE TABLE IF NOT EXISTS。可用于:数据源元素。
有关使用 SQL Generator 的更多信息,请参阅 为数据库对象生成 DDL 定义 和 更改 SQL 生成器的输出设置 章节。
请求 DBMS 服务器获取或生成此对象的源文本,接收该文本并将其放入剪贴板。
可用于:数据源及其元素。
- Ctrl+Alt+Shift+G
生成该对象的 DDL 并将其复制到剪贴板。
可用于:数据源及其元素。
- Ctrl+Alt+Shift+B
生成该对象的 DDL 并将其复制到 查询文件 。
可用于:数据源及其元素。
- Shift+F6
重命名所选条目。 在打开的对话框中指定新名称。
可用于:数据源及其元素。
为所选表启用触发器和约束。
可用于:数据源元素:表。
为所选表禁用触发器和约束。
可用于:数据源元素:表。
在 修改注释 对话框中修改数据库对象注释。
在 修改授权 <object_name> 对话框中修改数据库对象的权限。
删除所选表中的所有行。
可用于:数据源元素:表。
- 或 Delete
删除所选条目。
可用于:数据源及其元素。
打开包含当前数据源可用架构的弹出窗口。
另请参阅 显示和隐藏模式。
可用于:数据源及其元素。
- Shift+Ctrl+Alt+F
在您的数据库或一组数据库中搜索数据,而无需知道数据的确切位置。
可用于:数据源及其元素。
有关全文搜索的更多信息,请参阅 在数据库中进行全文搜索。
打开 数据库颜色设置对话框 以设置或更改所选元素的颜色。
可用于:数据源及其元素。
- F11
将所选条目添加到书签。
可用于:数据源及其元素。
生成所选表的 Java 实体类。 在打开的对话框中,指定应生成 JAVA 类文件的目录。
可用于:数据源及其元素。
切换到 生成 POJOs.clj 示例脚本文件所在的目录。
可用于:数据源及其元素。
将所选表和视图的数据保存到文件中。 选择输出格式(例如,SQL Inserts、Tab-separated (TSV)、JSON-Clojure.json.clj)。
可用于:数据源元素:表和视图。
将包含分隔符分隔值(CSV、TSV 等)的文本文件导入到您的数据库中。
如果当前选择了某个架构,PyCharm 将为您正在导入的数据创建一个新表。 如果选择了某个表,PyCharm 将尝试将数据添加到所选表。
可用于:数据库表。
- F5
创建所选表的副本。 您可以在不同的架构或数据源中创建副本。 例如,您可以将
actor表从 MySQL 复制到 PostgreSQL 。可用于:数据库表和视图。
通过将常规数据源转储到根目录/存储库文件夹来创建您的 DDL 数据源。
可用于:数据源及其元素。
- 或
为所选条目运行 mysqldump 或 pg_dump。 mysqldump 和 pg_dump 是原生 MySQL 和 PostgreSQL 工具。 它们未集成到 PyCharm 中。 您可以在 dev.mysql.com 和 postgresql.org 阅读相关内容。
可用于:数据源节点。
- 或 或 还原
运行 mysql、pg_restore 或 psql 以还原数据转储。 这些工具是 MySQL 和 PostgreSQL 的原生工具。 它们未集成到 PyCharm 中。 您可以在 dev.mysql.com 和 postgresql.org 阅读相关内容。
可用于:数据源节点。
- Ctrl+Alt+Shift+U
在单独的编辑器选项卡中查看所选数据源或表的 UML 类图。
可用于:数据源及其元素。
- Ctrl+Alt+U
在弹出窗口中查看所选数据源或表的 UML 类图。
可用于:数据源及其元素。
以 PyCharm 的内部格式生成数据库的诊断表示。 如果某些数据库对象在数据库中存在但未显示在 数据库 工具窗口中,则此信息可能对支持团队有所帮助。
可用于:数据源及其元素。
生成三个文件,其中包括以下信息:
dataSource.txt :数据源。
introspector.txt :用于从数据库加载元数据的模块。
model.xml :数据库模型的一部分。
当内省工作不正常时,此信息很有帮助。
可用于:数据源及其元素。
打开 JDBC 日志设置 对话框 以配置 JDBC 驱动程序日志设置。
可用于:数据源及其元素。
- Ctrl+Shift+F5
从缓存中删除数据源信息并重新加载。 此操作仅在数据源节点上可用。
可用于:数据源节点。
删除 PyCharm 已累积的有关您数据库的信息。 此操作仅在数据源节点上可用。
当您遇到诸如数据结构显示错误或同步期间出错等问题时,请使用此命令。
要检查是否已消除该问题,请使用 Synchronize command。
可用于:数据源节点。
启用诊断模式,在该模式下 PyCharm 写入内省日志。
启用或禁用该模式后,会出现 诊断日志已启动 和 诊断日志已停止 通知弹出窗口,您可通过点击其中的链接来访问日志文件。

图标
数据源及其元素
图标 | 说明 |
|---|---|
访问方法 | |
聚合 | |
别名类型 | |
参数 | |
包体 | |
检查约束 | |
集群 | |
排序规则 | |
集合类型 | |
列。 有关列图标组合的更多信息,请参阅 列的可能图标组合。 | |
数据文件 | |
数据库 | |
只读状态 | |
DDL 数据源 | |
默认 | |
异常 | |
扩展 | |
外部架构 | |
外部数据封装器 | |
外键 | |
外部表 | |
索引 | |
键 | |
物化日志 | |
物化视图 | |
对象属性 | |
对象类型 | |
运算符 | |
包 | |
主键 | |
投影 | |
数据源 | |
角色 | |
例程 | |
规则 | |
计划事件 | |
架构 | |
序列 | |
服务器 | |
存储过程或函数 | |
同义词 | |
表 | |
表类型 | |
表空间 | |
触发器 | |
用户 | |
用户映射 | |
变量 | |
视图 | |
虚拟列 | |
虚拟外键 | |
虚拟视图 | |
虚拟表 |
列的可能图标组合
图标 | 外键 | 主键 | 已索引 | NOT NULL |
|---|---|---|---|---|
