メインコンテンツまでスキップ

REFRESH MATERIALIZED VIEW

MATERIALIZED VIEWのリフレッシュ

説明

特定の非同期マテリアライズドビューまたはパーティションを手動でリフレッシュします。

注意

ASYNCまたはMANUALのリフレッシュ戦略を採用しているマテリアライズドビューのみを手動でリフレッシュできます。非同期マテリアライズドビューのリフレッシュ戦略はSHOW MATERIALIZED VIEWSを使用して確認できます。

構文

REFRESH MATERIALIZED VIEW [データベース.]mv_name
[PARTITION START ("<partition_start_date>") END ("<partition_end_date>")]
[FORCE]
[WITH { SYNC | ASYNC } MODE]

パラメータ

パラメータ

必須

説明

mv_name

yes

手動でリフレッシュするマテリアライズドビューの名前。

PARTITION START () END ()

no

特定の時間間隔内のパーティションを手動でリフレッシュします。

partition_start_date

no

手動でリフレッシュするパーティションの開始日。

partition_end_date

no

手動でリフレッシュするパーティションの終了日。

FORCE

no

このパラメータを指定すると、StarRocksは対応するマテリアライズドビューまたはパーティションを強制的にリフレッシュします。このパラメータを指定しない場合、StarRocksはデータが更新されたかどうかを自動的に判断し、必要な場合にのみパーティションをリフレッシュします。

WITH ... MODE

no

リフレッシュタスクを同期的または非同期的に呼び出します。SYNCは、リフレッシュタスクを同期的に呼び出し、StarRocksはタスクが成功または失敗した場合にのみタスクの結果を返します。ASYNCは、リフレッシュタスクを非同期的に呼び出し、StarRocksはタスクが送信された後すぐに成功を返し、タスクは非同期にバックグラウンドで実行されます。非同期マテリアライズドビューのリフレッシュタスクの実行状況は、StarRocksのInformation Schemaのtasksおよびtask_runsメタデータテーブルをクエリして確認できます。詳細については、 非同期マテリアライズドビューの実行状況を確認する を参照してください。デフォルト値:ASYNC。v3.1.0以降でサポートされています。

注意

外部カタログに基づいて作成されたマテリアライズドビューをリフレッシュすると、StarRocksはマテリアライズドビューのすべてのパーティションをリフレッシュします。

例1:非同期呼び出しを使用して特定のマテリアライズドビューを手動でリフレッシュします。

REFRESH MATERIALIZED VIEW lo_mv1;

REFRESH MATERIALIZED VIEW lo_mv1 WITH ASYNC MODE;

例2:特定のマテリアライズドビューの一部のパーティションを手動でリフレッシュします。

REFRESH MATERIALIZED VIEW lo_mv1 
PARTITION START ("2020-02-01") END ("2020-03-01");

例3:特定のマテリアライズドビューの一部のパーティションを強制的にリフレッシュします。

REFRESH MATERIALIZED VIEW lo_mv1
PARTITION START ("2020-02-01") END ("2020-03-01") FORCE;

例4:同期呼び出しを使用してマテリアライズドビューを手動でリフレッシュします。

REFRESH MATERIALIZED VIEW lo_mv1 WITH SYNC MODE;