PyCharm 2025.3 Help

导入

启用 数据库工具和 SQL 插件

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

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

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

导入数据

  1. 数据库 工具窗口中,右键点击数据源或架构,然后选择 SQL 脚本 | 运行SQL 脚本…

    从 Database 工具窗口运行 SQL 文件
  2. 在打开的文件浏览器窗口中,导航到要运行的 SQL 文件。

  3. 点击 打开

    您可以在 运行 工具窗口中查看输出。 有关工具窗口控件的更多信息,请参阅 运行工具窗口

从 CSV 文件导入数据

PyCharm 使用数据提取器从 CSV 文件导入数据。 有关数据提取器的更多信息,请参阅 数据提取器 主题。

  1. 数据库 工具窗口中,右键点击架构或表,然后选择 导入/导出 | 从文件导入数据

  2. 导航到 CSV 文件并将其选中。

  3. 导入 对话框的映射树中,选择映射节点(映射图标 ),并指定数据转换设置。

    您可以选择在哪个架构中创建表,以及是将数据导入新表还是现有表。 要选择架构或表,请使用 架构 字段。

  4. 在映射树中,选择源文件以配置其设置。 要将第一行标记为表头,请选择 第一行是表头

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

导入 DSV 文件:映射设置
导入 DSV 文件:CSV 源设置

从表格数据文件导入数据

PyCharm 使用脚本化数据加载器从表格数据文件导入数据。 有关脚本化数据加载器的更多信息,请参阅 数据加载器 主题。

  1. 数据库 工具窗口中,右键点击架构或表,然后选择 导入/导出 | 从文件导入数据

  2. 导航到表格数据文件并将其选中。

  3. 导入 对话框的映射树中,选择映射节点(映射图标 ),并指定数据转换设置。

    您可以选择在哪个架构中创建表,以及是将数据导入新表还是现有表。 要选择架构或表,请使用 架构 字段。

  4. 在映射树中,选择源文件以配置其设置。 要将第一行标记为表头,请选择 第一行是表头

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

导入表格数据文件:映射设置
导入表格数据文件:表格数据源设置

导入表

  1. 选择要复制到其他架构、数据库或现有表的表。

  2. 打开 导入 对话框。 为此,您可以使用以下操作:

    • 右键点击所选内容并导航到 导入/导出 | 将表复制到

    • 将所选内容拖到架构或数据库。

    • Ctrl+Shift+A ,输入 copy tables to ,然后按 Enter

  3. 导入 对话框的映射树中,选择映射节点(映射图标 ),并指定数据转换设置。

    您可以选择在哪个架构中创建表,以及是将数据导入新表还是现有表。 要选择架构或表,请使用 架构 字段。

  4. 在映射树中,选择源文件以配置其设置。

  5. (可选)如果您希望在 IDE 遇到不可转换的值时插入 NULL,请选择 Insert inconvertible values as null

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

导入表:映射设置
导入表:表源设置

还原 Microsoft SQL Server 表数据

您可以使用 bcp 实用程序还原 Microsoft SQL Server 表数据。 该工具未集成到 PyCharm 中。 您可以在 learn.microsoft.com 上了解相关信息。

  1. 数据库 工具窗口 ,右键点击要将数据导入的表,然后选择 导入/导出 | 使用 'bcp' 还原

  2. 使用 bcp(<data_source_name>)还原 对话框中,在 bcp 路径 字段中指定 bcp 可执行文件的路径。

  3. 源文件 ,指定要从中还原数据的文件路径。

  4. 点击 运行

使用 bcp 还原 Microsoft SQL Server 表数据

还原 MySQL 和 PostgreSQL 的完整数据转储

您可以使用用于 MySQL 的 mysql 客户端实用程序,或用于 PostgreSQL 的 pg_restorepsql 来还原数据转储。 pg_restore 选项用于自定义格式的 pg_dump -Fc 或目录格式的 pg_dump -Fd 转储。 psql 选项用于 SQL 格式的转储。

如果在上下文菜单中看不到还原选项,请确认数据源使用的是正确的 JDBC URL。

