CREATE FILE FORMAT

Introduced or updated: v1.2.339

创建一个命名的文件格式。

语法

CREATE [ OR REPLACE ] FILE FORMAT [ IF NOT EXISTS ] <format_name> FileFormatOptions

关于 FileFormatOptions 的详细信息，请参考 输入 & 输出文件格式。

使用文件格式

创建一次，即可在查询和加载数据时重复使用该格式：

-- 1) 创建可复用的格式
CREATE OR REPLACE FILE FORMAT my_custom_csv TYPE = CSV FIELD_DELIMITER = '\t';

-- 2) 查询 Stage 中的文件（stage 表函数参数使用 =>）
SELECT * FROM @mystage/data.csv (FILE_FORMAT => 'my_custom_csv') LIMIT 10;

-- 3) 用 COPY INTO 导入文件（copy 选项使用 =）
COPY INTO my_table
FROM @mystage/data.csv
FILE_FORMAT = (FORMAT_NAME = 'my_custom_csv');

为什么有 => 与 = 的区别？Stage 表函数的参数使用键值写法 =>，而 COPY INTO 的选项采用常规的 = 赋值语法。

快速流程：使用同一格式进行创建、查询和加载

-- 创建可复用的格式
CREATE FILE FORMAT my_parquet TYPE = PARQUET;

-- 使用该格式查询 Stage 中的文件（Stage 表函数语法使用 =>）
SELECT * FROM @sales_stage/2024/order.parquet (FILE_FORMAT => 'my_parquet') LIMIT 10;

-- 使用 COPY INTO 加载 Stage 文件（LOAD 选项使用 =）
COPY INTO analytics.orders
FROM @sales_stage/2024/order.parquet
FILE_FORMAT = (FORMAT_NAME = 'my_parquet');