ALTER ONLINE FEATURE TABLE¶
修改现有 在线特征表 的属性。
- 另请参阅:
CREATE ONLINE FEATURE TABLE、DESCRIBE ONLINE FEATURE TABLE、DROP ONLINE FEATURE TABLE、SHOW ONLINE FEATURE TABLES
语法¶
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> { SUSPEND | RESUME }
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> RENAME TO <new_name>
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> REFRESH
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> SET
[ TARGET_LAG = '<num> { seconds | minutes | hours | days }' ]
[ WAREHOUSE = <warehouse_name> ]
ALTER ONLINE FEATURE TABLE [ IF EXISTS ] <name> <tagAction>
参数¶
name指定要更改的在线特征表的标识符。
如果标识符包含空格或特殊字符,则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。
有关更多信息,请参阅 标识符要求。
RENAME TO new_name将在线特征表的名称更改为
new_name。新的标识符必须在架构中是唯一的。有关标识符的更多详细信息,请参阅 标识符要求。
重命名对象时,引用该对象的其他对象必须使用新名称进行更新。
SUSPEND | RESUME指定是暂停还是恢复表中数据的定期后台刷新。
SUSPEND暂停在线特征表的定期后台刷新。
RESUME恢复在线特征表的定期后台刷新。
REFRESH指定必须手动刷新在线特征表。
SET ...为在线特征表设置一个或多个指定的属性或参数:
TARGET_LAG = 'num { seconds | minutes | hours | days }'指定用于定义后台刷新计划的新目标滞后。
必须是介于 10 秒和 8 天之间的值(含 10 秒和 8 天)。
WAREHOUSE = warehouse_name指定提供计算资源以刷新在线特征表的新仓库的名称。
COMMENT = 'string_literal'为在线特征表添加注释或覆盖现有注释。
tagAction设置或取消设置在线特征表上的标签:
tagAction ::= { SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ] | UNSET TAG <tag_name> [ , <tag_name> ... ] }
SET TAG在在线特征表上设置指定的标签和标签值。
UNSET TAG取消设置在线特征表上的指定标签。
访问控制要求¶
权限 |
对象 |
备注 |
|---|---|---|
OWNERSHIP |
在线特征表 |
对在线特征表具有 OWNERSHIP 权限的角色。 |
USAGE |
仓库 |
更改仓库时需要 |
有关创建具有指定权限集的自定义角色的说明,请参阅 创建自定义角色。
使用说明¶
关于元数据:
注意
客户应确保在使用 Snowflake 服务时,不会将个人数据(用户对象除外)、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息,请参阅 Snowflake 中的元数据字段。
示例¶
以下示例暂停了名为 my_online_feature_table 的在线特征表的定期后台刷新:
ALTER ONLINE FEATURE TABLE my_online_feature_table SUSPEND;
以下示例手动刷新了名为 my_online_feature_table 的在线特征表:
ALTER ONLINE FEATURE TABLE my_online_feature_table REFRESH;
以下示例更改了名为 my_online_feature_table 的在线特征表的目标滞后:
ALTER ONLINE FEATURE TABLE my_online_feature_table SET TARGET_LAG = '1 minute';
以下示例将在线特征表的名称 my_online_feature_table 更改为 my_new_online_feature_table。
ALTER ONLINE FEATURE TABLE my_online_feature_table RENAME TO my_new_online_feature_table;