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

CREATE ASYNC MATERIALIZED VIEW

説明​

非同期マテリアライズドビューを作成するためのステートメント。カラム名と型はマテリアライズドビューのSQLステートメントから導出されます。カスタムカラム名は許可されていますが、カラム型は定義できません。

構文​

CREATE MATERIALIZED VIEW 
[ IF NOT EXISTS ] <materialized_view_name>
    [ (<columns_definition>) ] 
    [ BUILD <build_mode> ]
    [ REFRESH <refresh_method> [<refresh_trigger>]]
    [ [DUPLICATE] KEY (<key_cols>) ]
    [ COMMENT '<table_comment>' ]
    [ PARTITION BY (
        { <partition_col> 
            | DATE_TRUNC(<partition_col>, <partition_unit>) }
        )]
    [ DISTRIBUTED BY { HASH (<distribute_cols>) | RANDOM }
        [ BUCKETS { <bucket_count> | AUTO } ]
    ]               
    [ PROPERTIES (
          -- Table property
          <table_property>
          -- Additional table properties
          [ , ... ]) 
    ]
    AS <query>

ここで：

columns_definition
  : -- Column definition
    <col_name> 
      [ COMMENT '<col_comment>' ]
refresh_trigger
  : ON MANUAL
  | ON SCHEDULE EVERY <int_value> <refresh_unit> [ STARTS '<start_time>']
  | ON COMMIT

必須パラメータ​

1. <materialized_view_name>

マテリアライズドビューの識別子（名前）を指定します。テーブルが作成されるデータベース内で一意である必要があります。

識別子は文字で始まる必要があり（Unicode名前サポートが有効な場合、任意の言語の任意の文字を使用できます）、識別子文字列全体がバッククォートで囲まれていない限り（例：My Object）、スペースや特殊文字を含むことはできません。

識別子は予約キーワードにすることはできません。

詳細については、識別子と予約キーワードの要件を参照してください。

2. <query>

マテリアライズドビューを作成する際の必須パラメータです。データを投入するSELECT文を指定します。

オプションパラメータ​

1. <key_cols>

テーブルのキーカラムです。Dorisでは、キーカラムはテーブルの最初のK個のカラムである必要があります。キーの制限とキーカラムの選択方法の詳細については、「データモデル」の章の各セクションを参照してください。

2. <build_mode>

リフレッシュタイミング：マテリアライズドビューが作成後すぐにリフレッシュされるべきかどうか。

IMMEDIATE：即座にリフレッシュします。デフォルトはIMMEDIATEです。

DEFERRED：遅延リフレッシュです。

3. <refresh_method>

リフレッシュ方法：

COMPLETE：すべてのパーティションをリフレッシュします。

AUTO：増分リフレッシュを試行し、最後のマテリアライズドビューのリフレッシュ以降に変更されたパーティションのみをリフレッシュします。増分リフレッシュが不可能な場合、すべてのパーティションがリフレッシュされます。

注意

パーティション化されたマテリアライズドビューがCOMPLETEリフレッシュモードを使用する場合、すべてのパーティションデータの完全リフレッシュを実行し、事実上非パーティション化マテリアライズドビューに退化します。

4. <refresh_trigger>

トリガー方法：

MANUAL：手動リフレッシュです。

ON SCHEDULE：スケジュールリフレッシュです。

ON COMMIT：トリガーリフレッシュで、ベーステーブルデータの変更がマテリアライズドビューのリフレッシュをトリガーします。

5. <refresh_unit>

定期リフレッシュの時間単位です。現在サポートされている単位は、MINUTE、HOUR、DAY、WEEKです。

6. <partition_col>

PARTITION BYが指定されていない場合、デフォルトで1つのパーティションのみが存在します。

パーティションフィールドが指定されている場合、そのフィールドがどのベーステーブルから来るかを自動的に推論し、ベーステーブルと同期します（現在は内部テーブルとHiveテーブルをサポート）。内部テーブルの場合、1つのパーティションフィールドのみが許可されます。

マテリアライズドビューは、パーティションロールアップを通じてパーティション数を減らすこともできます。現在、パーティションロールアップ機能はdate_truncをサポートしています。

7. <partition_unit>

パーティションロールアップの集約粒度です。現在サポートされている単位は、HOUR、DAY、WEEK、QUARTER、MONTH、YEARです。

8. <start_time>

スケジュールされた開始時刻は将来、つまり現在時刻よりも後である必要があります。

9. <table_property>

内部テーブルで使用されるプロパティで、そのほとんどがマテリアライズドビューで使用でき、マテリアライズドビュー固有のプロパティも含まれます。以下にリストします：

