マテリアライズドビューのログの自動管理

OceanBaseデータベースは、マテリアライズドビューのログ（Materialized View Log、mlog）の自動管理機能をサポートしています。この機能には以下の2つの側面が含まれます：

1. マテリアライズドビューを作成する際、そのマテリアライズドビューがベーステーブルに依存している関係を分析し、必要なmlogを自動的に作成します。
2. バックグラウンドで定期的にmlogをトリミングし、依存されていないmlogを削除し、mlog内の列セットを簡略化することで、mlogのメンテナンスコストを削減します。

使用上の制限

マテリアライズドビューを作成する際、明示的に増分更新マテリアライズドビュー（REFRESH FASTを指定）またはリアルタイムマテリアライズドビュー（ENABLE ON QUERY COMPUTATIONを指定）として宣言した場合にのみ、mlogが自動的に作成されたり、mlog定義が自動的に更新されたりします。

注意点

• mlog定義を更新する際、OceanBaseデータベースは実際には新しいmlogテーブルを作成して既存のmlogを置き換えます。置き換えプロセスでは、関連する増分リフレッシュマテリアライズドビューを1回増分リフレッシュし、元のmlogにある増分データをマテリアライズドビューに書き込む必要があります。これにより、mlogを安全に置き換えることができます。したがって、ベーステーブルに関連付けられたマテリアライズドビューの数や増分データ量が多い場合、mlog定義の更新は時間のかかる操作になる可能性があるため、事前に留意しておく必要があります。

• mlog_trim_interval の時間間隔は小さく設定しすぎないようにすることを推奨します。そうでないと、mlogが誤ってトリムされ、マテリアライズドビュー作成時に再度mlogを作成または更新する必要が生じる可能性があります。

関連設定

OceanBaseデータベースは、mlogの自動化動作を制御するための2つのパラメータを提供しています。

• enable_mlog_auto_maintenance：マテリアライズドビューのログ自動管理機能を有効にするかどうかを制御します。
• mlog_trim_interval：mlogバックグラウンドの自動トリミングタスクのスケジューリング間隔を制御します。

使用例

mlogの自動化管理を有効にします。

obclient> ALTER SYSTEM SET enable_mlog_auto_maintenance = True;

例1：mlogの自動作成

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

   obclient> CREATE TABLE test_tbl1(col1 INT, col2 INT, col3 INT);
   

2. テーブル test_tbl1 に直接、増分更新マテリアライズドビュー mv_test_tbl1 を作成します。OceanBaseデータベースは、test_tbl1 テーブルの必要な col2 列に対して自動的にmlogを作成します。

   obclient> CREATE MATERIALIZED VIEW mv_test_tbl1
       REFRESH FAST
       AS SELECT
              col2,
              count(*) cnt
          FROM test_tbl1
          GROUP BY col2;
   

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

   obclient> DESC mlog$_test_tbl1;
   

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

   +------------+-----------------+------+------+---------+-------+
   | FIELD      | TYPE            | NULL | KEY  | DEFAULT | EXTRA |
   +------------+-----------------+------+------+---------+-------+
   | COL2       | NUMBER(38)      | 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  |
   | M_ROW$$    | BIGINT UNSIGNED | NO   | PRI  | NULL    | NULL  |
   +------------+-----------------+------+------+---------+-------+
   5 rows in set
   

例2：mlog定義の自動更新

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

   obclient> CREATE TABLE test_tbl2(col1 INT, col2 INT, col3 INT);
   

2. テーブル test_tbl2 に直接、増分更新マテリアライズドビュー mv1_test_tbl2 を作成します。OceanBaseデータベースは、必要な col2 列に対して、テーブル test_tbl2 のmlogを自動的に作成します。

   obclient> CREATE MATERIALIZED VIEW mv1_test_tbl2
       REFRESH FAST
       AS SELECT
              col2,
              count(*) cnt
          FROM test_tbl2
          GROUP BY col2;
   

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

   obclient> DESC mlog$_test_tbl2;
   

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

   +------------+-----------------+------+------+---------+-------+
   | FIELD      | TYPE            | NULL | KEY  | DEFAULT | EXTRA |
   +------------+-----------------+------+------+---------+-------+
   | COL2       | NUMBER(38)      | 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  |
   | M_ROW$$    | BIGINT UNSIGNED | NO   | PRI  | NULL    | NULL  |
   +------------+-----------------+------+------+---------+-------+
   5 rows in set
   

4. テーブル test_tbl2 に直接、増分更新マテリアライズドビュー mv2_test_tbl2 を作成します。OceanBaseデータベースは、現在のmlogテーブルに col2 列のみが含まれていることを検出し、既存のmlog定義を変更して、mlogテーブルに col3 列を追加します。

   obclient> CREATE MATERIALIZED VIEW mv2_test_tbl2
       REFRESH FAST
       AS SELECT
           col3,
           count(*) cnt
       FROM test_tbl2
       GROUP BY col3;
   

