excel 扩展通过封装 i18npool 库提供根据 Excel 格式规则格式化数字的功能，并支持读取/写入 Excel (.xlsx) 文件。但请注意，不支持 .xls 文件。

提示：此前，读取和写入 Excel 文件是通过 spatial 扩展处理的，该扩展恰好通过其依赖项之一包含了对 XLSX 文件的支持，但此功能可能会从 spatial 扩展中移除。此外，excel 扩展更高效，并能提供对导入/导出过程的更好控制。如果 excel 扩展无法满足您的用例，请尝试使用 spatial 扩展。有关说明，请参阅 Excel 导入和 Excel 导出页面。不过，请注意这些功能在未来可能会被弃用。

安装和加载

excel 扩展会在首次使用时从官方扩展仓库中自动加载。如果您想手动安装并加载它，请运行

INSTALL excel;
LOAD excel;

Excel 标量函数

示例

SELECT excel_text(1_234_567.897, 'h:mm AM/PM') AS timestamp;

SELECT excel_text(1_234_567.897, 'h AM/PM') AS timestamp;

读取 XLSX 文件

读取 .xlsx 文件非常简单，只需直接对其执行 SELECT 操作即可，例如：

SELECT *
FROM 'test.xlsx';

但是，如果您想设置额外的选项来控制导入过程，可以使用 read_xlsx 函数。支持以下命名参数：

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

或者，可以使用带有 XLSX 格式选项的 COPY 语句将 Excel 文件导入现有表，在这种情况下，目标表中的列类型将用于强制转换 Excel 文件中单元格的类型。

CREATE TABLE test (a DOUBLE, b DOUBLE);
COPY test FROM 'test.xlsx' WITH (FORMAT xlsx, HEADER);
SELECT * FROM test;

类型和范围推断

由于 Excel 本身只在单元格中存储数字或字符串，并且不强制要求列中的所有单元格都具有相同的类型，因此 excel 扩展在导入 Excel 工作表时必须进行一些猜测来“推断”并决定列的类型。虽然几乎所有列都被推断为 DOUBLE 或 VARCHAR，但仍有一些注意事项：

• TIMESTAMP、TIME、DATE 和 BOOLEAN 类型是在可能的情况下，根据应用于单元格的格式进行推断的。
• 包含 TRUE 和 FALSE 的文本单元格被推断为 BOOLEAN。
• 默认情况下，空单元格被视为 DOUBLE，除非将 empty_as_varchar 选项设置为 true，在这种情况下它们被键入为 VARCHAR。

如果将 all_varchar 选项设置为 true，则上述所有规则均不适用，所有单元格都将读取为 VARCHAR。

当未明确指定类型时（例如，使用 read_xlsx 函数而不是 COPY TO ... FROM 'file.xlsx'），结果列的类型将基于工作表中的第一行“数据行”进行推断，即：

• 如果未提供明确范围
  • 如果发现标题或通过 header 选项强制指定，则为标题后的第一行
  • 如果没有发现标题或强制指定，则为工作表中的第一个非空行
• 如果提供了明确范围
  • 如果第一行发现标题或通过 header 选项强制指定，则为范围的第二行
  • 如果没有发现标题或强制指定，则为范围的第一行

如果第一个“数据行”不能代表工作表的其余部分（例如，它包含空单元格），这有时会导致问题，在这种情况下，可以使用 ignore_errors 或 empty_as_varchar 选项来解决此问题。

但是，当使用 COPY TO ... FROM 'file.xlsx' 语法时，不会进行任何类型推断，结果列的类型由正在复制到的表中的列类型确定。所有单元格只需通过从 DOUBLE 或 VARCHAR 转换为目标列类型来进行转换。

写入 XLSX 文件

支持使用带有 XLSX 格式的 COPY 语句来写入 .xlsx 文件。支持以下附加参数：

警告：许多工具仅支持工作表中最多 1,048,576 行，因此增加 sheet_row_limit 可能会导致生成的其他软件无法读取该文件。

这些作为选项传递给 FORMAT 之后的 COPY 语句，例如：

CREATE TABLE test AS
    SELECT *
    FROM (VALUES (1, 2), (3, 4)) AS t(a, b);
COPY test TO 'test.xlsx' WITH (FORMAT xlsx, HEADER true);

类型转换

由于 XLSX 文件实际上只支持存储数字或字符串（相当于 VARCHAR 和 DOUBLE），因此在写入 XLSX 文件时会应用以下类型转换：

• 写入 XLSX 文件时，数值类型被转换为 DOUBLE。
• 时间类型（TIMESTAMP、DATE、TIME 等）被转换为 Excel“序列号”，即日期为自 1900-01-01 以来的天数，时间为一天的分数。然后将它们应用“数字格式”，以便在 Excel 中打开时显示为日期或时间。
• TIMESTAMP_TZ 和 TIME_TZ 分别转换为 UTC TIMESTAMP 和 TIME，时区信息会丢失。
• BOOLEAN 被转换为 1 和 0，并应用“数字格式”使其在 Excel 中显示为 TRUE 和 FALSE。
• 所有其他类型都被转换为 VARCHAR，然后作为文本单元格写入。