ALTER STREAM

Modifica as propriedades, colunas ou restrições de um fluxo existente.

Consulte também:

CREATE STREAM , DROP STREAM , SHOW STREAMS , DESCRIBE STREAM

Sintaxe

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

Parâmetros

name

Identificador do fluxo a ser alterado. Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

SET ...

Especifica as propriedades a serem definidas para o fluxo:

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

Especifica o nome da tag e o valor da cadeia de caracteres dela.

O valor de tag é sempre uma cadeia de caracteres, e o número máximo de caracteres do valor da tag é 256.

Para obter mais detalhes sobre como especificar tags em uma instrução, consulte Cotas de tags para objetos e colunas.

COMMENT = 'string'

Adiciona um comentário ou substitui um comentário existente do fluxo.

UNSET ...

Especifica uma ou mais propriedades/parâmetros a serem removidos do fluxo, o que os restaura aos seus padrões:

  • TAG tag_key [ , tag_key ... ]

  • COMMENT

Notas de uso

Em relação aos metadados:

Atenção

Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

Exemplos

Adicionar um comentário para um fluxo:

ALTER STREAM mystream SET COMMENT = 'New comment for stream';
Copy