SELECT INTO

Syntax

SelectIntoStmt
						::= SelectStmt 'INTO' 'OUTFILE' filePath SelectIntoOptionList
						
filePath ::= string_literal
SelectIntoOptionList
									::= 'OPTIONS' '(' SelectInfoOptionItem (',' SelectInfoOptionItem)* ')'

SelectInfoOptionItem
									::= 'DELIMITER' '=' string_literal
											|'HEADER' '=' bool_literal
											|'NULL_VALUE' '=' string_literal
											|'FORMAT' '=' string_literal
											|'MODE' '=' string_literal

SELECT INTO OUTFILE语句用户将表的查询结果导出为一个文件。 LOAD DATA INFILE 语句与SELECT INTO OUTFILE互补，它用于从指定文件创建表以及加载数据到表中。SELECT INTO OUTFILE分为三个部分。

• 第一部分是一个普通的SELECT语句，通过这个SELECT语句来查询所需要的数据；

• 第二部分是filePath，定义将查询的记录导出到哪个文件中；

• 第三部分是SelectIntoOptionList为可选选项，其可能的取值有：

配置项	类型	默认值	描述
delimiter	String	,	列分隔符，默认为,
header	Boolean	true	是否包含表头, 默认为true
null_value	String	null	NULL填充值，默认填充"null"
format	String	csv	输出文件格式，默认为csv。请补充一下其他的可选格式。
mode	String	error_if_exists	输出模式: error_if_exists: 表示若文件已经在则报错。 overwrite: 表示若文件已存在，数据将覆盖原文件内容。 append：表示若文件已存在，数据将追加到原文件后面。 不显示配置时，默认mode为error_if_exists。
quote	String	“”	输出数据的包围字符串，字符串长度<=1。默认为””，表示输出数据包围字符串为空。当配置包围字符串时，将使用包围字符串包围一个field。例如，我们配置包围字符串为"#"，原始数据为{1 1.0, This is a string, with comma}。输出的文本为#1#, #1.0#, #This is a string, with comma#。请注意，目前OpenMLDB还不支持quote字符的转义，所以，用户需要谨慎选择quote字符，保证原始字符串内并不包含quote字符。

LOAD DATA INFILE 语句与SELECT INTO OUTFILE互补，它用户从指定文件创建表以及加载数据到表中。

SQL语句模版

SELECT ... INTO OUTFILE 'file_path' OPTIONS (key = value, ...)

Examples

• 从表t1查询输出到data.csv文件中，使用,作为列分隔符

SELECT col1, col2, col3 FROM t1 INTO OUTFILE 'data.csv' OPTIONS ( delimit = ',' );

• 从表t1查询输出到data.csv文件中，使用｜作为列分隔符，NULL值的填充值为NA字符串：

SELECT col1, col2, col3 FROM t1 INTO OUTFILE 'data2.csv' OPTIONS ( delimit = '|', null_value='NA');