跳到主要内容
版本：Stable-3.1

SHOW EXPORT

功能​

查询符合指定条件的导出作业的执行情况。

语法​

SHOW EXPORT
[ FROM <db_name> ]
[
WHERE
    [ QUERYID = <query_id> ]
    [ STATE = { "PENDING" | "EXPORTING" | "FINISHED" | "CANCELLED" } ]
]
[ ORDER BY <field_name> [ ASC | DESC ] [, ... ] ]
[ LIMIT <count> ]

参数说明​

该语句包含四个可选子句：

  • FROM

    指定要查询的数据库的名称。如果不指定该子句，则默认查询当前数据库。

  • WHERE

    指定过滤条件。只有符合过滤条件的导入作业记录才会作为查询结果返回。

    参数是否必选说明
    QUERYID否导出作业的 ID。该参数用于查询单个导出作业的执行情况。
    STATE否导出作业的状态。取值范围：
    • PENDING：表示查询待调度的导出作业。
    • EXPORTING：表示查询正在执行中的导出作业。
    • FINISHED：表示查询成功完成的导出作业。
    • CANCELLED：表示查询失败的导出作业。

  • ORDER BY

    指定用于对返回的导出作业记录进行排序的字段的名称。支持指定多个字段，多个字段之间必须用逗号 (,) 分隔。另外，您还可以在字段后通过添加 ASC 或 DESC 关键字来指定按该字段对返回的导出作业记录进行升序或降序排序。

  • LIMIT

    指定允许返回的导出作业记录最大数量。取值范围：正整数。如果不指定该子句，则默认返回符合指定条件的所有导出作业。

返回结果说明​

例如查看一个 ID 为 edee47f0-abe1-11ec-b9d1-00163e1e238f 的导出作业的执行情况：

SHOW EXPORT
WHERE QUERYID = "edee47f0-abe1-11ec-b9d1-00163e1e238f";

返回结果如下：

     JobId: 14008
   QueryId: edee47f0-abe1-11ec-b9d1-00163e1e238f
     State: FINISHED
  Progress: 100%
  TaskInfo: {"partitions":["*"],"column separator":"\t","columns":["*"],"tablet num":10,"broker":"","coord num":1,"db":"db0","tbl":"tbl_simple","row delimiter":"\n","mem limit":2147483648}
      Path: hdfs://127.0.0.1:9000/users/230320/
CreateTime: 2023-03-20 11:16:14
 StartTime: 2023-03-20 11:16:17
FinishTime: 2023-03-20 11:16:26
   Timeout: 7200

返回结果中的参数说明如下：

  • JobId：导出作业的 ID。
  • QueryId：当前查询的 ID。
  • State：导出作业的状态，包括：
    • PENDING：导出作业待调度。
    • EXPORTING：导出作业正在执行中。
    • FINISHED：导出作业成功。
    • CANCELLED：导出作业失败。
  • Progress：导出作业的进度。该进度以查询计划为单位。假设导出作业一共分为 10 个查询计划，当前已完成 3 个，则进度为 30%。有关查询计划的原理，参见“使用 EXPORT 导出数据 > 导出流程”。
  • TaskInfo：导出作业的信息，格式为 JSON，包括：
    • partitions：导出数据所在的分区。通配符 (*) 表示导出了所有分区的数据。
    • column separator：导出文件的列分隔符。
    • columns：导出的列的名称。
    • tablet num：导出的 Tablet 总数量。
    • broker：在 v2.4 及以前版本，该字段用于返回导出作业使用的 Broker 的名称。自 v2.5 起，该字段返回一个空字符串。具体原因请参见“使用 EXPORT 导出数据 > 背景信息”。
    • coord num：导出作业拆分的查询计划的个数。
    • db：导出数据所在的数据库的名称。
    • tbl：导出数据所在的表的名称。
    • row delimiter：导出文件的行分隔符。
    • mem limit：导出作业的内存使用限制。单位是字节。
  • Path：远端存储上的导出路径。
  • CreateTime：导出作业的创建时间。
  • StartTime：导出作业开始调度的时间。
  • FinishTime：导出作业的结束时间。
  • Timeout：导出作业的超时时间。单位是秒。该时间从 CreateTime 开始计算。
  • ErrorMsg：导出作业的错误原因。该字段仅当导出作业出现错误时才会返回。

示例​

  • 查询当前数据库下所有导出作业：

    SHOW EXPORT;

  • 查询指定数据库 example_db 下 ID 为 921d8f80-7c9d-11eb-9342-acde48001122 的导出作业：

    SHOW EXPORT FROM example_db
    WHERE queryid = "921d8f80-7c9d-11eb-9342-acde48001122";

  • 查询指定数据库 example_db 下状态为 EXPORTING 的导出作业，并按 StartTime 对返回的导出作业记录进行升序排序：

    SHOW EXPORT FROM example_db
    WHERE STATE = "exporting"
    ORDER BY StartTime ASC;

  • 查询指定数据库 example_db 下所有导出作业，并按 StartTime 对返回的导出作业记录进行降序排序：

    SHOW EXPORT FROM example_db
    ORDER BY StartTime DESC;