# 数据加载器

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

Procedure: 启用 数据库工具和 SQL 插件

此功能依赖于 数据库工具和 SQL 插件，该插件默认情况下在 IntelliJ IDEA 中绑定并启用。 如果相关功能不可用，请确保您没有禁用插件。

> **Note:**
> 没有 Ultimate 订阅时，数据库工具和 SQL 的功能支持在 IntelliJ IDEA 中受限。

1. 按 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

2. 找到  数据库工具和 SQL  插件并点击   启用  。

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

* 数据编辑器中的数据展示。 例如： 1. Excel ![Excel 文件的内容显示在数据编辑器中](https://resources.jetbrains.com.cn/help/img/idea/2026.3/tabular_data_file_data_in_data_editor_excel.png) 2. JSON（默认禁用） ![JSON 文件的内容显示在数据编辑器中](https://resources.jetbrains.com.cn/help/img/idea/2026.3/tabular_data_file_data_in_data_editor_json.png) 要为 JSON 文件启用带有表格视图的 数据 选项卡，请在 高级设置 设置页面 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 中，将 如果被脚本化加载器检测到，则将文件作为表打开 设置为 全部 。 有关在数据编辑器中查看数据的更多信息，请参阅 [数据编辑器和查看器](data-editor-and-viewer.html)。

* 从文件导入数据到数据库 导入源设置: ![导入表格数据文件：表格数据源设置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_import_tabular_data_format_source.png) 映射设置: ![导入表格数据文件：映射设置](https://resources.jetbrains.com.cn/help/img/idea/2026.3/db_import_tabular_data_format_mapping.png) 有关将表格数据文件导入数据库的更多信息，请参阅 [从表格数据文件导入数据](import-data.html#import_tabular_data)。

要定位数据加载器，请打开   项目  工具窗口并导航到  `Scratches and Consoles | Extensions | 数据库工具和 SQL | data | loaders` 。

## 自定义数据加载器

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

可以考虑使用以下代码行作为脚本开头示例：

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

```

关键字如下：

* `extensions` ：加载器适用的文件扩展程序列表。 使用 `;` 作为分隔符。

* `displayName` ：自定义加载器的名称。

* `tableFirstFormat` ：定义格式是否为 [表优先](advanced-settings.html#open_tabular_data_file_as_table)。 默认值： `true` 。

在脚本中，另请添加一个接收以下上下文的函数／方法：文件路径和  `DataConsumer`  接口。 例如，  `loadJson` ：

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

```

对于  `DataConsumer`  接口，其定义如下：

```GROOVY
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` 方法时，都会处理表中的一整行。

有关内置数据加载器脚本的示例，请打开   项目   工具窗口并导航到  `Scratches and Consoles | Extensions | 数据库工具和 SQL | data | loaders` 。

## 支持的文件格式

支持的文件格式如下：

|  脚本  |  文件格式  |
| --- | --- |
|  Excel  |   `.xlsx` ，  `.xls`   |
|  JSON  |   `.json`   |
|  Parquet  |   `.parquet`   |
|  Shapefile  |   `.shp`   |

## See also

### 参考

[项目工具窗口](project-tool-window.html) [Data Editor and Viewer](data-editor-and-viewer.html#reference) [导入对话框](import-data.html#import_dialogs)

### 相关

[数据编辑器和查看器](data-editor-and-viewer.html) [将 DSV 文件作为表格编辑](editing-csv-and-tsv-files.html)

### 过程

[从表格数据文件导入数据](import-data.html#import_tabular_data)

