SHOW LOAD
功能
查看数据库中指定导入作业的相关信息,包括 Broker Load、INSERT 和 Spark Load。您还可以使用 curl
命令查看这些导入作业的相关信息。注意,从 3.1 版本起,对于 Broker Load 和 Insert 导入,推荐您通过 SELECT 语句从 information_schema
数据库中的 loads
表来查看作业结果。详请参见从 HDFS 导入、从云存储导入、通过 INSERT 语句导入数据和使用 Apache Spark™ 批量导入。
除了以上三种导入方式, StarRocks 还支持 Stream Load 和 Routine Load,其中 Stream Load 是同步操作,会直接返回结果,不会通过 SHOW LOAD 展示。Routine Load 可通过 SHOW ROUTINE LOAD 查看导入作业的相关信息。
语法
SHOW LOAD [ FROM db_name ]
[
WHERE [ LABEL { = "label_name" | LIKE "label_matcher" } ]
[ [AND] STATE = { "PENDING" | "ETL" | "LOADING" | "FINISHED" | "CANCELLED" } ]
]
[ ORDER BY field_name [ ASC | DESC ] ]
[ LIMIT { [offset, ] limit | limit OFFSET offset } ]
说明
返回结果中的字段较多,可使用
\G
分行,如SHOW LOAD WHERE LABEL = "label1"\G
。详情参见示例一。
参数说明
参数 | 必选 | 说明 |
---|---|---|
db_name | 否 | 数据库名称。如不指定该参数,则默认查看当前数据库的导入作业。 |
LABEL = "label_name" | 否 | 导入作业标签。 |
LABEL LIKE "label_matcher" | 否 | 查看标签中包含 label_matcher 的导入作业。 |
AND | 否 |
|
STATE | 否 | 导入作业的状态。不同的导入方式有不同的导入作业状态,具体如下:
STATE 参数,则默认显示所有状态的导入作业;如指定,则显示指定状态的导入作业。例如 STATE = "PENDING" 会显示状态为 PENDING 的导入作业。 |
ORDER BY field_name [ASC | DESC] | 否 | 将返回结果按照指定字段升序或降序排列,当前支持的排序字段(field_name)包括 JobId 、Label 、State 、Progress 、Type 、EtlInfo 、TaskInfo 、ErrorMsg 、CreateTime 、EtlStartTime 、EtlFinishTime 、LoadStartTime 、LoadFinishTime 、URL 和 JobDetails 。
JobId 升序排列。 |
LIMIT limit | 否 | 查看指定数量的作业。如不指定该参数,则默认显示所有符合筛选条件的作业;如指定,则 显示指定数量的作业。例如 LIMIT 10 会显示 10 个符合筛选条件的作业。 |
OFFSET offset | 否 | offset 定义了返回结果中跳过的导入作业的数量,其默认值为 0。例如 OFFSET 5 表示跳过前 5 个导入作业,返回剩下的结果。 |
返回结果说明
+-------+-------+-------+----------+------+---------+----------+----------+------------+--------------+---------------+---------------+----------------+-----+------------+
| JobId | Label | State | Progress | Type | Priority | EtlInfo | TaskInfo | ErrorMsg | CreateTime | EtlStartTime | EtlFinishTime | LoadStartTime | LoadFinishTime | URL | JobDetails |
+-------+-------+-------+----------+------+---------+----------+----------+------------+--------------+---------------+---------------+----------------+-----+------------+
导入方式不同,返回结果中的字段取值也有差异,具体如下。
字段 | Broker Load | Spark Load | INSERT |
---|---|---|---|
JobId | 导入作业的全局唯一 ID,由 StarRocks 自动生成。 | 同 Broker Load。 | 同 Broker Load。 |
Label | 导入作业的标签。每个数据库中的导入作业都一个唯一的标签,不同数据库的导入作业标签可以重复。 | 同 Broker Load。 | 同 Broker Load。 |
State | 导入作业的状态,包括:
| 导入作业的状态,包括:
| 导入作业的状态,包括:
|
Progress |