使用 mysql 或 pg_restore 还原数据

  1. 数据库 工具窗口 ,右键点击架构或数据库并导航到 导入/导出 组:

    • 使用 'mysql' 还原 :用于 MySQL 数据源。 在 可执行文件路径 字段中,指定 mysql 可执行文件的路径(例如, C:\Soft\mysql-8.0.19-winx64\bin\mysql.exe )。

    • 使用 'pg_restore' 还原 :用于 PostgreSQL 数据源。 pg_restore 选项适用于除数据源级别外的大多数数据库对象。

    • 使用 'psql' 还原 :用于 PostgreSQL 数据源。 psql 选项适用于数据源。

    • 使用 'pg_restore'/'psql' 还原 :用于 PostgreSQL 数据源。 包含两个选项卡: pg_restorepsql。 该选项适用于数据库。

  2. 使用 <dump_tool> 还原 对话框中,在 可执行文件路径 字段中指定还原工具可执行文件的路径。

    (可选)在对话框的下部编辑命令行选项。

  3. 点击 运行

使用 pg_restore 还原完整数据转储

'使用还原' 对话框参考

使用 mysql 还原对话框

说明

运行位置

设置运行该工具的位置。 您可以在本地或 Docker 容器中运行它。

  1. 本地

    • 可执行文件路径 :定义您计算机上 mysql 可执行文件的路径。

  2. 在 Docker 容器中

    • 服务器 :设置用于运行容器的服务器。

    • 容器 :设置用于运行 mysql 可执行文件的容器。

    • 可执行文件路径 :定义容器内 mysql 可执行文件的路径。

    • 转储路径(在容器中) :定义容器内转储文件的路径。

选项

数据库

--database

要连接的数据库名称。

转储路径

定义您计算机上转储文件的路径。

使用 pg_restore 还原对话框

说明

运行位置

设置运行该工具的位置。 您可以在本地或 Docker 容器中运行它。

  1. 本地

    • 可执行文件路径 :定义您计算机上 pg_restore 可执行文件的路径。

  2. 在 Docker 容器中

    • 服务器 :设置用于运行容器的服务器。

    • 容器 :设置用于运行 pg_restore 可执行文件的容器。

    • 可执行文件路径 :定义容器内 pg_restore 可执行文件的路径。

    • 转储路径(在容器中) :定义容器内转储文件的路径。

选项

数据库

--dbname

连接到指定数据库并直接还原到其中。

架构

--schema

仅还原指定架构中的对象。

要转储的表

--table

仅还原指定的表。

格式

--format

输出格式:

  • 自动 :pg_restore 会自动确定格式。

  • 目录--format=d。 目录格式归档。

  • 自定义格式归档--format=c。 pg_dump 自定义格式归档。

  • Tar 归档--format=t。 Tar 格式归档。

转储路径

定义您计算机上转储文件的路径。

清理数据库

--clean, -c

在还原前删除所有将被还原的数据库对象。

添加 "IF EXISTS"

--if-exists

当启用 清理数据库 时,使用 DROP ... IF EXISTS 删除对象。

创建数据库

--create, -C

先创建一个新数据库,然后将数据还原到其中。 如果启用 清理数据库 ,则在连接之前删除并重新创建目标数据库。

仅数据

--data-only, -a

仅还原数据,不还原架构。

单个事务

--single-transaction, -1

将还原操作包装在 BEGINCOMMIT 中,以单个事务方式执行。

有关导出选项的更多信息,请参阅 pg_restore 文档

使用 psql 还原对话框

说明

运行位置

设置运行该工具的位置。 您可以在本地或 Docker 容器中运行它。

  1. 本地

    • 可执行文件路径 :定义您计算机上 psql 可执行文件的路径。

    • 将结果输出到 :定义您计算机上输出结果的路径。

  2. 在 Docker 容器中

    • 服务器 :设置用于运行容器的服务器。

    • 容器 :设置用于运行 psql 可执行文件的容器。

    • 可执行文件路径 :定义容器内 psql 可执行文件的路径。

选项

数据库

--dbname

连接到指定数据库并直接还原到其中。

psql 文档。

转储路径

--file

定义您计算机上转储文件的路径。

psql 文档。

单个事务

