启用和禁用搜索优化¶

所需的访问控制权限¶

要添加、配置或删除表的搜索优化，您必须：

• 拥有表的 OWNERSHIP 权限。

• 对包含表的架构拥有 ADD SEARCH OPTIMIZATION 权限。要授予此权限，请执行以下操作：

  CopyExpand

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

  Show lessSee more

  Scroll to top

若要使用搜索优化服务进行查询，只需拥有表的 SELECT 权限。

您不需要任何其他权限。由于 SEARCH OPTIMIZATION 是表属性，因此在查询表时，系统会自动检测和使用它（如果适用）。

配置搜索优化¶

启用搜索优化时，可以选择为整个表或表中的特定列启用搜索优化。

• 为整个表启用搜索优化后，可以对所有符合条件的列进行点查询。

  要为整个表启用搜索优化，请使用 :doc:` ALTER TABLE </sql-reference/sql/alter-table>` ...:ref:ADD SEARCH OPTIMIZATION <label-alter_table_searchoptimizationaction_add> 命令，但 不要 使用 ON 子句。

• 为特定列启用搜索优化可避免将 credit 用于为查询中不常使用的列创建搜索访问路径，还允许您为每一列选择其他要优化的查询类型，从而进一步提高性能。

  要启用特定列的搜索优化并指定要优化的查询类型，请在 ALTER TABLE ... ADD SEARCH OPTIMIZATION 命令 <label-search_optimization_service_configuration_adding>` 中使用 :ref:`ON 子句。在 ADD SEARCH OPTIMIZATION 的 ON 子句中，可以指定为哪些列应启用搜索优化。为给定列启用搜索优化时，您还可以指定搜索方法（例如 EQUALITY 用于相等和 IN 搜索、GEO 用于 GEOGRAPHY 搜索或 SUBSTRING 用于子字符串搜索）。您可以在同一列上启用多种搜索方法。

• 通过使用 ALTER ICEBERG TABLE ... ADD SEARCH OPTIMIZATION 命令，您可以为整个 Apache Iceberg™ 表或为表中的特定列启用搜索优化。

通常，最佳做法是仅针对特定列启用搜索优化。

以下各节介绍如何为表配置搜索优化：

• 为特定列启用搜索优化

• 为整个表启用搜索优化

配置搜索优化后，可以检查配置是否正确。

• 验证表是否配置了搜索优化

如果发现搜索优化没有带来足够的好处，可以从特定列或整个表中移除搜索优化。

• 从特定列或整个表中移除搜索优化

为特定列启用搜索优化¶

要为特定列配置搜索优化，请使用 ALTER TABLE ...:ref:ADD SEARCH OPTIMIZATION <label-alter_table_searchoptimizationaction_add> 命令与 ON 子句。

ON 子句指定要为特定列配置搜索优化。有关语法的详细信息，请参阅 有关 ALTER TABLE ... ADD SEARCH OPTIMIZATION，在一个或多个账户中创建辅助连接，并将其链接到主连接。

运行此命令后，可以 验证列是否已配置为搜索优化。

以下各节将举例说明如何指定搜索优化配置：

• 示例：特定列上的全文搜索优化

• 示例：支持特定列的相等谓词和 IN 谓词

• 示例：支持所有适用列的相等谓词和 IN 谓词

• 示例：支持不同类型的谓词

• 示例：支持同一列上的不同谓词

• 示例：为 VARIANT 中的元素支持相等谓词和 IN 谓词

• 示例：支持地理空间函数

ALTER TABLE <name> ADD SEARCH OPTIMIZATION
  ON FULL_TEXT( { * | <col1> [ , <col2>, ... ] } [ , ANALYZER => '<analyzer_name>' ]);

ALTER TABLE lines ADD SEARCH OPTIMIZATION
  ON FULL_TEXT(play, character, line);

DESCRIBE SEARCH OPTIMIZATION ON lines;

+---------------+----------------------------+-----------+------------------+--------+
| expression_id | method                     | target    | target_data_type | active |
|---------------+----------------------------+-----------+------------------+--------|
|             1 | FULL_TEXT DEFAULT_ANALYZER | PLAY      | VARCHAR(50)      | true   |
|             2 | FULL_TEXT DEFAULT_ANALYZER | CHARACTER | VARCHAR(30)      | true   |
|             3 | FULL_TEXT DEFAULT_ANALYZER | LINE      | VARCHAR(2000)    | true   |
+---------------+----------------------------+-----------+------------------+--------+

ALTER TABLE ipt ADD SEARCH OPTIMIZATION ON FULL_TEXT(ip1, ANALYZER => 'ENTITY_ANALYZER');

ALTER TABLE lines DROP SEARCH OPTIMIZATION
  ON FULL_TEXT(play, character, line);

ALTER TABLE lines DROP SEARCH OPTIMIZATION
  ON play, character, line;

ALTER TABLE lines DROP SEARCH OPTIMIZATION
  ON 1, 2, 3;

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(c1), SUBSTRING(c1);

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

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

为整个表启用搜索优化¶

为所有受支持数据类型（:doc:` 半结构化 </sql-reference/data-types-semistructured>` 和 GEOGRAPHY 除外）指定 EQUALITY，请使用 ALTER TABLE ...:ref:ADD SEARCH OPTIMIZATION <label-alter_table_searchoptimizationaction_add> 命令，而不使用 ON 子句。

例如：

ALTER TABLE test_table ADD SEARCH OPTIMIZATION;

有关语法的详细信息，请参阅 :ref:` ALTER TABLE 中有关搜索优化的章节 <label-alter_table_searchoptimizationaction>`。

运行此命令后，可以 验证列是否已配置为搜索优化。

验证表是否配置了搜索优化¶

要验证表及其列是否已配置搜索优化，请执行以下操作：

1. 显示表及其列的搜索优化配置。

2. 运行 SHOW TABLES 命令验证是否已添加搜索优化，并确定表的优化程度。

   例如：

   CopyExpand

   SHOW TABLES LIKE '%test_table%';
   

   Show lessSee more

   Scroll to top

   在此命令的输出中：

   • 验证 SEARCH_OPTIMIZATION 是否为 ON，确定是否已添加搜索优化。

   • 检查 SEARCH_OPTIMIZATION_PROGRESS 的值。这个值指定了迄今为止已优化的表的百分比。

     搜索优化首次添加到表时，性能优势不会立即显现。搜索优化服务会在后台开始填充数据。当维护跟上表的当前状态时，优势就会逐渐显现。

     在运行查询以验证搜索优化是否正常工作之前，请等待查询显示表已完全优化。

3. 运行查询以验证搜索优化是否有效。

   请注意，Snowflake 优化器会自动选择何时对特定查询使用搜索优化服务。用户无法控制搜索优化用于哪些查询。

   选择搜索优化服务旨在优化的查询。请参阅 识别可从搜索优化中受益的查询。

4. 在 Web UI 中，查看此查询的查询计划，并验证查询节点“Search Optimization Access”是否是查询计划的一部分。

显示表的搜索优化配置¶

要显示表的搜索优化配置，请使用 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;