ALTER STREAM¶
Modifie les propriétés, les colonnes ou les contraintes d’un flux existant.
- Voir aussi :
CREATE STREAM , DROP STREAM , SHOW STREAMS , DESCRIBE STREAM
Syntaxe¶
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
Paramètres¶
name
Identificateur du flux à modifier. Si l’identificateur contient des espaces ou des caractères spéciaux, toute la chaîne doit être délimitée par des guillemets doubles. Les identificateurs entre guillemets doubles sont également sensibles à la casse.
SET ...
Spécifie les propriétés à définir pour le flux :
TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]
Spécifie le nom de la balise et la valeur de la chaîne de la balise.
La valeur de la balise est toujours une chaîne de caractères et le nombre maximum de caractères pour la valeur de la balise est 256.
Pour plus d’informations sur la spécification des balises dans une instruction, voir Quotas de balises pour les objets et les colonnes.
COMMENT = 'string'
Ajoute un commentaire ou écrase un commentaire existant pour le flux.
UNSET ...
Spécifie un(e) ou plusieurs paramètres/propriétés à désactiver pour le flux, ce qui les réinitialise à leurs valeurs par défaut :
TAG tag_key [ , tag_key ... ]
COMMENT
Notes sur l’utilisation¶
Concernant les métadonnées :
Attention
Les clients doivent s’assurer qu’aucune donnée personnelle (autre que pour un objet utilisateur), donnée sensible, donnée à exportation contrôlée ou autre donnée réglementée n’est saisie comme métadonnée lors de l’utilisation du service Snowflake. Pour plus d’informations, voir Champs de métadonnées dans Snowflake.
Exemples¶
Ajouter un commentaire pour un flux :
ALTER STREAM mystream SET COMMENT = 'New comment for stream';