ALTER CORTEX SEARCH SERVICE

修改现有 Cortex Search 服务 的属性。

语法

ALTER CORTEX SEARCH SERVICE [ IF EXISTS ] <name>
  { SUSPEND | RESUME } [ { INDEXING | SERVING } ]

ALTER CORTEX SEARCH SERVICE [ IF EXISTS ] <name> SET
  [ TARGET_LAG = { '<num> { seconds | minutes | hours | days }' } ]
  [ WAREHOUSE = <warehouse_name> ]
  [ COMMENT = '<string_literal>' ];
Copy

参数

name

指定要更改的 Cortex Search 服务的标识符。

如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

有关更多信息，请参阅 标识符要求。

{ SUSPEND | RESUME } ...

暂停或恢复对 Cortex Search 服务的索引和/或服务。您可指定以下关键字之一，以指示暂停或恢复哪层：

INDEXING

指示 Cortex Search 服务的索引层的目标。有关更多详细信息，请参阅 使用说明。

SERVING

指示 Cortex Search 服务的服务层的目标。有关更多详细信息，请参阅 使用说明。

如果未指定任何关键字，则会暂停或恢复索引层和服务层。

SET ...

为 Cortex Search 服务设置一个或多个指定的属性或参数：

TARGET_LAG = 'num { seconds | minutes | hours | days }'

指定 Cortex Search 服务内容应滞后于源查询中指定的基表更新的最长时间。

WAREHOUSE = warehouse_name

指定要用于运行源查询、构建搜索索引并按 TARGET_LAG 目标保持对其进行刷新的仓库。

COMMENT = 'string_literal'

添加注释或覆盖搜索服务的现有注释。

访问控制要求

权限

对象

OWNERSHIP

要修改其属性的 Cortex Search 服务。

请注意，对架构中的对象进行操作还需要对父数据库和架构具有 USAGE 权限。

有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

使用说明

注意

客户应确保在使用 Snowflake 服务时，不会将个人数据（用户对象除外）、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息，请参阅 Snowflake 中的元数据字段。

INDEXING 和 SERVING 状态

INDEXING 是指示 Cortex Search 服务的索引层的目标。处于 RUNNING 状态时，由服务的源查询引用的基表中的更改将提示刷新作为搜索索引一部分存储的物化数据。这些刷新以仓库计算和向量嵌入的形式产生成本。处于 SUSPENDED 状态时，基表的更改不会触发刷新，也不会反映在 Cortex Search 服务的可查询数据中。

SERVING 是指示 Cortex Search 服务的服务层的目标。此目标必须处于 RUNNING 状态才能查询服务。当处于暂停状态时，Cortex Search 服务将不会以 Cortex Search 服务成本的形式产生计费。

有关详细的成本注意事项，请参阅 成本注意事项。

Cortex Search 服务的 INDEXING 层和 SERVING 层可以独立管理。例如，如果 SERVING 处于正在运行状态，而 INDEXING 处于暂停 状态，则您仍可查询服务。但是，在恢复 INDEXING 并成功完成刷新之前，无论 TARGET_LAG 如何，该服务都不会反映基础数据中的任何更改。

相反，如果 INDEXING 在 SERVING 暂停时正在运行，则索引将继续刷新。SERVING 恢复后，变为可查询的已加载索引将反映最新的源数据。

未指定 SERVING 或 INDEXING 关键字时，这两个目标都将受到指定操作的影响。

示例

以下示例将名为 mysvc 的 Cortex Search 服务使用的仓库更改为 my_new_wh：

ALTER CORTEX SEARCH SERVICE mysvc SET WAREHOUSE = my_new_wh;
Copy

以下示例将名为 mysvc 的 Cortex Search 服务的注释字段设置为 new_comment：

ALTER CORTEX SEARCH SERVICE mysvc SET COMMENT = 'new_comment';
Copy

以下示例将名为 mysvc 的 Cortex Search 服务的目标刷新延迟更改为 1 hour：

ALTER CORTEX SEARCH SERVICE mysvc SET TARGET_LAG = '1 hour';
Copy

以下示例暂停了名为 mysvc 的 Cortex Search 服务的提供：

ALTER CORTEX SEARCH SERVICE mysvc SUSPEND SERVING;
Copy
语言: 中文