system-bloomfilter-blocks

指定したテーブルとインデックスに構成されたブルームフィルターインデックスのブロックメタデータを照会します。

コマンドプロパティ

構文

オプション

table=TABLE

照会するテーブル名。必須オプションです。

index=INDEX

照会するインデックス名。必須オプションです。

day=DATE

パーティションの日付。yyyyMMdd形式で指定します。指定しない場合は全パーティションを照会します。

sk=HEX

パーティションのサブキー。16進数のlong値で指定します。指定しない場合は照会範囲を制限しません。

era=LONG

パーティション識別子。10進数の整数で指定します。指定しない場合は照会範囲を制限しません。

出力フィールド

エラーコード

パースエラー

ランタイムエラー

説明

system-bloomfilter-blocksコマンドは、ブルームフィルターインデックスを構成するブロックのメタデータを照会します。ブルームフィルターインデックスは複数のレベルで構成でき、各レベルは複数のブロックで構成されます。ブロック一つは特定のセグメントID範囲（min_seg_id〜max_seg_id）をカバーし、データファイル内の格納位置（offset、size）を含みます。

指定したインデックスがブルームフィルターを使用しないように構成されている場合、結果を返しません。

day、sk、eraオプションで照会範囲を絞り込めます。dayを指定しない場合は全パーティションにわたって照会します。skはdayと一緒に指定した場合にのみ照会範囲に反映され、eraはdayを指定しなくても該当識別子のパーティションのみを照会します。

使用例

1. 特定テーブルインデックスのブルームフィルターブロックを照会

   system-bloomfilter-blocks table=SONAR_EVENTS index=default_idx
   

   SONAR_EVENTSテーブルのdefault_idxインデックスに対する全ブルームフィルターブロックリストを照会します。

2. 特定日付パーティションのブルームフィルターブロックを照会

   system-bloomfilter-blocks table=SONAR_EVENTS index=default_idx day=20260301
   

   SONAR_EVENTSテーブルのdefault_idxインデックスで2026年3月1日パーティションのブルームフィルターブロックを照会します。

3. レベル別ブロック数を集計

   system-bloomfilter-blocks table=SONAR_EVENTS index=default_idx
   | stats count() as block_count by level
   | order level
   

   SONAR_EVENTSテーブルのdefault_idxインデックスでブルームフィルターレベル別ブロック数を照会します。

4. ブロックデータサイズの合計を照会

   system-bloomfilter-blocks table=SONAR_EVENTS index=default_idx
   | stats sum(size) as total_bytes by level
   | eval total_kb = round(total_bytes / 1024, 2)
   | fields level, total_kb
   

   レベル別のブルームフィルターブロックデータの合計サイズをKB単位で照会します。

変更履歴

system-bloomfilter-blocks コマンドはSonar 4.0以前のバージョンから提供されています。