ALTER STREAM

修改现有 :doc:` 流 </user-guide/streams>` 的属性、列或约束条件。

另请参阅：

CREATE STREAM、DROP STREAM、SHOW STREAMS、DESCRIBE STREAM

语法

ALTER STREAM [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER STREAM [ IF EXISTS ] <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]

ALTER STREAM <name> UNSET TAG <tag_name> [ , <tag_name> ... ]

ALTER STREAM [ IF EXISTS ] <name> UNSET COMMENT
Copy

参数

name

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

SET ...

指定要为流设置的属性：

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

指定 标签 名称和标签字符串值。

标签值始终为字符串，标签值的最大字符数为 256。

有关在语句中指定标签的信息，请参阅 对象和列的标签配额。

COMMENT = 'string'

为流添加注释或覆盖现有注释。

UNSET ...

指定要为流取消设置的一个或多个属性/参数，这会将它们重置回默认值：

  • TAG tag_key [ , tag_key ... ]

  • COMMENT

使用说明

关于元数据：

注意

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

示例

为流添加注释：

ALTER STREAM mystream SET COMMENT = 'New comment for stream';
Copy
语言: 中文