数据湖探索 DLI-导出查询结果:请求消息

时间:2024-09-27 11:19:12

请求消息

表2 请求参数

参数名称

是否必选

参数类型

说明

data_path

String

导出结果存储的路径(当前仅支持将数据存储在OBS上)。另外,该路径下的文件夹须不存在,如请求样例中的“path”文件夹。

compress

String

导出数据的压缩格式,目前支持gzip,bzip2和deflate压缩方式; 默认值为none,表示不压缩。

data_type

String

导出数据的存储格式,目前API支持csv和json格式。

queue_name

String

指定执行该任务的队列。若不指定队列,将采用default队列执行操作。

export_mode

String

导出模式,目前支持“ErrorIfExists”“Overwrite”,不指定“export_mode”则默认为“ErrorIfExists”

  • “ErrorIfExists”:存在即报错。指定的导出目录必须不存在,如果指定目录已经存在,系统将返回错误信息,无法执行导出操作。
  • “Overwrite”:覆盖。在指定目录下新建文件,会删除已有文件。

with_column_header

Boolean

导出csv和json格式数据时,是否导出列名。

  • 设置为“true”,表示导出列名。
  • 设置为“false”,表示不导出列名。
  • 若为空,默认为“false”。

limit_num

Integer

需要导出的数据数量,默认值为“0”,表示全部导出。

encoding_type

String

导出数据的编码格式。默认使用utf-8。

支持以下编码格式:

  • utf-8
  • gb2312
  • gbk

quote_char

String

用户自定义引用字符。

默认值: 英文双引号(")

仅在数据格式为csv格式时支持配置引用字符。

引用字符在导出作业结果时用于标识文本字段的开始和结束,即用于分割字段。

仅支持设置一个字符。

主要用于处理包含空格、特殊字符或与分隔符相同字符的数据。

escape_char

String

用户自定义转义字符。

默认值:英文反斜杠(\)

仅在数据格式为csv格式时支持配置转义字符。

在导出结果中如果需要包含特殊字符,如引号本身,可以使用转义字符(反斜杠 \ )来表示。

仅支持设置一个字符。

常用转义字符的场景:

  • 假设两个引用字符之间的数据内容存在第三个引用字符,则在第三个引用字符前加上转义字符,从而避免字段内容被分割。
  • 假设数据内容中原本就存在转义字符,则在这个原有的转义字符前再加一个转义字符,避免原来的那个字符起到转义作用。
support.huaweicloud.com/api-dli/dli_02_0024.html