Hologres:ビットマップインデックス

概要

-- Hologres V2.1 以降でサポートされている構文
CREATE TABLE <table_name> (...) WITH (bitmap_columns = '[<columnName>{:[on|off]}[,...]]');

-- すべての Hologres バージョンでサポートされている構文
CREATE TABLE <table_name> (...);
CALL set_table_property('<table_name>', 'bitmap_columns', '[<columnName>{:[on|off]}[,...]]');

使用上の注意

• 等価クエリ列にビットマップインデックスを指定することをお勧めします。これにより、Hologres はフィルタ条件を満たすデータが存在する行の番号をすばやく見つけることができます。カーディナリティの高い列にビットマップインデックスを指定すると、追加のストレージオーバーヘッドが発生します。カーディナリティの高い列は、列に重複データが少ないことを示します。

• テーブルの各列にビットマップインデックスを指定することはお勧めしません。これは、テーブルの各列にビットマップインデックスを指定すると、追加のストレージオーバーヘッドが発生し、書き込みパフォーマンスに影響を与えるためです。

• JSON 形式のデータが TEXT データ型として格納されている列には、ビットマップインデックスを作成しないことをお勧めします。

制限事項

• ビットマップインデックスをサポートしているのは、列指向テーブルと行と列のハイブリッドテーブルのみです。行指向テーブルはビットマップインデックスをサポートしていません。

• bitmap_columns プロパティで指定された列は null 許容です。

• デフォルトでは、列指向テーブルの TEXT データ型のすべての列がビットマップインデックス列として指定されます。

• トランザクションブロックの外部で、ビットマップインデックス列を変更するためのステートメントを実行できます。変更された列はすぐに有効になりません。ビットマップインデックスはバックエンドで非同期的に構築および削除されます。詳細については、「ALTER TABLE」をご参照ください。

• Hologres V2.0 以降では、bitmap_columns を on または off にのみ設定できます。 auto という値は、bitmap_columns では無効です。

仕組み

ビットマップインデックスとクラスタリングキーの違い

• 類似点:

  ビットマップインデックスとクラスタリングキーは、ファイル内のデータをフィルタリングするために使用されます。

• 相違点:

  ビットマップインデックスは、ファイル番号を使用してデータを見つけるために使用されます。したがって、ビットマップインデックスは等価クエリにより適しています。クラスタリングキーは、ファイル内のデータをソートするために使用されます。したがって、クラスタリングキーは範囲クエリにより適しています。

  ビットマップインデックスと比較して、クラスタリングキーの優先順位が高くなっています。同じ列にクラスタリングキーとビットマップインデックスを指定すると、クエリオプティマイザは優先的にクラスタリングキーを使用してファイルと照合します。次のステートメントは例を示しています。

  • Hologres V2.1 以降でサポートされている構文:

    -- uid、class、および date 列をクラスタリングキーとして指定し、text 列をビットマップインデックスとして指定します。
    
    CREATE TABLE ck_bit_test (
        uid int NOT NULL,
        name text NOT NULL,
        class text NOT NULL,
        date text NOT NULL,
        PRIMARY KEY (uid)
    )
    WITH (
        clustering_key = 'uid,class,date',
        bitmap_columns = 'name,class,date'
    );
    INSERT INTO ck_bit_test VALUES 
    (1,'Bob','1','2022-10-19'),
    (2,'Eric,'3','2022-10-19'),
    (3,'Ada','2','2022-10-20'),
    (4,'Joyce','2','2022-10-20'),
    (5,'Leo,'2','2022-10-18'),
    (6,'Steve','3','2022-10-17'),
    (7,'Dora','3','2022-10-20');

  • すべての Hologres バージョンでサポートされている構文:

    -- -- uid、class、および date 列をクラスタリングキーとして指定し、text 列をビットマップインデックスとして指定します。
    begin;
    create table ck_bit_test (
      uid int not null,
      name text not null,
      class text not null,
      date text not null,
      PRIMARY KEY (uid)
    );
    call set_table_property('ck_bit_test', 'clustering_key', 'uid,class,date');
    call set_table_property('ck_bit_test', 'bitmap_columns', 'name,class,date');
    commit;
    
    INSERT INTO ck_bit_test VALUES
    (1,'Bob','1','2022-10-19'),
    (2,'Eric,'3','2022-10-19'),
    (3,'Ada','2','2022-10-20'),
    (4,'Joyce','2','2022-10-20'),
    (5,'Leo,'2','2022-10-18'),
    (6,'Steve','3','2022-10-17'),
    (7,'Dora','3','2022-10-20');

  • uid、class、および date 列をクエリする場合、SQL クエリステートメントは左端一致原則に準拠し、クエリはクラスタリングキーにヒットします。等価クエリでも、ビットマップインデックスではなくクラスタリングキーが使用されます。

    SELECT * FROM clustering_test WHERE uid = '3' AND class ='2' AND date > '2022-10-17';

    次の図は、実行プランに Bitmap Filter 演算子ではなく Cluster Filter 演算子が含まれていることを示しています。これは、クエリでビットマップインデックスではなくクラスタリングキーが使用されていることを示します。

  • uid、class、および date 列をクエリし、class 列のクエリが範囲クエリである場合、SQL ステートメントで指定された範囲のデータが一致した後、クエリ中に左端一致原則は機能しません。この場合、date 列のクエリは、クエリステートメントが左端一致原則に従っていないため、クラスタリングキーにヒットできません。 date 列にビットマップインデックスを指定すると、クエリでビットマップインデックスが使用されます。

    SELECT * FROM clustering_test WHERE uid = '3' AND class >'2' AND date = '2022-10-17';

    次の図は、実行プランに Cluster Filter 演算子と Bitmap Filter 演算子の両方が含まれていることを示しています。これは、uid および class 列のクエリでクラスタリングキーが使用され、date 列のクエリでビットマップインデックスが使用されていることを示します。

例

• Hologres V2.1 以降でサポートされている構文:

  CREATE TABLE tbl (
      a text NOT NULL,
      b text NOT NULL
  )
  WITH (
      bitmap_columns = 'a:on,b:off'
  );
  
  -- bitmap_columns プロパティを変更します。
  ALTER TABLE tbl SET (bitmap_columns = 'a:off');-- ALTER TABLE ステートメントは、すべての列に対してのみ bitmap_columns プロパティの変更をサポートしています。

• すべての Hologres バージョンでサポートされている構文:

  // tbl という名前のテーブルを作成し、ビットマップインデックスを設定します。
  begin; create table tbl (
    a text not null,
    b text not null
  );
  call set_table_property('tbl', 'bitmap_columns', 'a:on,b:off');
  commit;
  
  
  -- ビットマップインデックスを変更します。
  call set_table_property('tbl', 'bitmap_columns', 'a:off');-- すべての列の bitmap_columns プロパティを変更します。列 a に指定されたビットマップインデックスを削除します。
  call update_table_property('tbl', 'bitmap_columns', 'b:off');-- 列 b の bitmap_columns プロパティを変更します。列 b に指定されたビットマップインデックスを削除し、列 a に指定されたビットマップインデックスを保持します。

関連情報

Hologres 内部テーブルの DDL ステートメントの詳細については、以下のトピックを参照してください。

• CREATE TABLE

• CREATE TABLE AS

• CREATE TABLE LIKE

• ALTER TABLE

• DROP TABLE