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 を作成します。

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

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

   obclient> 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 のマテリアライズドビューのログ情報を確認します。

   obclient> 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 列の変更情報を記録するようにします。

   obclient> 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 のマテリアライズドビューのログ情報を確認します。

   obclient> 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
   

関連ドキュメント

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