数据加载器

Data loaders 是允许您将表格数据文件导入数据库的专用脚本。它们还使这些数据能够在数据编辑器中进行可视化表示。在数据编辑器中查看此类文件是只读的。

数据编辑器中的数据展示。例如：
1. Excel
2. JSON（默认禁用）
  要在数据选项卡中启用 JSON 文件的表格视图，请在高级设置设置页面  Ctrl+Alt+S 中，将如果脚本化加载程序检测到文件，则将其作为表打开设置为所有。
有关在数据编辑器中查看数据的更多信息，请参阅数据编辑器和查看器。
从文件导入数据到数据库
有关将表格数据文件导入数据库的更多信息，请参阅从表格数据文件导入数据。

要定位数据加载器，请打开个文件工具窗口并导航到临时文件和控制台 | 扩展 | 数据库工具和 SQL | 数据 | 加载器。

自定义数据加载器

您还可以创建并使用您自己用 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 数组，以及每列对应的数据类型作为 类型 数组。
void consume(Object... row); ：此方法接收每列对应的单元格值作为 对象。每次调用 consume 方法时，它会处理表中的一整行数据。

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

支持的文件格式

支持的文件格式如下：

脚本	文件格式
Excel	.xlsx 、 .xls
JSON	.json
Parquet	.parquet
Shapefile	.shp

最后修改日期： 2025年 9月 26日