INTO OUTFILE 子句

INTO OUTFILE 子句将 SELECT 查询的结果重定向到 客户端 侧的文件中。

支持压缩文件。压缩类型通过文件名的扩展名检测（默认使用模式 'auto'）。或者也可以在 COMPRESSION 子句中明确指定。可以在 LEVEL 子句中指定某种压缩类型的压缩级别。

语法

file_name 和 type 是字符串字面量。支持的压缩类型有：'none'、'gzip'、'deflate'、'br'、'xz'、'zstd'、'lz4'、'bz2'。

level 是数字字面量。支持的正整数范围为：1-12 对于 lz4 类型，1-22 对于 zstd 类型，以及 1-9 对于其他压缩类型。

实现细节

• 此功能在 命令行客户端 和 clickhouse-local 中可用。因此，通过 HTTP 接口 发送的查询将会失败。
• 如果已有相同文件名的文件存在，查询将会失败。
• 默认的 输出格式 为 TabSeparated（像在命令行客户端批处理模式中一样）。使用 FORMAT 子句可更改输出格式。
• 如果查询中提到 AND STDOUT，则写入文件的输出也会显示在标准输出上。如果使用压缩，则明文将显示在标准输出上。
• 如果查询中提到 APPEND，则输出将附加到现有文件中。如果使用压缩，则无法使用附加。
• 在写入已存在的文件时，必须使用 APPEND 或 TRUNCATE。

示例

使用 命令行客户端 执行以下查询：

结果：