メインコンテンツまでスキップ
バージョン: Latest-3.4

SHOW MATERIALIZED VIEWS

説明​

すべてまたは特定の非同期マテリアライズドビューを表示します。

バージョン 3.0 以降、このステートメントの名前は SHOW MATERIALIZED VIEW から SHOW MATERIALIZED VIEWS に変更されました。

ヒント

この操作には特権は必要ありません。

構文​

SHOW MATERIALIZED VIEWS
[FROM db_name]
[
WHERE NAME { = "mv_name" | LIKE "mv_name_matcher"}
]
注記

バージョン 3.3 以降、SHOW MATERIALIZED VIEWS コマンドは、リフレッシュタスクが複数のパーティション/タスクランで構成されている場合、すべてのタスクランの状態を追跡します。すべてのタスクランが成功した場合にのみ、last_refresh_state は SUCCESS を返します。

パラメータ​

パラメータ必須説明
db_nameいいえマテリアライズドビューが存在するデータベースの名前。このパラメータが指定されていない場合、デフォルトで現在のデータベースが使用されます。
mv_nameいいえ表示するマテリアライズドビューの名前。
mv_name_matcherいいえマテリアライズドビューをフィルタリングするために使用されるマッチャー。

戻り値​

戻り値説明
idマテリアライズドビューのID。
database_nameマテリアライズドビューが存在するデータベースの名前。
nameマテリアライズドビューの名前。
refresh_typeマテリアライズドビューのリフレッシュタイプ。ROLLUP、MANUAL、ASYNC、INCREMENTAL などがあります。
is_activeマテリアライズドビューの状態がアクティブかどうか。 有効な値: true と false。
partition_typeマテリアライズドビューのパーティションタイプ。RANGE と UNPARTITIONED があります。
task_idマテリアライズドビューのリフレッシュタスクのID。
task_nameマテリアライズドビューのリフレッシュタスクの名前。
last_refresh_start_timeマテリアライズドビューの最後のリフレッシュの開始時間。
last_refresh_finished_timeマテリアライズドビューの最後のリフレッシュの終了時間。
last_refresh_duration最後のリフレッシュにかかった時間。単位: 秒。
last_refresh_state最後のリフレッシュのステータス。PENDING、RUNNING、FAILED、SUCCESS があります。
last_refresh_force_refresh最後のリフレッシュがFORCEリフレッシュかどうか。
last_refresh_start_partitionマテリアライズドビューの最後のリフレッシュの開始パーティション。
last_refresh_end_partitionマテリアライズドビューの最後のリフレッシュの終了パーティション。
last_refresh_base_refresh_partitions最後のリフレッシュで更新されたベーステーブルのパーティション。
last_refresh_mv_refresh_partitions最後のリフレッシュで更新されたマテリアライズドビューパーティション。
last_refresh_error_codeマテリアライズドビューの最後の失敗したリフレッシュのエラーコード（マテリアライズドビューの状態がアクティブでない場合）。
last_refresh_error_messageマテリアライズドビューの最後のリフレッシュが失敗した理由（マテリアライズドビューの状態がアクティブでない場合）。
rowsマテリアライズドビューのデータ行数。
textマテリアライズドビューを作成するために使用されたステートメント。

例​

以下の例は、このビジネスシナリオに基づいています:

-- テーブルを作成: customer
CREATE TABLE customer ( C_CUSTKEY     INTEGER NOT NULL,
                        C_NAME        VARCHAR(25) NOT NULL,
                        C_ADDRESS     VARCHAR(40) NOT NULL,
                        C_NATIONKEY   INTEGER NOT NULL,
                        C_PHONE       CHAR(15) NOT NULL,
                        C_ACCTBAL     double   NOT NULL,
                        C_MKTSEGMENT  CHAR(10) NOT NULL,
                        C_COMMENT     VARCHAR(117) NOT NULL,
                        PAD char(1) NOT NULL)
    ENGINE=OLAP
DUPLICATE KEY(`c_custkey`)
COMMENT "OLAP"
DISTRIBUTED BY HASH(`c_custkey`)
PROPERTIES (
"replication_num" = "3",
"storage_format" = "DEFAULT"
);

-- マテリアライズドビューを作成: customer_mv
CREATE MATERIALIZED VIEW customer_mv
DISTRIBUTED BY HASH(c_custkey)
REFRESH MANUAL
PROPERTIES (
    "replication_num" = "3"
)
AS SELECT
              c_custkey, c_phone, c_acctbal, count(1) as c_count, sum(c_acctbal) as c_sum
   FROM
              customer
   GROUP BY c_custkey, c_phone, c_acctbal;

-- マテリアライズドビューをリフレッシュ
REFRESH MATERIALIZED VIEW customer_mv;

例 1: 特定のマテリアライズドビューを表示します。

mysql> SHOW MATERIALIZED VIEWS WHERE NAME='customer_mv'\G
*************************** 1. row ***************************
                        id: 10142
                      name: customer_mv
             database_name: test
              refresh_type: MANUAL
                 is_active: true
   last_refresh_start_time: 2023-02-17 10:27:33
last_refresh_finished_time: 2023-02-17 10:27:33
     last_refresh_duration: 0
        last_refresh_state: SUCCESS
             inactive_code: 0
           inactive_reason:
                      text: CREATE MATERIALIZED VIEW `customer_mv`
COMMENT "MATERIALIZED_VIEW"
DISTRIBUTED BY HASH(`c_custkey`)
REFRESH MANUAL
PROPERTIES (
"replication_num" = "3",
"storage_medium" = "HDD"
)
AS SELECT `customer`.`c_custkey`, `customer`.`c_phone`, `customer`.`c_acctbal`, count(1) AS `c_count`, sum(`customer`.`c_acctbal`) AS `c_sum`
FROM `test`.`customer`
GROUP BY `customer`.`c_custkey`, `customer`.`c_phone`, `customer`.`c_acctbal`;
                      rows: 0
1 row in set (0.11 sec)

例 2: 名前をマッチングしてマテリアライズドビューを表示します。

mysql> SHOW MATERIALIZED VIEWS WHERE NAME LIKE 'customer_mv'\G
*************************** 1. row ***************************
                        id: 10142
                      name: customer_mv
             database_name: test
              refresh_type: MANUAL
                 is_active: true
   last_refresh_start_time: 2023-02-17 10:27:33
last_refresh_finished_time: 2023-02-17 10:27:33
     last_refresh_duration: 0
        last_refresh_state: SUCCESS
             inactive_code: 0
           inactive_reason:
                      text: CREATE MATERIALIZED VIEW `customer_mv`
COMMENT "MATERIALIZED_VIEW"
DISTRIBUTED BY HASH(`c_custkey`)
REFRESH MANUAL
PROPERTIES (
"replication_num" = "3",
"storage_medium" = "HDD"
)
AS SELECT `customer`.`c_custkey`, `customer`.`c_phone`, `customer`.`c_acctbal`, count(1) AS `c_count`, sum(`customer`.`c_acctbal`) AS `c_sum`
FROM `test`.`customer`
GROUP BY `customer`.`c_custkey`, `customer`.`c_phone`, `customer`.`c_acctbal`;
                      rows: 0
1 row in set (0.12 sec)