system-bloomfilter-blocks

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

コマンドプロパティ

構文

対象

TABLE

照会するテーブル名。必須です。

INDEX

照会するインデックス名。必須です。

[DAY]

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

[SK]

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

[ERA]

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

出力フィールド

エラーコード

パースエラー

ランタイムエラー

説明

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

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

DAY、SK、ERAは位置引数として順番に指定します。DAYを指定しない場合は全パーティションにわたって照会します。SKとERAはDAYを指定した場合にのみ意味があり、パーティションをより精密に特定するときに使用します。

使用例

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

   system-bloomfilter-blocks SONAR_EVENTS default_idx
   

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

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

   system-bloomfilter-blocks SONAR_EVENTS default_idx 20260301
   

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

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

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

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

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

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

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