--single-transaction, -1

将还原操作包装在 BEGINCOMMIT 中,以单个事务方式执行。

psql 文档。

有关导出选项的更多信息,请参阅 psql 文档

导入对话框

当您将 文件查询结果集 导入到数据库时,会显示 导入 对话框。

在该对话框左上角窗格中的映射树中,您可以创建 文件到表、表到表、查询到表 的映射(映射图标)。 在对话框右上角的设置窗格中,配置映射设置,并更改源(CSV 文件、表、查询)的设置。 对话框底部的预览窗格显示您的数据、使用不同源设置的源数据以及 DDL 语句的生成预览。

  1. 映射树。

  2. 源设置。

  3. 预览窗格。

映射树

图标

快捷键

说明

添加图标

添加

Alt+Insert

创建新对象。

移除图标

移除

Alt+Delete

删除所选对象。

编辑图标

编辑

F4

在对象编辑器中打开所选对象。

在选择时编辑图标

选择时编辑

在对象编辑器中切换为选择即打开或双击打开对象。

后退图标

后退(B)

Ctrl+Alt+Left

上一个对象。

前进图标

前进(W)

Ctrl+Alt+Right

下一个对象。

设置

说明

路径

定义源文件的路径。

字符集

确定用于读取文件的字符集。

格式

确定用于读取文件的格式。

点击 配置 CSV 文件格式。

第一行是头(H)

将第一行视为包含列名的行。

第一列是头(H)

将第一列视为包含行名的列。

清除空格(W)

忽略或移除空白字符。 如果该复选框被清除,空白字符被视为相应值的一部分。

源文件列名。

类型

源文件列数据类型。

说明

路径

定义源文件的路径。

加载器

确定用于导入文件数据的 脚本化数据加载器

第一行是头(H)

将第一行视为包含列名的行。

源文件列名。

类型

源文件列数据类型。

说明

定义源表。

说明

目标

定义运行查询所针对的目标对象。

查询

定义源 SQL 查询。

说明

架构

您想要创建或复制表的架构。 您可以在其他数据源中选择架构。

新表的名称,或在您希望向现有表添加数据时的现有表名称。

  • 点击 自动生成 ,即可自动生成名称。

  • 如果可用,请点击 ,在同一 导入 对话框中使用指定名称创建新表。 该表及其对象将作为新节点出现在映射树中。

映射

添加图标, 移除图标, 上移图标, 下移图标

使用这些按钮来添加项目、移除它们,并在列表中将它们上移和下移。

目标列

目标表中的列名。

源列

源表中的列名。

编码

为源文件中的数据选择字符编码。

将错误写入文件

将导入过程中发生的错误写入文本文件。

Insert inconvertible values as null

在无法转换的数据处,向表中插入 NULL 值。

禁用索引和触发器,锁定表(可能更快)

在导入期间禁用索引和触发器。 请注意,如果您选择了此选项,可能会导致触发器不触发并无法传递其结果。 尽管这可能改善导入过程的性能。 该选项仅在目标表(您要复制值的表)具有索引或触发器时可用。

数据预览窗格

说明

修改源图标修改源

文件:<file_name> 格式:<file_format>

打开 CSV 源 部分,其中包含源文件设置。

数据预览

使用已配置设置读取数据的生成预览。

说明

修改源图标修改源

路径 字段中选择源文件路径。

重新加载页面图标重新加载页面

重新加载生成的预览。

数据预览

使用已配置设置读取数据的生成预览。

说明

重新加载页面图标重新加载页面

重新加载表预览。

修改源图标修改源

表:<table_name>

打开 表源 部分,其中包含源表设置。

数据预览

使用已配置设置读取数据的生成预览。

说明

重新加载页面图标重新加载页面

重新加载查询结果集。

修改源图标修改源

表:<table_name>

打开 查询源 部分,其中包含源查询设置。

数据预览

使用已配置设置读取数据的生成预览。

说明

数据预览

显示您的数据将如何导入到数据库的生成预览。

DDL 预览

用于创建表的一个或多个语句,PyCharm 将运行这些语句。 您可以在 DDL 预览 字段中编辑这些语句。

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