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 | 导入作业所处的阶段。Broker Load 导入作业只有 LOAD 阶段,对应导入作业状态中的 LOADING 。 LOAD 进度为 0~100%。Broker Load 没有 ETL 阶段,所以 ETL 对应的取值并无实际意义。说明:
| 导入作业所处的阶段。Spark Load 导入作业,包括 ETL 和 LOAD 两种阶段,分别对应导入作业状态中的 ETL 和 LOADING 。 ETL 和 LOAD 进度均为 0~100%。说明同 Broker Load。 | 导入作业所处的阶段。INSERT 导入作业只有 LOAD 阶段,没有 ETL 阶段,所以 ETL 对应的取值并无实际意义。LOAD 进度为 0~100%。说明同 Broker Load。 |
Type | 导入方式,取值为 BROKER 。 | 导入方式,取值为 SPARK 。 | 导入方式, 取值为 INSERT 。 |
Priority | 导入作业的执行优先级,包括:LOWEST、LOW、NORMAL、HIGH 和 HIGHEST。 | - | - |
EtlInfo | ETL 信息,包括以下 3 个指标:
max-filter-ratio ,计算公式为:dpp.abnorm.ALL /(unselected.rows + dpp.abnorm.ALL + dpp.norm.ALL )。 | 同 Broker Load。 | ETL 信息。由于 INSERT 没有 ETL 阶段,所以该参数值为 NULL 。 |
TaskInfo | 创建导入作业时指定的参数,包括:
|