跳到主要内容
跳到主要内容

INTO OUTFILE 子句

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

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

语法

file_nametype 是字符串字面量。支持的压缩类型有:'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,则输出将附加到现有文件。如果使用压缩,则无法使用附加。
  • 当写入已存在的文件时,必须使用 APPENDTRUNCATE

示例

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

结果: