インデックスの監視

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 sys.GV$OB_PARAMETERS WHERE name LIKE '%iut_stat_collection%';

次のSQLステートメントを使用して、監視対象のインデックス情報収集モードを設定します：

ALTER SYSTEM SET "_iut_stat_collection_type"='ALL';

例

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

   CREATE TABLE tbl1 (col1 NUMBER PRIMARY KEY, col2 VARCHAR(50) NOT NULL, col3 NUMBER);
   

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

   CREATE INDEX idx1_tbl1 ON tbl1(col3);
   

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

   INSERT INTO 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. COMMIT; を実行します。

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

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

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

   +------+-------+
   | COL1 | COL2  |
   +------+-------+
   |    5 | name5 |
   |    4 | name4 |
   +------+-------+
   2 rows in set
   

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

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

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

   Empty set
   

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

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

      ALTER SYSTEM SET "_iut_stat_collection_type"='ALL';
      

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

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

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

      説明

      インデックスモニタリングは統計情報を収集した後、バックグラウンドのスケジュールタスクを通じてデータを内部テーブルに書き込みます。そのため、ビューでインデックス使用状況のモニタリング結果を照会できるまでには、最大で15分ほど待機する必要がある場合があります。

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

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

      +-----------+------------------------+-------+--------------------+------------------+------------------------------+
      | OBJECT_ID | NAME                   | OWNER | TOTAL_ACCESS_COUNT | TOTAL_EXEC_COUNT | LAST_USED                    |
      +-----------+------------------------+-------+--------------------+------------------+------------------------------+
      |    500269 | __idx_500266_IDX1_TBL1 | SYS   |                  1 |                1 | 24-JAN-24 02.28.38.264523 PM |
      +-----------+------------------------+-------+--------------------+------------------+------------------------------+
      1 row in set
      

      クエリ結果の説明：

      TOTAL_ACCESS_COUNT フィールドは、SELECT 操作時に SYS スキーマの idx1_tbl1（__idx_500266_IDX1_TBL1）という名前のインデックスが 1 回アクセスされ、最後にアクセスされた時間が 24-JAN-24 02.28.38.264523 PM であることを示しています。

      フィールドの説明は以下のとおりです：

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

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

関連ドキュメント

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