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

ALTER MATERIALIZED VIEW

説明​

このSQL文は以下の操作が可能です:

  • 非同期マテリアライズドビューの名前を変更する。

  • 非同期マテリアライズドビューのリフレッシュ戦略を変更する。

  • 非同期マテリアライズドビューのステータスをアクティブまたは非アクティブに変更する。

  • 2つの非同期マテリアライズドビュー間でのアトミックスワップを実行する。

  • 非同期マテリアライズドビューのプロパティを変更する。

    このSQL文を使用して以下のプロパティを変更できます:

    • partition_ttl_number
    • partition_refresh_number
    • resource_group
    • auto_refresh_partitions_limit
    • excluded_trigger_tables
    • mv_rewrite_staleness_second
    • unique_constraints
    • foreign_key_constraints
    • colocate_with
    • すべてのセッション変数関連のプロパティ。セッション変数については、 System variables を参照してください。
ヒント
  • この操作にはターゲットのマテリアライズドビューに対するALTER権限が必要です。 GRANT の指示に従ってこの権限を付与できます。
  • ALTER MATERIALIZED VIEWは、マテリアライズドビューを構築するために使用されるクエリ文を直接変更することをサポートしていません。新しいマテリアライズドビューを構築し、ALTER MATERIALIZED VIEW SWAP WITHを使用して元のビューと交換できます。

構文​

ALTER MATERIALIZED VIEW [db_name.]<mv_name> 
    { RENAME [db_name.]<new_mv_name> 
    | REFRESH <new_refresh_scheme_desc> 
    | ACTIVE | INACTIVE 
    | SWAP WITH [db_name.]<mv2_name>
    | SET ( "<key>" = "<value>"[,...]) }

角括弧 [] 内のパラメータはオプションです。

パラメータ​

パラメータ必須説明
mv_nameyes変更するマテリアライズドビューの名前。
new_refresh_scheme_descno新しいリフレッシュ戦略、詳細は SQL Reference - CREATE MATERIALIZED VIEW - Parameters を参照してください。
new_mv_namenoマテリアライズドビューの新しい名前。
ACTIVEnoマテリアライズドビューのステータスをアクティブに設定します。StarRocksは、ベーステーブルが変更された場合（例えば、削除され再作成された場合）、元のメタデータが変更されたベーステーブルと一致しない状況を防ぐために、マテリアライズドビューを自動的に非アクティブに設定します。非アクティブなマテリアライズドビューはクエリアクセラレーションやクエリの書き換えに使用できません。ベーステーブルを変更した後、このSQLを使用してマテリアライズドビューをアクティブ化できます。
INACTIVEnoマテリアライズドビューのステータスを非アクティブに設定します。非アクティブな非同期マテリアライズドビューはリフレッシュできませんが、テーブルとしてクエリすることは可能です。
SWAP WITHno必要な一貫性チェックの後、他の非同期マテリアライズドビューとアトミック交換を実行します。
keyno変更するプロパティの名前、詳細は SQL Reference - CREATE MATERIALIZED VIEW - Parameters を参照してください。
注意
マテリアライズドビューのセッション変数関連のプロパティを変更する場合、プロパティに session. プレフィックスを追加する必要があります。例えば、session.query_timeout のようにします。非セッションプロパティにはプレフィックスを指定する必要はありません。例えば、mv_rewrite_staleness_second のようにします。
valueno変更するプロパティの値。

例​

例1: マテリアライズドビューの名前を変更します。

ALTER MATERIALIZED VIEW lo_mv1 RENAME lo_mv1_new_name;

例2: マテリアライズドビューのリフレッシュ間隔を変更します。

ALTER MATERIALIZED VIEW lo_mv2 REFRESH ASYNC EVERY(INTERVAL 1 DAY);

例3: マテリアライズドビューのプロパティを変更します。

-- mv1のquery_timeoutを40000秒に変更します。
ALTER MATERIALIZED VIEW mv1 SET ("session.query_timeout" = "40000");
-- mv1のmv_rewrite_staleness_secondを600秒に変更します。
ALTER MATERIALIZED VIEW mv1 SET ("mv_rewrite_staleness_second" = "600");

例4: マテリアライズドビューのステータスをアクティブに変更します。

ALTER MATERIALIZED VIEW order_mv ACTIVE;

例5: マテリアライズドビュー order_mv と order_mv1 の間でアトミック交換を実行します。

ALTER MATERIALIZED VIEW order_mv SWAP WITH order_mv1;