ALTER MATERIALIZED VIEW

説明

このSQLステートメントは以下のことができます:

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

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

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

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

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

  このSQLステートメントを使用して、以下のプロパティを変更できます:

  • bloom_filter_columns
  • partition_ttl_number
  • partition_refresh_number
  • partition_refresh_strategy
  • resource_group
  • auto_refresh_partitions_limit
  • excluded_trigger_tables
  • mv_rewrite_staleness_second
  • unique_constraints
  • foreign_key_constraints
  • colocate_with
  • excluded_refresh_tables
  • すべてのセッション変数関連のプロパティ。セッション変数については、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_name	yes	変更するマテリアライズドビューの名前。
new_refresh_scheme_desc	no	新しいリフレッシュ戦略。詳細はSQL Reference - CREATE MATERIALIZED VIEW - Parametersを参照してください。
new_mv_name	no	マテリアライズドビューの新しい名前。
ACTIVE	no	マテリアライズドビューのステータスをアクティブに設定します。StarRocksは、ベーステーブルが変更された場合（例: 削除され再作成された場合）、元のメタデータが変更されたベーステーブルと一致しない状況を防ぐために、マテリアライズドビューを自動的に非アクティブに設定します。非アクティブなマテリアライズドビューはクエリアクセラレーションやクエリの書き換えには使用できません。ベーステーブルを変更した後、このSQLを使用してマテリアライズドビューをアクティブにできます。
INACTIVE	no	マテリアライズドビューのステータスを非アクティブに設定します。非アクティブな非同期マテリアライズドビューはリフレッシュできませんが、テーブルとしてクエリすることはできます。
SWAP WITH	no	必要な整合性チェックの後、他の非同期マテリアライズドビューとアトミック交換を実行します。
key	no	変更するプロパティの名前。詳細はSQL Reference - CREATE MATERIALIZED VIEW - Parametersを参照してください。 注意 マテリアライズドビューのセッション変数関連のプロパティを変更する場合は、プロパティにsession.プレフィックスを追加する必要があります。例: session.insert_timeout。非セッションプロパティの場合、プレフィックスを指定する必要はありません。例: mv_rewrite_staleness_second。
value	no	変更するプロパティの値。

例

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

ALTER MATERIALIZED VIEW lo_mv1 RENAME lo_mv1_new_name;

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

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

例3: マテリアライズドビューのリフレッシュタスクのタイムアウト期間を1時間（デフォルト）に変更します。

ALTER MATERIALIZED VIEW mv1 SET ("session.insert_timeout" = "3600");

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

ALTER MATERIALIZED VIEW order_mv ACTIVE;

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

ALTER MATERIALIZED VIEW order_mv SWAP WITH order_mv1;

例6: マテリアライズドビューのリフレッシュプロセスのプロファイルを有効にします。この機能はデフォルトで有効です。

ALTER MATERIALIZED VIEW mv1 SET ("session.enable_profile" = "true");

例7: マテリアライズドビューのリフレッシュプロセスでの中間結果のスピリングを有効にし、スピリングのモードをforceに設定します。中間結果のスピリングはv3.1以降デフォルトで有効です。

-- マテリアライズドビューのリフレッシュ中にスピリングを有効にします。
ALTER MATERIALIZED VIEW mv1 SET ("session.enable_spill" = "true");
-- spill_modeをforceに設定します（デフォルト値はautoです）。
ALTER MATERIALIZED VIEW mv1 SET ("session.spill_mode" = "force");

例8: 外部テーブルや複数のジョインを含むクエリステートメントがある場合、マテリアライズドビューのオプティマイザのタイムアウト期間を30秒（v3.3以降のデフォルト）に変更します。

ALTER MATERIALIZED VIEW mv1 SET ("session.new_planner_optimize_timeout" = "30000");

例9: マテリアライズドビューのクエリの書き換えの古さの時間を600秒に変更します。

ALTER MATERIALIZED VIEW mv1 SET ("mv_rewrite_staleness_second" = "600");

例10: マテリアライズドビューのブルームフィルターインデックスを変更します。

ALTER MATERIALIZED VIEW mv1 SET ("bloom_filter_columns" = "col1, col2");