5. 再度、テーブル test_tbl2 のマテリアライズドビューのログ情報を確認すると、テーブル test_tbl2 のmlogテーブル定義に col2 列と col3 列が含まれていることが確認できます。

   obclient> DESC mlog$_test_tbl2;
   

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

   +------------+-----------------+------+------+---------+-------+
   | FIELD      | TYPE            | NULL | KEY  | DEFAULT | EXTRA |
   +------------+-----------------+------+------+---------+-------+
   | COL2       | NUMBER(38)      | YES  | NULL | NULL    | NULL  |
   | COL3       | NUMBER(38)      | 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  |
   | M_ROW$$    | BIGINT UNSIGNED | NO   | PRI  | NULL    | NULL  |
   +------------+-----------------+------+------+---------+-------+
   6 rows in set
   

例3：mlogの自動クリッピング

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

   obclient> CREATE TABLE test_tbl3(col1 INT, col2 INT, col3 INT);
   

2. テーブル test_tbl3 に直接、増分更新マテリアライズドビュー mv1_test_tbl3 を作成します。OceanBaseデータベースは、必要な col2 列に対して、テーブル test_tbl3 のmlogを自動的に作成します。

   obclient> CREATE MATERIALIZED VIEW mv1_test_tbl3
       REFRESH FAST
       AS SELECT
              col2,
              count(*) cnt
          FROM test_tbl3
          GROUP BY col2;
   

3. テーブル test_tbl3 に直接、増分更新マテリアライズドビュー mv2_test_tbl3 を作成します。OceanBaseデータベースは、現在のmlogテーブルに col2 列のみが含まれていることを検出し、既存のmlog定義を変更して、mlogテーブルに col3 列を追加します。

   obclient> CREATE MATERIALIZED VIEW mv2_test_tbl3
       REFRESH FAST
       AS SELECT
           col3,
           count(*) cnt
       FROM test_tbl3
       GROUP BY col3;
   

4. テーブル test_tbl3 のマテリアライズドビューのログ情報を確認すると、テーブル test_tbl3 のmlogテーブル定義に col2 列と col3 列が含まれていることが確認できます。

   obclient> DESC mlog$_test_tbl3;
   

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

   +------------+-----------------+------+------+---------+-------+
   | FIELD      | TYPE            | NULL | KEY  | DEFAULT | EXTRA |
   +------------+-----------------+------+------+---------+-------+
   | COL2       | NUMBER(38)      | YES  | NULL | NULL    | NULL  |
   | COL3       | NUMBER(38)      | 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  |
   | M_ROW$$    | BIGINT UNSIGNED | NO   | PRI  | NULL    | NULL  |
   +------------+-----------------+------+------+---------+-------+
   6 rows in set
   

5. mlogクリッピング間隔を変更し、クリッピング結果をより早く確認します。

   obclient> ALTER SYSTEM SET mlog_trim_interval = '5s';
   

6. マテリアライズドビュー mv1_test_tbl3 を削除します。

   obclient> DROP MATERIALIZED VIEW mv1_test_tbl3;
   

7. 5秒待ってから、テーブル test_tbl3 のマテリアライズドビューのログ情報を確認すると、テーブル test_tbl3 のmlogテーブル定義には col3 列のみが残っていることが確認できます。

   obclient> DESC mlog$_test_tbl3;
   

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

   +------------+-----------------+------+------+---------+-------+
   | FIELD      | TYPE            | NULL | KEY  | DEFAULT | EXTRA |
   +------------+-----------------+------+------+---------+-------+
   | COL3       | NUMBER(38)      | 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  |
   | M_ROW$$    | BIGINT UNSIGNED | NO   | PRI  | NULL    | NULL  |
   +------------+-----------------+------+------+---------+-------+
   5 rows in set
   

8. マテリアライズドビュー mv2_test_tbl3 を削除します。

   obclient> DROP MATERIALIZED VIEW mv2_test_tbl3;
   

9. 5秒待ってから、テーブル test_tbl3 のマテリアライズドビューのログ情報を確認すると、テーブル test_tbl3 のmlogテーブルは存在しなくなっています。

   obclient> DESC mlog$_test_tbl3;
   

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

   OBE-04043: object TEST_USER001.MLOG$_TEST_TBL3 does not exist
   

10. mlogクリッピング間隔を元に戻します。

    obclient> ALTER SYSTEM SET mlog_trim_interval = '1d';
    

関連ドキュメント

• マテリアライズドビューの概要
• マテリアライズドビューのログ
• マテリアライズドビューの作成
• マテリアライズドビューの削除