云数据库 GaussDB-LOAD DATA:参数说明

时间:2025-01-26 10:48:21

参数说明

  • LOCAL

    指定导入文件的位置。

    不指定LOCAL时,若file_name为相对路径,则默认导入路径为数据目录。

    若指定LOCAL参数则需要指定file_name为绝对路径,当指定为相对路径时默认导入路径为数据库二进制所在路径,即$GAUSSHOME/bin/。

    当导入数据与表中数据冲突或文件中字段数小于指定表中字段数时,指定LOCAL与指定IGNORE作用一致。

  • REPLACE | IGNORE

    当导入数据与表中原有数据冲突时,若指定REPLACE,则替换冲突行数据;若指定IGNORE,则跳过冲突行数据,继续导入。若数据冲突但不指定REPLACE、IGNORE或LOCAL中任意一个,则终止导入并报错。

    若文件字段数小于指定表列数,指定LOCAL或IGNORE参数会为剩余列赋默认值。不指定IGNORE或LOCAL参数会报错。

  • PARTITION

    当导入表为分区表时,此参数用来指定分区。若数据与指定分区范围不一致,则报错。

  • CHARACTER SET

    指定数据文件的编码格式名称,缺省为当前客户端编码格式。

  • FIELDS | COLUMNS
    • TERMINATED BY

      指定两列之间分隔符,缺省为“\t”。

      指定换行符不能与分隔符相同。

    • [OPTIONALLY] ENCLOSED BY

      指定引号字符,缺省为''。

      OPTIONALLY参数为可选参数,无实际作用。

      引号符仅支持单字符,不支持字符串。

    • ESCAPED BY

      指定转义符,缺省为“\”。

      转义字符仅支持单字符,不支持字符串。

  • LINES
    • STARTING BY

      指定导入数据文件起始字段样式。

    • TERMINATED BY

      指定导入数据文件换行符样式。

  • IGNORE

    指定数据导入时,跳过数据文件的前number行。

  • col_name_or_user_var

    可选的待复制字段列表。

    取值范围:如果没有声明字段列表,将使用所有字段。

    • 指定列参数不支持重复指定列。
    • LOAD DATA语法指定列时,col_name_or_user_var仅支持指定为表中存在列,不支持指定为用户变量。
  • SET

    指定列值,可以指定为表达式或DEFAULT。

    • 表达式中不支持列名。
    • 若表达式结果类型与被赋值列对应类型之间不存在隐式转换函数则报错。
support.huaweicloud.com/distributed-devg-v8-gaussdb/gaussdb-12-0645.html