CREATE MATERIALIZED VIEW LOG

説明

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

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

権限要件

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

構文

CREATE MATERIALIZED VIEW LOG ON [database.] 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 パラメータの値に設定されます。

現在のタイムゾーンの時間を表すには、sysdate() の使用を推奨します。時刻式の例は以下のとおりです：

START WITH sysdate() NEXT sysdate() + INTERVAL 1 DAY

上記の句は、現在時刻（sysdate()）から始まり、1日ごとに期限切れのマテリアライズドビューのログレコードをクリーンアップすることを示します。

例

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

   obclient> CREATE TABLE test_tbl1 (col1 INT PRIMARY KEY, col2 VARCHAR(20), col3 INT);
   

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 sysdate() NEXT sysdate() + INTERVAL 1 DAY;
   

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

   obclient> DESC mlog$_test_tbl1;
   

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

   +------------+-------------+------+------+---------+-------+
   | Field      | Type        | Null | Key  | Default | Extra |
   +------------+-------------+------+------+---------+-------+
   | col1       | int(11)     | NO   | PRI  | NULL    |       |
   | col2       | varchar(20) | YES  |      | NULL    |       |
   | SEQUENCE$$ | bigint(20)  | NO   | PRI  | NULL    |       |
   | DMLTYPE$$  | varchar(1)  | YES  |      | NULL    |       |
   | OLD_NEW$$  | varchar(1)  | YES  |      | NULL    |       |
   +------------+-------------+------+------+---------+-------+
   5 rows in set
   

関連ドキュメント

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