CREATE MATERIALIZED VIEW LOG

説明

このステートメントは、マテリアライズドビューのログを作成するために使用されます。

マテリアライズドビューのログ（Materialized View Log、mlog）は、ベーステーブル（通常のテーブルまたはマテリアライズドビュー）の増分更新データを記録し、マテリアライズドビューの高速リフレッシュ機能をサポートします。mlog は、ベーステーブルの変更を追跡し、これらの変更を対応するマテリアライズドビューに適用して高速なリフレッシュを実現するためのレコードテーブルです。

権限要件

マテリアライズドビューのログを作成するには、CREATE TABLE とベーステーブルに対する SELECT 権限が必要です。OceanBaseデータベースの権限の詳細については、Oracleモードの権限分類を参照してください。

構文

CREATE [OR REPLACE] MATERIALIZED VIEW LOG ON [schema.] table
    [parallel_clause]
    [with_clause]
    [mv_log_purge_clause];

parallel_clause:
    NOPARALLEL
    | PARALLEL integer

with_clause:
    WITH [ {PRIMARY KEY | ROWID | SEQUENCE}
            [ { , PRIMARY KEY | , ROWID | , SEQUENCE }]... ]
        (column_name [, column_name]...)
        [new_values_clause]

new_values_clause:
    {INCLUDING | EXCLUDING} NEW VALUES

mv_log_purge_clause:
    PURGE {IMMEDIATE [ SYNCHRONOUS ]
        | START WITH datetime_expr [NEXT datetime_expr]
        | [START WITH datetime_expr] NEXT datetime_expr
        }

パラメータの説明

parallel_clause

• NOPARALLEL：デフォルト設定で、並列度は 1 です。

• PARALLEL integer：並列度を指定します。integer の値は 1 以上です。

with_clause

• PRIMARY KEY：マテリアライズドビューのログがベーステーブルの主キー列を記録することを示します。主キーを持つテーブルに対してのみ有効です。指定しない場合、システムはマテリアライズドビューのログにこのプロパティを自動的に追加します。つまり、マテリアライズドビューのログにはデフォルトで主キー列が含まれます。

• ROWID：マテリアライズドビューのログがベーステーブルの行識別子（ROWID）を記録することを示します。指定しない場合、システムはマテリアライズドビューのログにこのプロパティを自動的に追加します。つまり、マテリアライズドビューのログにはデフォルトで M_ROW$$ 列が含まれます。

• SEQUENCE：マテリアライズドビューのログがトランザクション内の複数行の更新シーケンス番号（seq_no）を記録することを示します。システムはマテリアライズドビューのログにこのプロパティを自動的に追加します。つまり、マテリアライズドビューのログにはデフォルトで SEQUENCE$$ 列が含まれます。

new_values_clause

• INCLUDING：デフォルト設定で、マテリアライズドビューのログに新旧値を保存できることを示します。マテリアライズドビューが迅速なリフレッシュをサポートするようにしたい場合は、INCLUDING NEW VALUES を指定する必要があります。

• EXCLUDING：マテリアライズドビューのログに新しい値を記録することを無効にすることを示します。EXCLUDING NEW VALUES を使用しないでください。そうしないとエラーが発生します。

mv_log_purge_clause

• IMMEDIATE：マテリアライズドビューのリフレッシュが完了するたびに、対応するマテリアライズドビューのログを直ちに削除することを示します。デフォルト値は SYNCHRONOUS です。

  • SYNCHRONOUS：オプションで、同期実行での削除を示します。

• START WITH datetime_expr [NEXT datetime_expr]：

  • START WITH datetime_expr：マテリアライズドビューのログの最初の削除時間を示します。
  • [NEXT datetime_expr]：オプションで、次回のマテリアライズドビューのログの削除時間を示します。次回のマテリアライズドビューのログの削除時間を設定するために使用します。

• [START WITH datetime_expr] NEXT datetime_expr：START WITH datetime_expr パラメータを指定せず、NEXT datetime_expr パラメータのみを指定した場合、マテリアライズドビューのログの最初の削除時間は NEXT datetime_expr パラメータの値に設定されます。

