PyCharm 2025.3 Help

数据加载器

启用 数据库工具和 SQL 插件

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

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

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

数据加载器 是专用脚本,可让您将表格数据文件导入到数据库中。 它们还支持在数据编辑器中以可视化方式呈现这些数据。 此类文件在数据编辑器中的视图为只读。

  • 在数据编辑器中显示数据。 例如:

    1. Excel

      Excel 文件的内容显示在数据编辑器中
    2. JSON(默认禁用)

      JSON 文件的内容显示在数据编辑器中

      要为 JSON 文件启用具有表格视图的 数据 选项卡,请在 高级设置 设置页面  Ctrl+Alt+S 中,将 如果脚本化加载程序检测到文件,则将其作为表打开 设置为 所有

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

  • 从文件向数据库导入数据

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

    有关将表格数据文件中的数据导入数据库的更多信息,请参阅 从表格数据文件导入数据

要查找数据加载器,请打开 项目 工具窗口并导航到 临时文件和控制台 | 扩展 | 数据库工具和 SQL | data | loaders

自定义数据加载器

您还可以创建并使用用 Groovy 编写的自定义脚本化数据加载器。

建议以以下代码行开始您的脚本:

// IJ: extensions = json displayName = JSON tableFirstFormat=false

关键字如下:

  • extensions :加载器可处理的文件扩展名列表。 使用 ; 作为分隔符。

  • displayName :自定义加载器的名称。

  • tableFirstFormat :定义该格式是否为 table-first。 默认值: true

在您的脚本中,还需添加一个函数,该函数接收以下上下文:文件路径和 DataConsumer 接口。 例如, loadJson

LOADER.load { ctx -> loadJson(ctx.getParameters()["FILE"], ctx.getDataConsumer()) }

对于 DataConsumer 接口,定义如下:

interface DataConsumer { void consumeColumns(String[] names, Class<?>[] types); void consume(Object... row); }
  • void consumeColumns(String[] names, Class<?>[] types); :此方法将列名作为 names 数组接收,并将每列的相应数据类型作为 types 数组接收。

  • void consume(Object... row); :此方法将每列的相应单元格值作为 Object 接收。 每次调用 consume 方法时,都会处理表中的一整行。

有关内置数据加载器脚本的示例,请打开 项目 工具窗口并导航到 临时文件和控制台 | 扩展 | 数据库工具和 SQL | data | loaders

支持的文件格式

支持的文件格式如下:

脚本

文件格式

Excel

.xlsx .xls

JSON

.json

Parquet

.parquet

Shapefile

.shp

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