ApsaraDB for SelectDB:ブルームフィルターインデックス

テーブルの作成時にインデックスを作成する

テーブル作成時に Bloom フィルターインデックスを作成する場合、テーブル作成ステートメントの PROPERTIES に "bloom_filter_columns"="k1,k2,k3" 設定を追加できます。この例では、k1,k2,k3 は、Bloom フィルターインデックスを作成するキー列の名前を示しています。

次のサンプルコードは、 テーブルに と のブルームフィルターインデックスを作成する方法の例を示しています。 saler_idcategory_id の sale_detail_bloom テーブル。

CREATE TABLE IF NOT EXISTS sale_detail_bloom(
    sale_date date NOT NULL COMMENT "販売日",
    customer_id int NOT NULL COMMENT "顧客 ID",
    saler_id int NOT NULL COMMENT "販売者 ID",
    sku_id int NOT NULL COMMENT "商品 ID",
    category_id int NOT NULL COMMENT "商品が属するカテゴリ ID",
    sale_count int NOT NULL COMMENT "販売数量",
    sale_price DECIMAL(12,2) NOT NULL COMMENT "商品単価",
    sale_amt DECIMAL(20,2) COMMENT "総売上高"
)
Duplicate KEY(sale_date, customer_id, saler_id, sku_id, category_id)
distributed BY hash(customer_id) buckets 3
PROPERTIES("bloom_filter_columns"="saler_id, category_id");

既存のテーブルにインデックスを作成する

既存のテーブルの bloom_filter_columns パラメーターを変更するには、次のステートメントを実行して、既存のテーブルにインデックスを作成します。

ALTER TABLE <db.table_name> SET ("bloom_filter_columns" = "k1,k3");

インデックスを表示する

テーブルに作成されたブルームフィルターインデックスを表示するには、次のステートメントを実行します。

SHOW CREATE TABLE <table_name>;

sale_detail_bloom テーブルに作成されたブルームフィルターインデックスをクエリする方法の例を次に示します。

SHOW CREATE TABLE sale_detail_bloom;

次の結果が返されます。

+-------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Table             | Create Table                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+-------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| sale_detail_bloom | CREATE TABLE `sale_detail_bloom` (
  `sale_date` datev2 NOT NULL COMMENT '販売日',
  `customer_id` int(11) NOT NULL COMMENT '顧客 ID',
  `saler_id` int(11) NOT NULL COMMENT '販売者 ID',
  `sku_id` int(11) NOT NULL COMMENT '商品 ID',
  `category_id` int(11) NOT NULL COMMENT '商品が属するカテゴリ ID',
  `sale_count` int(11) NOT NULL COMMENT '販売数量',
  `sale_price` decimalv3(12, 2) NOT NULL COMMENT '商品単価',
  `sale_amt` decimalv3(20, 2) NULL COMMENT '総売上高'
) ENGINE=OLAP
DUPLICATE KEY(`sale_date`, `customer_id`, `saler_id`, `sku_id`, `category_id`)
COMMENT 'OLAP'
DISTRIBUTED BY HASH(`customer_id`) BUCKETS 3
PROPERTIES (
"bloom_filter_columns" = "category_id, saler_id",
"light_schema_change" = "true"
);                               |
+-------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
1 row in set (0.03 sec)

インデックスの削除

ブルームフィルターインデックスを削除するには、次のステートメントを実行します。削除中に、インデックス列の bloom_filter_columns パラメーターが削除されます。

ALTER TABLE <db.table_name> SET ("bloom_filter_columns" = "");

インデックス変更の進捗状況のクエリ

インデックスの作成、変更、および削除は非同期です。インデックス変更の進捗状況を表示するには、次のステートメントを実行します。

SHOW ALTER TABLE COLUMN;

ベストプラクティス

次の条件が満たされている場合、列にブルームフィルターインデックスを作成できます。

• データはプレフィックスに基づいてフィルタリングされません。

• クエリ対象のデータは、列に基づいて頻繁にフィルタリングされ、ほとんどのフィルター条件には in と = が含まれます。

• ビットマップインデックスとは異なり、ブルームフィルターインデックスは、ユーザー ID を格納する列など、カーディナリティの高い列に適しています。これは、ユーザーの性別を格納する列など、カーディナリティの低い列にブルームフィルターインデックスを作成すると、各ブロックにほぼすべての値が含まれるためです。この場合、ブルームフィルターインデックスはクエリのパフォーマンスを向上させません。