DuckDB 支持读取 Excel .xlsx 文件。但不支持 .xls 文件。

导入 Excel 工作表

在查询的 FROM 子句中使用 read_xlsx 函数。

SELECT * FROM read_xlsx('test_excel.xlsx');

或者，你可以省略 read_xlsx 函数，让 DuckDB 根据文件扩展名自动推断。

SELECT * FROM 'test_excel.xlsx';

但是，如果你需要传递选项来控制导入行为，则应使用 read_xlsx 函数。

其中一个选项是 sheet 参数，它允许指定 Excel 工作表的名称。

SELECT * FROM read_xlsx('test_excel.xlsx', sheet = 'Sheet1');

默认情况下，如果未指定工作表，将加载第一个工作表。

导入指定范围

要选择特定的单元格范围，请使用 range 参数，并传入格式为 A1:B2 的字符串，其中 A1 是左上角单元格，B2 是右下角单元格。

SELECT * FROM read_xlsx('test_excel.xlsx', range = 'A1:B2');

例如，跳过前 5 行：

SELECT * FROM read_xlsx('test_excel.xlsx', range = 'A5:Z');

跳过前 5 列：

SELECT * FROM read_xlsx('test_excel.xlsx', range = 'E:Z');

如果没有提供 range 参数，DuckDB 会自动将范围推断为从第一个连续非空单元格行到相同列中第一个空行之间的矩形区域。

默认情况下，如果未提供范围，DuckDB 在遇到空行时会停止读取 Excel 文件。但如果提供了范围，则默认读取到该范围的末尾。此行为可以通过 stop_at_empty 参数进行控制。

-- Read the first 100 rows, or until the first empty row, whichever comes first
SELECT * FROM read_xlsx('test_excel.xlsx', range = '1:100', stop_at_empty = true);

-- Always read the whole sheet, even if it contains empty rows
SELECT * FROM read_xlsx('test_excel.xlsx', stop_at_empty = false);

创建新表

要使用查询结果创建新表，请使用 SELECT 语句执行 CREATE TABLE ... AS 操作。

CREATE TABLE new_tbl AS
    SELECT * FROM read_xlsx('test_excel.xlsx', sheet = 'Sheet1');

加载到现有表

要将数据从查询加载到现有表中，请使用 SELECT 语句中的 INSERT INTO

INSERT INTO tbl
    SELECT * FROM read_xlsx('test_excel.xlsx', sheet = 'Sheet1');

或者，你可以使用带有 XLSX 格式选项的 COPY 语句将 Excel 文件导入到现有表中。

COPY tbl FROM 'test_excel.xlsx' (FORMAT xlsx, SHEET 'Sheet1');

当使用 COPY 语句将 Excel 文件加载到现有表时，目标表中列的类型将用于强制转换 Excel 工作表中单元格的类型。

导入带有/不带标题的工作表

要将第一行作为结果列的名称，请使用 header 参数。

SELECT * FROM read_xlsx('test_excel.xlsx', header = true);

默认情况下，如果第一行中的所有单元格（在推断或提供的范围内）都是非空字符串，则第一行将被视为标题。要禁用此行为，请将 header 设置为 false。

类型检测

当不导入到现有表时，DuckDB 将尝试根据单元格的内容和/或“数字格式”来推断 Excel 工作表中列的类型。

• 在可能的情况下，TIMESTAMP、TIME、DATE 和 BOOLEAN 类型会根据应用于单元格的“数字格式”进行推断。
• 包含 TRUE 和 FALSE 的文本单元格会被推断为 BOOLEAN。
• 默认情况下，空单元格被视为 DOUBLE 类型。
• 否则，单元格将根据其内容推断为 VARCHAR 或 DOUBLE。

你可以通过多种方式调整此行为。

要将所有空单元格视为 VARCHAR 而不是 DOUBLE，请将 empty_as_varchar 设置为 true。

SELECT * FROM read_xlsx('test_excel.xlsx', empty_as_varchar = true);

要完全禁用类型推断并将所有单元格视为 VARCHAR，请将 all_varchar 设置为 true。

SELECT * FROM read_xlsx('test_excel.xlsx', all_varchar = true);

此外，如果将 ignore_errors 参数设置为 true，DuckDB 将静默地将无法转换为相应推断列类型的单元格替换为 NULL。

SELECT * FROM read_xlsx('test_excel.xlsx', ignore_errors = true);

另请参阅

DuckDB 还可以导出 Excel 文件。有关 Excel 支持的更多详细信息，请参阅 Excel 扩展页面。