# 数据加载器

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

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

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

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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 打开设置，然后选择  `插件` 。

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

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

* 数据编辑器中的数据展示。 例如： 1. Excel ![Excel 文件的内容显示在数据编辑器中](https://resources.jetbrains.com/help/img/idea/2026.3/tabular_data_file_data_in_data_editor_excel.png) 2. JSON（默认禁用） ![JSON 文件的内容显示在数据编辑器中](https://resources.jetbrains.com/help/img/idea/2026.3/tabular_data_file_data_in_data_editor_json.png) 要为 JSON 文件启用带有表格视图的 Data 选项卡，请在 高级设置 设置页面 `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)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) 中，将 如果由脚本加载器检测到，则以表格形式打开文件 设置为 全部 。 有关在数据编辑器中查看数据的更多信息，请参阅 [数据编辑器对话框](data-editor-and-viewer.html)。

* 从文件导入数据到数据库 导入源设置: ![导入表格数据文件：表格数据源设置](https://resources.jetbrains.com/help/img/idea/2026.3/db_import_tabular_data_format_source.png) 映射设置: ![导入表格数据文件：映射设置](https://resources.jetbrains.com/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` ：定义格式是否为 [table-first](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) [将 CSV 和 TSV 文件作为表格](editing-csv-and-tsv-files.html)

### 流程

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