プロパティ名説明
grace_periodクエリリライト中にマテリアライズドビューデータに許可される最大遅延秒数。マテリアライズドビューのパーティションAとベーステーブルデータが不整合で、パーティションAの最後のリフレッシュ時刻が10:15:00で、現在のシステム時刻が10:15:08の場合、このパーティションは透過的にリライトされません。ただし、grace_periodが10に設定されている場合、このパーティションは透過的リライトに使用されます。
excluded_trigger_tablesデータリフレッシュ中に無視されるテーブル名をカンマ区切りで指定します。例：table1,table2。
refresh_partition_num単一のINSERT文でリフレッシュされるパーティション数で、デフォルトは1です。マテリアライズドビューをリフレッシュする際、まずリフレッシュするパーティションのリストを計算し、それを複数のINSERT文に分割して順次実行します。INSERT文が失敗した場合、タスク全体が停止します。マテリアライズドビューは単一のINSERT文の原子性を保証し、失敗したINSERTは既に正常にリフレッシュされたパーティションに影響しません。
workload_groupマテリアライズドビューがリフレッシュタスクを実行する際に使用されるworkload_groupの名前です。これは、データリフレッシュ中にマテリアライズドビューが使用するリソースを制限し、他のビジネス操作に影響を与えないようにするために使用されます。workload_groupの作成と使用の詳細については、WORKLOAD-GROUPドキュメントを参照してください。
partition_sync_limitベーステーブルのパーティションフィールドが時間型の場合、このプロパティをpartition_sync_time_unitと組み合わせて使用し、ベーステーブルと同期するパーティションの範囲を設定できます。例えば、2に設定し、partition_sync_time_unitをMONTHに設定した場合、ベーステーブルの直近2ヶ月のパーティションとデータのみが同期されます。最小値は1です。時間が経過すると、マテリアライズドビューは各リフレッシュ時に自動的にパーティションを追加および削除します。例えば、マテリアライズドビューが現在2ヶ月目と3ヶ月目のデータを持っている場合、来月には2ヶ月目のデータを自動的に削除し、4ヶ月目のデータを追加します。
partition_sync_time_unitパーティションリフレッシュの時間単位で、DAY/MONTH/YEAR（デフォルトはDAY）をサポートします。
partition_date_formatベーステーブルのパーティションフィールドが文字列型の場合、partition_sync_limit機能を使用したい場合は、日付形式を設定してpartition_date_format設定に従ってパーティション時刻を解析できます。
enable_nondeterministic_functionマテリアライズドビュー定義SQLに非決定的関数（current_date()、now()、random()など）を含めることが許可されるかどうか。trueに設定すると含めることが許可され、そうでなければ許可されません。デフォルトは許可しません。
use_for_rewriteこのマテリアライズドビューが透過的リライトに参加するかどうかを示します。falseに設定すると、透過的リライトに参加しません。デフォルトはtrueです。データモデリングシナリオで、マテリアライズドビューが直接クエリにのみ使用される場合、このプロパティを設定することで、マテリアライズドビューが透過的リライトに参加せず、クエリ応答速度を向上させることができます。
注意

DISTRIBUTED BY句はApache Doris 2.1.10より前では必須です - 省略するとエラーが発生します。 Apache Doris 2.1.10以降、指定されていない場合、デフォルトの分散はRANDOMになります。

注意

Apache Doris 2.1.10/3.0.6より前では、excluded_trigger_tablesプロパティはベーステーブル名の指定のみをサポートしていました。 これらのバージョン以降、CatalogとDatabaseを含む完全修飾テーブル名（例：internal.db1.table1）をサポートするようになりました。

アクセス制御要件​

このSQLコマンドを実行するユーザーは、少なくとも以下の権限を持っている必要があります：

権限オブジェクト備考
CREATE_PRIVDatabase
SELECT_PRIVTable, View<query>でクエリされるテーブルまたはビューに対するSELECT_PRIV権限が必要

注意事項​

  • マテリアライズドビューのDMLおよびDDL制限：

    マテリアライズドビューは、カラムタイプの変更、カラムの追加、削除などのスキーマ変更操作をサポートしていません。カラムはマテリアライズドビュー定義SQLから導出されるためです。

    マテリアライズドビューは、手動のinsert intoまたはinsert overwrite操作をサポートしていません。

  • パーティション化マテリアライズドビュー作成の条件：

    マテリアライズドビューのSQL定義とパーティションフィールドは、パーティション化増分更新を実行するために以下の条件を満たす必要があります：

    1. マテリアライズドビューで使用されるベーステーブルのうち少なくとも1つはパーティションテーブルである必要があります。
    2. マテリアライズドビューで使用されるパーティション化ベーステーブルは、ListまたはRangeパーティショニング戦略を使用する必要があります。
    3. マテリアライズドビュー定義SQLのPartition By句には、1つのパーティションフィールドのみを含めることができます。
    4. マテリアライズドビューSQLのPartition By句のパーティションフィールドは、Select句の後に現れる必要があります。
    5. マテリアライズドビュー定義SQLでGroup Byを使用する場合、パーティションフィールドはGroup By句の後に現れる必要があります。
    6. マテリアライズドビュー定義SQLでWindow関数を使用する場合、パーティションフィールドはPartition By句の後に現れる必要があります。
    7. データ変更はパーティションテーブルで発生する必要があります。非パーティションテーブルで発生する場合、マテリアライズドビューは完全ビルドが必要になります。
    8. マテリアライズドビューがJoinのNULL生成側からのフィールドをパーティションフィールドとして使用する場合、パーティション化増分更新を実行できません。例えば、LEFT OUTER JOINの場合、パーティションフィールドは右側ではなく左側にある必要があります。

