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

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       | int(11)         | YES  |      | NULL    |       |
   | SEQUENCE$$ | bigint(20)      | NO   | PRI  | NULL    |       |
   | DMLTYPE$$  | varchar(1)      | YES  |      | NULL    |       |
   | OLD_NEW$$  | varchar(1)      | YES  |      | NULL    |       |
   | M_ROW$$    | bigint unsigned | NO   | PRI  | 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データベースは、test_tbl2 テーブルの必要な col2 列に対して自動的に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       | int(11)         | YES  |      | NULL    |       |
   | SEQUENCE$$ | bigint(20)      | NO   | PRI  | NULL    |       |
   | DMLTYPE$$  | varchar(1)      | YES  |      | NULL    |       |
   | OLD_NEW$$  | varchar(1)      | YES  |      | NULL    |       |
   | M_ROW$$    | bigint unsigned | NO   | PRI  | 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       | int(11)         | YES  |      | NULL    |       |
   | col3       | int(11)         | YES  |      | NULL    |       |
   | SEQUENCE$$ | bigint(20)      | NO   | PRI  | NULL    |       |
   | DMLTYPE$$  | varchar(1)      | YES  |      | NULL    |       |
   | OLD_NEW$$  | varchar(1)      | YES  |      | NULL    |       |
   | M_ROW$$    | bigint unsigned | NO   | PRI  | 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       | int(11)         | YES  |      | NULL    |       |
   | col3       | int(11)         | YES  |      | NULL    |       |
   | SEQUENCE$$ | bigint(20)      | NO   | PRI  | NULL    |       |
   | DMLTYPE$$  | varchar(1)      | YES  |      | NULL    |       |
   | OLD_NEW$$  | varchar(1)      | YES  |      | NULL    |       |
   | M_ROW$$    | bigint unsigned | NO   | PRI  | 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       | int(11)         | YES  |      | NULL    |       |
   | SEQUENCE$$ | bigint(20)      | NO   | PRI  | NULL    |       |
   | DMLTYPE$$  | varchar(1)      | YES  |      | NULL    |       |
   | OLD_NEW$$  | varchar(1)      | YES  |      | NULL    |       |
   | M_ROW$$    | bigint unsigned | NO   | PRI  | 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;
   

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

   ERROR 1146 (42S02): Table 'test_db.mlog$_test_tbl3' doesn't exist
   

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

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

関連ドキュメント

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