検索最適化の有効化と無効化¶

必要なアクセス制御権限¶

テーブルの検索最適化を追加、構成、または削除するには、次が必要です。

• テーブルに対する OWNERSHIP 権限を所有します。

• テーブルを含むスキーマに対する ADD SEARCH OPTIMIZATION 権限を所有します。この権限を付与するには:

  GRANT ADD SEARCH OPTIMIZATION ON SCHEMA <schema_name> TO ROLE <role>
  

  Copy

クエリに検索最適化サービスを使用するには、テーブルに対する SELECT 権限が必要。

その他の追加の権限は必要ありません。SEARCH OPTIMIZATION はテーブルプロパティであるため、テーブルのクエリ時に自動的に検出され、（適切な場合は）使用されます。

検索最適化の構成¶

検索最適化を有効にする場合、テーブル全体またはテーブル内の特定の列に対して有効にするかどうかを選択できます。

• テーブル全体の検索最適化を有効にすると、対象となるすべての列に対するポイントルックアップクエリが可能になります。

  テーブル全体の検索最適化を有効にするには、 ON 句を使用 せずに ALTER TABLE ... ADD SEARCH OPTIMIZATION コマンドを使用します。

• 特定の列の検索最適化を有効にすると、クエリであまり使用しない列の検索アクセスパスの作成にクレジットを費やす必要がなくなります。また、列ごとに最適化するクエリの種類を追加選択できるため、パフォーマンスがさらに向上する可能性があります。

  ALTER TABLE ... ADD SEARCH OPTIMIZATION コマンド の ON 句 を使用して、最適化するクエリの種類を指定し、特定の列の検索最適化を有効にします。ADD SEARCH OPTIMIZATION の ON 句で、検索最適化を有効にする列を指定します。特定の列の検索最適化を有効にすると、検索方法も指定できます (たとえば、等価検索と IN 検索の場合は EQUALITY 、 GEOGRAPHY 検索の場合は GEO 、部分文字列検索の場合は SUBSTRING)。

一般的には、特定の列に対してのみ検索最適化を有効にするのがベストプラクティスです。

次のセクションでは、テーブルの検索最適化を構成する方法について説明します。

• 特定の列に対する検索最適化の有効化

• テーブル全体に対する検索最適化の有効化

検索最適化を構成した後、設定が正しいかどうかを検査することができます。

• テーブルが検索最適化用に構成されていることの確認

検索最適化が十分な利益をもたらさないことが判明した場合、特定の列またはテーブル全体から検索最適化を削除することができます。

• 特定の列またはテーブル全体からの検索最適化の削除

特定の列に対する検索最適化の有効化¶

特定の列の検索最適化を構成するには、 ALTER TABLE ... ADD SEARCH OPTIMIZATION コマンドを ON 句と合わせて使用します。

ON 句は、特定の列の検索最適化を構成することを指定します。構文の詳細については、 ALTER TABLE ... ADD SEARCH OPTIMIZATION のセクション をご参照ください。

このコマンドを実行すると、 列が検索最適化用に構成されていることを確認できます。

次のセクションには、検索最適化の構成を指定する方法を示す例が含まれています。

• 例: 特定の列に対する等価および IN 述語のサポート

• 例: 該当するすべての列に対する等価および IN 述部のサポート

• 例: さまざまなタイプの述語のサポート

• 例: VARIANT のフィールドに対する等価および IN 述語のサポート

• 例: 地理空間関数のサポート

ALTER TABLE t1 ADD SEARCH OPTIMIZATION ON EQUALITY(c1, c2, c3);

-- This statement is equivalent to the previous statement.
ALTER TABLE t1 ADD SEARCH OPTIMIZATION ON EQUALITY(c1), EQUALITY(c2, c3);

ALTER TABLE t1 ADD SEARCH OPTIMIZATION ON EQUALITY(*);

ALTER TABLE t1 ADD SEARCH OPTIMIZATION ON EQUALITY(c1, c2), SUBSTRING(c3);

ALTER TABLE t1 ADD SEARCH OPTIMIZATION ON EQUALITY(c4:user.uuid);

ALTER TABLE t1 ADD SEARCH OPTIMIZATION ON GEO(c1);

テーブル全体に対する検索最適化の有効化¶

サポートされているデータ型 (VARIANT および GEOGRAPHY を除く) のすべての列に EQUALITY を指定する場合は、 ON 句なしで ALTER TABLE ... ADD SEARCH OPTIMIZATION コマンドを使用します。