現在のタイムゾーンの時間を表すために current_date を使用することを推奨します。日付時刻式の例は以下のとおりです：

• 現在の時間（current_date）から始まり、10秒ごとに期限切れのマテリアライズドビューのログレコードをクリーンアップします。

  START WITH current_date NEXT current_date + INTERVAL '10' SECOND
  

• 現在の時間（current_date）から始まり、10時間ごとに期限切れのマテリアライズドビューのログレコードをクリーンアップします。

  START WITH current_date NEXT current_date + INTERVAL '10' HOUR
  

• 現在の時間（current_date）から始まり、1日ごとに期限切れのマテリアライズドビューのログレコードをクリーンアップします。

  START WITH current_date NEXT current_date + 1
  

例

1. テーブル test_tbl1 を作成します。

   CREATE TABLE test_tbl1 (col1 NUMBER PRIMARY KEY, col2 VARCHAR2(20), col3 NUMBER);
   

2. test_tbl1 テーブルにマテリアライズドビューのログを作成します。マテリアライズドビューのログをパラレル処理するパラレル度を 5 に指定し、マテリアライズドビューのログが col2 列の変更情報を記録するように設定します。また、変更前後の新しい値も記録されます。さらに、マテリアライズドビューのログは現在の日付から始まり、1 日ごとに期限切れのマテリアライズドビューのログレコードをクリーンアップするように設定します。

   CREATE MATERIALIZED VIEW LOG ON test_tbl1
       PARALLEL 5
       WITH SEQUENCE(col2) INCLUDING NEW VALUES
       PURGE START WITH current_date NEXT current_date + 1;
   

3. テーブル test_tbl1 のマテリアライズドビューのログ情報を確認します。

   DESC mlog$_test_tbl1;
   

   実行結果は次のとおりです：

   +------------+--------------+------+------+---------+-------+
   | FIELD      | TYPE         | NULL | KEY  | DEFAULT | EXTRA |
   +------------+--------------+------+------+---------+-------+
   | COL1       | NUMBER       | NO   | PRI  | NULL    | NULL  |
   | COL2       | VARCHAR2(20) | YES  | NULL | NULL    | NULL  |
   | SEQUENCE$$ | BIGINT(20)   | NO   | PRI  | NULL    | NULL  |
   | DMLTYPE$$  | VARCHAR2(1 ) | YES  | NULL | NULL    | NULL  |
   | OLD_NEW$$  | VARCHAR2(1 ) | YES  | NULL | NULL    | NULL  |
   +------------+--------------+------+------+---------+-------+
   5 rows in set
   

4. test_tbl1 テーブルのマテリアライズドビューのログを変更して、col2 と col3 列の変更情報を記録するようにします。

   CREATE OR REPLACE MATERIALIZED VIEW LOG ON test_tbl1
       PARALLEL 5
       WITH SEQUENCE(col2, col3) INCLUDING NEW VALUES
       PURGE START WITH current_date NEXT current_date + 1;
   

5. テーブル test_tbl1 のマテリアライズドビューのログ情報を確認します。

   DESC mlog$_test_tbl1;
   

   実行結果は次のとおりです：

   +------------+--------------+------+------+---------+-------+
   | FIELD      | TYPE         | NULL | KEY  | DEFAULT | EXTRA |
   +------------+--------------+------+------+---------+-------+
   | COL1       | NUMBER       | NO   | PRI  | NULL    | NULL  |
   | COL2       | VARCHAR2(20) | YES  | NULL | NULL    | NULL  |
   | COL3       | NUMBER       | YES  | NULL | NULL    | NULL  |
   | SEQUENCE$$ | BIGINT(20)   | NO   | PRI  | NULL    | NULL  |
   | DMLTYPE$$  | VARCHAR2(1 ) | YES  | NULL | NULL    | NULL  |
   | OLD_NEW$$  | VARCHAR2(1 ) | YES  | NULL | NULL    | NULL  |
   +------------+--------------+------+------+---------+-------+
   6 rows in set
   

関連ドキュメント

マテリアライズドビューのログ