PyCharm 2025.3 Help

数据库管理功能术语表

启用 数据库工具和 SQL 插件

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

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

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

连接到数据库

要连接到数据库,PyCharm 需要连接详细信息(例如 host、port、password、SSH 配置设置等)。 对于每个数据库,连接详细信息存储在专用的连接配置中 — 数据源

对于数据源,与数据库的连接是在特殊的包装器中建立的 – 会话。 每个会话都是单个连接的包装器,并存储该连接的信息(例如是否处于活动状态、事务控制模式及其他设置)。

当您执行需要与数据库交互的操作时,会话中的连接会建立。

例如,一旦您在 数据库 工具窗口中双击某个数据源下的表,就会创建并连接一个新会话,并将 数据编辑器 作为其客户端。 PyCharm 需要活动连接来向数据库请求表数据、接收数据,并在数据编辑器中显示。

有关连接数据库的详细信息,请参阅 连接到数据库 主题。

数据源

数据源 是一种连接配置。 它存储用于与数据库建立连接的连接详细信息列表。 例如 host、port、database name、driver、SSH 和 SSL 配置设置等。 在数据源设置中,您还可以选择要用于 内省 且显示在 数据库 工具窗口中的数据库和架构,并更改连接所用的驱动程序。

包含 PostgreSQL 数据库连接详细信息的数据源

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

“数据库”工具窗口中的数据源

有关为受支持的数据库供应商创建数据源的更多信息,请参阅 创建数据源 部分。

有关管理数据源的更多信息,请参阅 数据源 主题。

有关 数据源和驱动程序 对话框的更多信息,请参阅 数据源和驱动程序对话框 主题。

DDL 数据源

DDL 数据源 是基于包含数据定义语言语句(DDL 语句)的 SQL 文件的数据库结构虚拟视图。 您可以在编辑器中引用此类文件中定义的所有表、列及其他对象。 也支持图表。

DDL 数据源可帮助您维护数据库版本控制。 将 SQL 文件置于 VCS 管理之下,并在每次数据库结构更新时重新生成它们。

一旦创建,DDL 数据源可在 数据库 工具窗口(视图(V) | 工具窗口 | 数据库 )中使用。 您可以在 项目 工具窗口(视图(V) | 工具窗口 | 项目 )中创建并管理包含语句的 SQL 文件。

“数据库”工具窗口中的 DDL 数据源,以及“项目”工具窗口中包含语句的 SQL 文件

有关 DDL 数据源的更多信息,请参阅 DDL 数据源 主题。

会话

每个会话都是单个连接的包装器,并存储该连接的信息(例如是否处于活动状态、事务控制模式及其他设置)。

会话可以拥有 客户端——文件,其查询通过会话所持有的连接发送。 数据编辑器 也可以作为会话的客户端。

例如,一旦您在 数据库 工具窗口中双击某个表,就会有一个新会话连接到数据库,并将该表附加到该会话,作为其客户端。

您可以在 服务 工具窗口中查看数据源、会话及会话客户端。 会话图标角上的绿色圆点表示该会话已连接。

有关会话的更多信息,请参阅 会话

数据编辑器与查看器

数据编辑器与查看器 (或 数据编辑器 )提供用于处理数据的用户界面。 在数据编辑器中,您可以对数据进行排序、筛选、添加、编辑和删除,并执行其他相关任务。

在 PyCharm 中,数据编辑器与查看器使您可以处理 数据库对象数据查询结果集 ,以及 用户文件数据

数据编辑器中的数据库对象数据
分隔符分隔的值文件编辑器中的数据编辑器选项卡

有关数据编辑器的更多信息,请参阅 数据编辑器和查看器

“数据库”工具窗口

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

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

“数据库”窗口

有关在 数据库 工具窗口中处理数据库对象的更多信息,请参阅 数据库对象 部分。

有关 数据库 工具窗口的更多信息,请参阅 数据库工具窗口 主题。

内省

内省 是一种加载数据库元数据的过程。 执行内省时,会检查数据源中的结构信息,以检测表、列、例程等数据库对象及其属性。

PyCharm 使用此信息在 数据库 工具窗口中显示对象、显示其 DDL、在代码补全时提供建议,并用于其他编码辅助功能。

一旦您启动内省,PyCharm 会在状态栏右侧显示内省进度条。

内省运行过程

默认情况下,仅对在 数据库 工具窗口中选择显示的架构和数据库执行内省。

对于少数数据库,支持三个内省级别,以减少内省的对象数量。 有关这些级别的更多信息,请参阅 内省级别 主题。

查询文件

查询文件s 是与数据源关联的 SQL 文件。 您可以像在终端中一样,在 查询文件s 中编写并执行 SQL 语句。

查询文件

有关在 查询文件s 中处理查询结果的更多信息,请参阅 查询结果

创建数据源时,会自动创建一个 查询文件,并默认将其与该数据源关联。 如有需要,您可以为该数据源创建其他 查询文件。 您还可以使用工具栏上的数据源下拉列表, 将 查询文件 关联到其他数据源

默认情况下,查询文件s 存储在 项目目录 查询 子目录中。

在 PyCharm 2025.3 之前,查询文件 的名称为 查询控制台

  • 有关 查询文件s 的更多信息,请参阅 查询文件 主题。

  • 有关 PyCharm 中其他类型的 SQL 文件的更多信息,请参阅 文件管理 主题。

用户文件

用户文件 是存储在您的计算机或您可访问的任何其他位置的文件。 要在 PyCharm 中处理这些文件,请在 项目 工具窗口中访问包含它们的目录。

有关用户文件的更多信息,请参阅 用户文件 主题。

有关 PyCharm 中其他类型的 SQL 文件的更多信息,请参阅 文件管理 主题。

例程

在 PyCharm 中, 例程 将函数和过程合并。 您可以设置 数据库 工具窗口,将其单独显示,或在单个 例程 节点下显示。

  • 例程 节点下组合显示过程与函数

    在“数据库”工具窗口中启用例程显示
  • 过程与函数分别显示在各自的专用节点下

    在“数据库”工具窗口中禁用例程显示

有关 数据库工具窗口 及其视图选项的更多信息,请参阅 数据库工具窗口 主题和 视图选项 章节。

最后修改日期: 2025年 12月 2日