跳到主要内容
版本: 最新版本-3.5

SHOW EXPORT

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

    指定要查询的数据库的名称。 如果未指定 FROM 子句，StarRocks 将查询当前数据库。

  • WHERE

    指定要用于筛选导出作业的条件。 查询结果集中仅返回符合指定条件的导出作业。

    参数必需描述
    QUERYID否要查询的导出作业的 ID。 此参数用于查询单个导出作业的执行信息。
    STATE否要查询的导出作业的状态。 有效值
    • PENDING：指定查询等待调度的导出作业。
    • EXPORTING：指定查询正在执行的导出作业。
    • FINISHED：指定查询已成功完成的导出作业。
    • CANCELLED：指定查询失败的导出作业。

  • ORDER BY

    指定要用于对查询结果集中的导出作业记录进行排序的字段的名称。 您可以指定多个字段，这些字段必须用逗号 (,) 分隔。 此外，您可以使用 ASC 或 DESC 关键字指定基于指定字段按升序或降序对导出作业记录进行排序。

  • LIMIT

    将查询的结果集限制为指定的行数上限。 有效值：正整数。 如果未指定 LIMIT 子句，StarRocks 将返回所有符合指定条件的导出作业。

返回结果​

例如，查询 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 个查询计划，其中三个已完成。 在这种情况下，导出作业的进度为 30%。

  • TaskInfo：导出作业的信息。

    该信息是一个 JSON 对象，由以下键组成

    • partitions：导出数据所在的分区。 如果返回通配符 (*) 作为此键的值，则运行导出作业以从所有分区导出数据。
    • column separator：导出数据文件中使用的列分隔符。
    • columns：导出数据的列的名称。
    • tablet num：导出的 tablet 的总数。
    • broker：在 v2.4 及更早版本中，此字段用于返回导出作业使用的 Broker 的名称。 从 v2.5 开始，此字段返回一个空字符串。
    • 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;