インデックスの監視

OceanBaseデータベースはインデックス監視機能を提供しており、ビューDBA_INDEX_USAGEを使用してインデックス監視結果を照会することで、インデックスの使用状況をより明確に把握できます。インデックステーブルが削除された場合、OceanBaseデータベースはバックグラウンドで対応する監視データレコードを定期的にクリーンアップしますので、手動で削除する必要はありません。

注意点

• テナントレベルのパラメータ _iut_stat_collection_type=ALL を設定すると、インデックスクエリのパフォーマンスが低下する可能性があります。そのため、このモードを使用する際は慎重に検討し、パフォーマンスの低下による影響を十分に評価する必要があります。

• パラメータ _iut_max_entries は保存されるインデックステーブルの上限を設定します。この値を大きく設定しすぎると、テナントのメモリ消費が増加する可能性があるため、30000を超える設定は推奨されません。

使用方法

• インデックス監視機能はデフォルトで有効になっており、デフォルトのサンプリング（SAMPLED）モードでは、パフォーマンスへの影響は非常に小さく、無視できる範囲です。

パラメータ

インデックスの監視方法を制御するために、OceanBaseデータベースは以下のテナントレベルの構成パラメータを提供しています。

インデックス監視情報の統計モード

インデックス監視はクラスタ起動時にデフォルトのサンプリング（SAMPLED）モードを採用しているため、このモードではすべてのインデックス使用データが内部テーブルに記録されるわけではありません。その結果、ビュー DBA_INDEX_USAGE のクエリ結果が空になる場合があります。正確な情報が必要な場合は、現在のテナントでインデックス監視情報収集モードを ALL に設定できます。

以下のSQLステートメントを使用して、パラメータ _iut_stat_collection_type の値を確認できます：

SELECT name, data_type, value FROM oceanbase.GV$OB_PARAMETERS WHERE name LIKE '%iut_stat_collection%';

以下のSQLステートメントを使用して設定できます：

ALTER SYSTEM SET _iut_stat_collection_type="ALL";

例

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

   obclient [test_db]> CREATE TABLE test_tbl1 (col1 INT PRIMARY KEY, col2 VARCHAR(50) NOT NULL, col3 INT);
   

2. テーブル test_tbl1 の列 col3 に、idx1_test_tbl1 という名前のインデックスを作成します。

   obclient [test_db]> CREATE INDEX idx1_test_tbl1 ON test_tbl1(col3);
   

3. テーブル test_tbl1 に 5 件のデータを挿入します。

   obclient [test_db]> INSERT INTO test_tbl1 VALUES (1, 'name1', 20),(2, 'name2', 19),(3, 'name3', 20),(4, 'name4', 29),(5, 'name5', 26);
   

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

   Query OK, 5 rows affected
   Records: 5  Duplicates: 0  Warnings: 0
   

4. SELECT クエリを実行します。

   obclient [test_db]> SELECT col1, col2 FROM test_tbl1 WHERE col3 >= 25;
   

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

   +------+-------+
   | col1 | col2  |
   +------+-------+
   |    5 | name5 |
   |    4 | name4 |
   +------+-------+
   2 rows in set
   

5. ビュー DBA_INDEX_USAGE を確認します。

   説明

   インデックス監視は統計情報を収集した後、バックグラウンドの定期タスクを通じてデータを内部テーブルに書き込みます。そのため、ビューでインデックス使用状況の監視結果を確認するまで、最大で15分ほど待つ必要があります。

   obclient [test_db]> SELECT OBJECT_ID, NAME, OWNER, TOTAL_ACCESS_COUNT, TOTAL_EXEC_COUNT, LAST_USED FROM oceanbase.DBA_INDEX_USAGE;
   

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

   Empty set
   

   デフォルトの SAMPLED モードでは、すべてのインデックス使用データが内部テーブルに記録されるわけではないため、ビューで期待される監視結果が得られない場合があります。SQLステートメントを使用して非サンプリングモードに変更し、データを収集することができます。例えば、以下の操作を実行します：

   1. 以下のSQLステートメントを使用して、インデックス情報収集モードを ALL に設定します。

      ALTER SYSTEM SET _iut_stat_collection_type="ALL";
      

   2. 再度 SELECT クエリを実行します。

      SELECT col1, col2 FROM test_tbl1 WHERE col3 >= 25;
      

   3. 再度ビュー DBA_INDEX_USAGE を確認します。

      説明

      インデックス監視は統計情報を収集した後、バックグラウンドの定期タスクを通じてデータを内部テーブルに書き込みます。そのため、ビューでインデックス使用状況の監視結果を確認するまで、最大で15分ほど待つ必要があります。

      SELECT OBJECT_ID, NAME, OWNER, TOTAL_ACCESS_COUNT, TOTAL_EXEC_COUNT, LAST_USED FROM oceanbase.DBA_INDEX_USAGE;
      

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

      +-----------+-----------------------------+---------+--------------------+------------------+----------------------------+
      | OBJECT_ID | NAME                        | OWNER   | TOTAL_ACCESS_COUNT | TOTAL_EXEC_COUNT | LAST_USED                  |
      +-----------+-----------------------------+---------+--------------------+------------------+----------------------------+
      |    500127 | __idx_500126_idx1_test_tbl1 | test_db |                  1 |                1 | 2024-01-24 11:09:30.928232 |
      +-----------+-----------------------------+---------+--------------------+------------------+----------------------------+
      1 row in set
      

      クエリ結果の説明：

      TOTAL_ACCESS_COUNT フィールドは、SELECT 操作時に test_db データベースの idx1_test_tbl1（__idx_500126_idx1_test_tbl1）インデックスが 1 回アクセスされ、最後にアクセスされた時刻が 2024-01-24 11:09:30.928232 であることを示しています。

      フィールドの説明：

      • OBJECT_ID：インデックステーブルID。
      • NAME：インデックステーブル名。
      • OWNER：データベース名。
      • TOTAL_ACCESS_COUNT：合計アクセス回数。
      • TOTAL_EXEC_COUNT：合計実行回数。
      • LAST_USED：インデックステーブルが最後に使用された時刻。

      ビュー DBA_INDEX_USAGE のフィールドの詳細については、DBA_INDEX_USAGEを参照してください。

関連ドキュメント

• テーブルの作成
• インデックスの作成
• インデックスの削除