例​

  1. 非パーティション化マテリアライズドビュー

CREATE MATERIALIZED VIEW complete_mv (
orderdate COMMENT 'Order date',
orderkey COMMENT 'Order key',
partkey COMMENT 'Part key'
)
BUILD IMMEDIATE
REFRESH AUTO
ON SCHEDULE EVERY 1 DAY STARTS '2024-12-01 20:30:00'
DISTRIBUTED BY HASH (orderkey) BUCKETS 2
PROPERTIES
("replication_num" = "1")
AS
SELECT
o_orderdate,
l_orderkey,
l_partkey
FROM
orders
LEFT JOIN lineitem ON l_orderkey = o_orderkey
LEFT JOIN partsupp ON ps_partkey = l_partkey
and l_suppkey = ps_suppkey;
  1. パーティション化されたマテリアライズドビュー

以下に示すように、パーティション列が指定された場合、システムは自動的に列がどのベーステーブルから来ているかを識別し、ベーステーブルのパーティションを同期します。ベーステーブルは日単位でパーティション化されています（パーティション列：o_orderdate、パーティションタイプ：RANGE）。マテリアライズドビューは月単位でパーティション化され、DATE_TRUNC関数を使用してベーステーブルのパーティションを月単位でロールアップします。

CREATE TABLE IF NOT EXISTS orders  (
o_orderkey       integer not null,
o_custkey        integer not null,
o_orderstatus    char(1) not null,
o_totalprice     decimalv3(15,2) not null,
o_orderdate      date not null,
o_orderpriority  char(15) not null,  
o_clerk          char(15) not null,
o_shippriority   integer not null,
o_comment        varchar(79) not null
)
DUPLICATE KEY(o_orderkey, o_custkey)
PARTITION BY RANGE(o_orderdate)(
FROM ('2023-10-16') TO ('2023-11-30') INTERVAL 1 DAY
)
DISTRIBUTED BY HASH(o_orderkey) BUCKETS 3
PROPERTIES (
"replication_num" = "3"
);
CREATE MATERIALIZED VIEW partition_mv
BUILD IMMEDIATE
REFRESH AUTO
ON SCHEDULE EVERY 1 DAY STARTS '2024-12-01 20:30:00'
PARTITION BY (DATE_TRUNC(o_orderdate, 'MONTH'))
DISTRIBUTED BY HASH (l_orderkey) BUCKETS 2
PROPERTIES
("replication_num" = "3")
AS
SELECT
o_orderdate,
l_orderkey,
l_partkey
FROM
orders
LEFT JOIN lineitem ON l_orderkey = o_orderkey
LEFT JOIN partsupp ON ps_partkey = l_partkey
and l_suppkey = ps_suppkey;

以下の例では、パーティションカラムが非date_trunc関数を使用しているため、パーティション化されたマテリアライズドビューを作成できません。エラーメッセージは次のとおりです: because column to check use invalid implicit expression, invalid expression is min(o_orderdate#4)

CREATE MATERIALIZED VIEW partition_mv_2
BUILD IMMEDIATE
REFRESH AUTO
ON SCHEDULE EVERY 1 DAY STARTS '2024-12-01 20:30:00'
PARTITION BY (DATE_TRUNC(min_orderdate, 'MONTH'))
DISTRIBUTED BY HASH (l_orderkey) BUCKETS 2
PROPERTIES
("replication_num" = "3")
AS
SELECT
min(o_orderdate) AS min_orderdate,
l_orderkey,
l_partkey
FROM
orders
LEFT JOIN lineitem ON l_orderkey = o_orderkey
LEFT JOIN partsupp ON ps_partkey = l_partkey
and l_suppkey = ps_suppkey
GROUP BY
o_orderdate,
l_orderkey,
l_partkey;
  1. マテリアライズドビューのプロパティの変更 ALTER MATERIALIZED VIEW文を使用します。

例：

ALTER MATERIALIZED VIEW partition_mv
SET (
"grace_period" = "10",
"excluded_trigger_tables" = "lineitem,partsupp"
);
  1. マテリアライズドビューのリフレッシュモードの変更 ALTER MATERIALIZED VIEW文を使用します。 例：
ALTER MATERIALIZED VIEW partition_mv REFRESH COMPLETE;
After running SHOW CREATE MATERIALIZED VIEW partition_mv;, you can see that the refresh mode has been changed to COMPLETE.
Report issue
ASF
Resources
Community
Join the community
Copyright © 2026 The Apache Software Foundation,Licensed under the Apache License, Version 2.0. Apache, Doris, Apache Doris, the Apache feather logo and the Apache Doris logo are trademarks of The Apache Software Foundation.