SHOW ALTER TABLE MATERIALIZED VIEW

Name

Description

该命令用于查看通过 CREATE-MATERIALIZED-VIEW 语句提交的创建物化视图作业的执行情况。

该语句等同于 SHOW ALTER TABLE ROLLUP;

SHOW ALTER TABLE MATERIALIZED VIEW
[FROM database]
[WHERE]
[ORDER BY]
[LIMIT OFFSET]

database：查看指定数据库下的作业。如不指定，使用当前数据库。
WHERE：可以对结果列进行筛选，目前仅支持对以下列进行筛选：
- TableName：仅支持等值筛选。
- State：仅支持等值筛选。
- Createtime/FinishTime：支持 =，>=，<=，>，<，!=
ORDER BY：可以对结果集按任意列进行排序。
LIMIT：配合 ORDER BY 进行翻页查询。

返回结果说明：

mysql> show alter table materialized view\G
*************************** 1. row ***************************
          JobId: 11001
      TableName: tbl1
     CreateTime: 2020-12-23 10:41:00
     FinishTime: NULL
  BaseIndexName: tbl1
RollupIndexName: r1
       RollupId: 11002
  TransactionId: 5070
          State: WAITING_TXN
            Msg:
       Progress: NULL
        Timeout: 86400
1 row in set (0.00 sec)

JobId：作业唯一 ID。
TableName：基表名称
CreateTime/FinishTime：作业创建时间和结束时间。
BaseIndexName/RollupIndexName：基表名称和物化视图名称。
RollupId：物化视图的唯一 ID。
TransactionId：见 State 字段说明。
State：作业状态。
- PENDING：作业准备中。
- WAITING_TXN：
  
  在正式开始产生物化视图数据前，会等待当前这个表上的正在运行的导入事务完成。而 TransactionId 字段就是当前正在等待的事务 ID。当这个 ID 之前的导入都完成后，就会实际开始作业。
- RUNNING：作业运行中。
- FINISHED：作业运行成功。
- CANCELLED：作业运行失败。
Msg：错误信息
Progress：作业进度。这里的进度表示 已完成的tablet数量/总tablet数量。创建物化视图是按 tablet 粒度进行的。
Timeout：作业超时时间，单位秒。

Example

查看数据库 example_db 下的物化视图作业

SHOW ALTER TABLE MATERIALIZED VIEW FROM example_db;

Keywords

SHOW, ALTER, TABLE, MATERIALIZED, VIEW

Best Practice

UNINSTALL-PLUGIN SHOW-ALTER