例:

alter table test_table add search optimization;

構文の詳細については、 ALTER TABLE にある検索最適化のセクション をご参照ください。

このコマンドを実行すると、 列が検索最適化用に構成されていることを確認できます。

テーブルが検索最適化用に構成されていることの確認¶

テーブルとその列が検索最適化用に構成されていることを確認するには、

1. テーブルとその列の 検索最適化構成を表示 します。

2. SHOW TABLES コマンドを実行して、検索最適化が追加されていることを確認し、テーブルがどの程度最適化されているかを判断します。

   例:

   SHOW TABLES LIKE '%test_table%';
   

   Copy

   このコマンドの出力により、

   • SEARCH_OPTIMIZATION が ON であることを確認します。これは、検索最適化が追加されたことを示しています。

   • SEARCH_OPTIMIZATION_PROGRESS の値を確認します。これは、これまでに最適化されたテーブルの割合を指定します。

     検索最適化が最初にテーブルに追加されたとき、パフォーマンスの利点はすぐには現れません。検索最適化サービスは、バックグラウンドでデータの入力を開始します。メンテナンスがテーブルの現在の状態に追いつくにつれて、利点の増加が明らかになります。

     クエリを実行して検索最適化が機能していることを確認する前に、テーブルが完全に最適化されたことを示すまで待ちます。

3. クエリを実行して、検索最適化が機能していることを確認します。

   Snowflakeオプティマイザーは、特定のクエリに対して検索最適化サービスをいつ使用するかを自動的に選択することに注意してください。ユーザーは、どのクエリ検索最適化を使用するかについては制御できません。

   検索最適化サービスが最適化するように設計されているクエリを選択します。 検索最適化によるメリットを受け得るクエリの特定 をご参照ください。

4. ウェブ UI で、このクエリのクエリプランを表示し、クエリノード「検索最適化アクセス」がクエリプランの一部であることを確認します。

テーブルの検索最適化構成の表示¶

テーブルの検索最適化構成を表示するには、 DESCRIBE SEARCH OPTIMIZATION コマンドを使用します。

たとえば、次のステートメントを実行して、列の検索最適化を構成するとします。

ALTER TABLE t1 ADD SEARCH OPTIMIZATION ON EQUALITY(c1);

DESCRIBE SEARCH OPTIMIZATION を実行すると、次の出力が生成されます。

DESCRIBE SEARCH OPTIMIZATION ON t1;

+---------------+----------+--------+------------------+--------+
| expression_id |  method  | target | target_data_type | active |
+---------------+----------+--------+------------------+--------+
| 1             | EQUALITY | C1     | NUMBER(38,0)     | true   |
+---------------+----------+--------+------------------+--------+

特定の列またはテーブル全体からの検索最適化の削除¶

特定の列に対する検索最適化構成を削除できます。または、テーブル全体から SEARCH OPTIMIZATION プロパティを削除できます。

• 特定の列に対する検索最適化のドロップ

• テーブルからの検索最適化の削除

DESCRIBE SEARCH OPTIMIZATION ON t1;

+---------------+-----------+-----------+-------------------+--------+
| expression_id |  method   | target    | target_data_type  | active |
+---------------+-----------+-----------+-------------------+--------+
|             1 | EQUALITY  | C1        | NUMBER(38,0)      | true   |
|             2 | EQUALITY  | C2        | VARCHAR(16777216) | true   |
|             3 | EQUALITY  | C4        | NUMBER(38,0)      | true   |
|             4 | EQUALITY  | C5        | VARCHAR(16777216) | true   |
|             5 | EQUALITY  | V1        | VARIANT           | true   |
|             6 | SUBSTRING | C2        | VARCHAR(16777216) | true   |
|             7 | SUBSTRING | C5        | VARCHAR(16777216) | true   |
|             8 | GEO       | G1        | GEOGRAPHY         | true   |
|             9 | EQUALITY  | V1:"key1" | VARIANT           | true   |
|            10 | EQUALITY  | V1:"key2" | VARIANT           | true   |
+---------------+-----------+-----------+-------------------+--------+

ALTER TABLE t1 DROP SEARCH OPTIMIZATION ON SUBSTRING(c2);

ALTER TABLE t1 DROP SEARCH OPTIMIZATION ON c5;

ALTER TABLE t1 DROP SEARCH OPTIMIZATION ON EQUALITY(c1), 6, 8;