SHOW MATERIALIZED VIEWS

概要

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

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

構文

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

角かっこ[]内のパラメータはオプションです。

パラメータ

パラメータ	必須	説明
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	マテリアライズドビューを作成するために使用されるステートメントです。

例

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

-- Create Table: 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" = "1",
"storage_format" = "DEFAULT"
);

-- Create MV: customer_mv
CREATE MATERIALIZED VIEW customer_mv
DISTRIBUTED BY HASH(c_custkey)
REFRESH MANUAL
PROPERTIES (
    "replication_num" = "1"
)
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 the MV
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" = "1",
"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" = "1",
"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)

SHOW MATERIALIZED VIEWS

概要​

構文​

パラメータ​

戻り値​

例​

概要

構文

パラメータ

戻り値

例