MemFireDB SQL语法 - COPY语句

COPY

概要

使用COPY语句在表和文件之间传输数据。COPY TO将数据从表复制到文件。COPY FROM将数据从文件复制到表。COPY输出已复制的行数。

语法

copy_from ::= COPY table_name [ ( column_name [ , ... ]  ) ] FROM                {  'filename' | PROGRAM 'command' | STDIN }                [ [  WITH ] ( option [ , ... ] ) ]                copy_to ::= COPY { table_name [ ( column_names ) ] | (  query ) } TO                {  'filename' | PROGRAM 'command' | STDOUT }                [ [  WITH ] ( option [ , ... ] ) ]                copy_option ::= FORMAT format_name                  |  OIDS [ boolean ]                  |  FREEZE [ boolean ]                  |  DELIMITER 'delimiter_character'                  |  NULL 'null_string'                  |  HEADER [ boolean ]                  |  QUOTE 'quote_character'                  |  ESCAPE 'escape_character'                  |  FORCE_QUOTE { ( column_names ) | * }                  |  FORCE_NOT_NULL ( column_names )                  |  FORCE_NULL ( column_names )                  |  ENCODING 'encoding_name'

语义

table_name 指定要复制的表（可以选择模式限定的表）。

column_name 指定要复制的列的列表。如果未指定，则将复制表的所有列。

query 指定SELECT，VALUES，INSERT，UPDATE，或DELETE语句，它的结果将被复制。对于INSERT，UPDATE和DELETE语句，必须提供RETURNING子句。

filename 指定要复制的文件的路径。输入文件名可以是绝对路径或相对路径，但输出文件名必须是绝对路径。

例子

• 如果表不存在，则会引发错误。
• COPY TO 只能与常规表一起使用。
• COPY FROM 可以与表，外部表或视图一起使用。