数据库管理功能术语表
启用 数据库工具和 SQL 插件
此功能依赖 数据库工具和 SQL 插件,该插件在 PyCharm 中默认捆绑并启用。 如果相关功能不可用,请确保未禁用该插件。
按 Ctrl+Alt+S 打开设置,然后选择 。
打开 已安装 选项卡,找到 数据库工具和 SQL 插件,并选中插件名称旁的复选框。
- 连接到数据库
要连接到数据库,PyCharm 需要连接详细信息(例如 host、port、password、SSH 配置设置等)。 对于每个数据库,连接详细信息存储在专用的连接配置中 — 数据源。
对于数据源,与数据库的连接是在特殊的包装器中建立的 – 会话。 每个会话都是单个连接的包装器,并存储该连接的信息(例如是否处于活动状态、事务控制模式及其他设置)。
当您执行需要与数据库交互的操作时,会话中的连接会建立。
例如,一旦您在 数据库 工具窗口中双击某个数据源下的表,就会创建并连接一个新会话,并将 数据编辑器 作为其客户端。 PyCharm 需要活动连接来向数据库请求表数据、接收数据,并在数据编辑器中显示。
有关连接数据库的详细信息,请参阅 连接到数据库 主题。
- 数据源
数据源 是一种连接配置。 它存储用于与数据库建立连接的连接详细信息列表。 例如 host、port、database name、driver、SSH 和 SSL 配置设置等。 在数据源设置中,您还可以选择要用于 内省 且显示在 数据库 工具窗口中的数据库和架构,并更改连接所用的驱动程序。

您可以在 数据库 工具窗口( )中查看和浏览已创建的数据源列表。

有关为受支持的数据库供应商创建数据源的更多信息,请参阅 创建数据源 部分。
有关管理数据源的更多信息,请参阅 数据源 主题。
有关 数据源和驱动程序 对话框的更多信息,请参阅 数据源和驱动程序对话框 主题。
- DDL 数据源
DDL 数据源 是基于包含数据定义语言语句(DDL 语句)的 SQL 文件的数据库结构虚拟视图。 您可以在编辑器中引用此类文件中定义的所有表、列及其他对象。 也支持图表。
DDL 数据源可帮助您维护数据库版本控制。 将 SQL 文件置于 VCS 管理之下,并在每次数据库结构更新时重新生成它们。
一旦创建,DDL 数据源可在 数据库 工具窗口( )中使用。 您可以在 项目 工具窗口( )中创建并管理包含语句的 SQL 文件。

有关 DDL 数据源的更多信息,请参阅 DDL 数据源 主题。
- 会话
每个会话都是单个连接的包装器,并存储该连接的信息(例如是否处于活动状态、事务控制模式及其他设置)。
会话可以拥有 客户端——文件,其查询通过会话所持有的连接发送。 数据编辑器 也可以作为会话的客户端。
例如,一旦您在 数据库 工具窗口中双击某个表,就会有一个新会话连接到数据库,并将该表附加到该会话,作为其客户端。
您可以在 服务 工具窗口中查看数据源、会话及会话客户端。 会话图标角上的绿色圆点表示该会话已连接。
有关会话的更多信息,请参阅 会话。
- 数据编辑器与查看器
数据编辑器与查看器 (或 数据编辑器 )提供用于处理数据的用户界面。 在数据编辑器中,您可以对数据进行排序、筛选、添加、编辑和删除,并执行其他相关任务。
在 PyCharm 中,数据编辑器与查看器使您可以处理 数据库对象数据、 查询结果集 ,以及 用户文件数据。


有关数据编辑器的更多信息,请参阅 数据编辑器和查看器。
- “数据库”工具窗口
在 数据库 工具窗口中,您可以处理数据库和 DDL 数据源。 您可以查看并修改数据库中的数据结构,并执行其他相关任务。
可用数据源以数据源、架构、表等的树形结构显示。

有关在 数据库 工具窗口中处理数据库对象的更多信息,请参阅 数据库对象 部分。
有关 数据库 工具窗口的更多信息,请参阅 数据库工具窗口 主题。
- 内省
内省 是一种加载数据库元数据的过程。 执行内省时,会检查数据源中的结构信息,以检测表、列、例程等数据库对象及其属性。
PyCharm 使用此信息在 数据库 工具窗口中显示对象、显示其 DDL、在代码补全时提供建议,并用于其他编码辅助功能。
一旦您启动内省,PyCharm 会在状态栏右侧显示内省进度条。

默认情况下,仅对在 数据库 工具窗口中选择显示的架构和数据库执行内省。
对于少数数据库,支持三个内省级别,以减少内省的对象数量。 有关这些级别的更多信息,请参阅 内省级别 主题。
- 查询文件
查询文件s 是与数据源关联的 SQL 文件。 您可以像在终端中一样,在 查询文件s 中编写并执行 SQL 语句。

有关在 查询文件s 中处理查询结果的更多信息,请参阅 查询结果。
创建数据源时,会自动创建一个 查询文件,并默认将其与该数据源关联。 如有需要,您可以为该数据源创建其他 查询文件。 您还可以使用工具栏上的数据源下拉列表, 将 查询文件 关联到其他数据源。
默认情况下,查询文件s 存储在 项目目录 的 查询 子目录中。
在 PyCharm 2025.3 之前,查询文件 的名称为 查询控制台。
- 用户文件
用户文件 是存储在您的计算机或您可访问的任何其他位置的文件。 要在 PyCharm 中处理这些文件,请在 项目 工具窗口中访问包含它们的目录。
有关用户文件的更多信息,请参阅 用户文件 主题。
有关 PyCharm 中其他类型的 SQL 文件的更多信息,请参阅 文件管理 主题。
- 例程
在 PyCharm 中, 例程 将函数和过程合并。 您可以设置 数据库 工具窗口,将其单独显示,或在单个 例程 节点下显示。
在 例程 节点下组合显示过程与函数

过程与函数分别显示在各自的专用节点下
