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

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
    • 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_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: マテリアライズドビューのリフレッシュタスクのタイムアウト期間を1時間（デフォルト）に変更します。

ALTER MATERIALIZED VIEW mv1 SET ("session.query_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");