- Kategorien:
ALTER TAG¶
Ändert die Eigenschaften eines vorhandenen Tags, einschließlich der Umbenennung des Tags.
Alle am Tag vorgenommenen Änderungen werden bei Ausführung der nächsten SQL-Abfrage wirksam, die das Tag verwendet.
- Siehe auch:
Festlegen von Tag-Werten, TAGS-Ansicht, CREATE TAG, DROP TAG, SHOW TAGS
Syntax¶
ALTER TAG [ IF EXISTS ] <name> RENAME TO <new_name>
ALTER TAG [ IF EXISTS ] <name> { ADD | DROP } ALLOWED_VALUES '<val_1>' [ , '<val_2>' , [ ... ] ]
ALTER TAG <name> UNSET ALLOWED_VALUES
ALTER TAG [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'
ALTER TAG [ IF EXISTS ] <name> UNSET COMMENT
Parameter¶
Name
Bezeichner für das Tag. Weisen Sie den Tag-Zeichenfolgenwert einem Objekt entweder mit einer CREATE <Objekt>-Anweisung oder einer ALTER <Objekt>-Anweisung zu.
Der Bezeichnerwert muss mit einem alphabetischen Zeichen beginnen und darf keine Leer- oder Sonderzeichen enthalten, es sei denn, die gesamte Bezeichnerzeichenfolge wird in doppelte Anführungszeichen gesetzt (z. B. „Mein Objekt“). Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß-/Kleinschreibung zu beachten.
Weitere Details dazu finden Sie unter Anforderungen an Bezeichner
RENAME TO neuer_Name
Gibt den Bezeichner für das Tag an. Dieser muss für Ihr Schema eindeutig sein. Der neue Bezeichner kann nicht verwendet werden, wenn der Bezeichner bereits für ein anderes Tag verwendet wird.
Weitere Details dazu finden Sie unter Anforderungen an Bezeichner.
ALLOWED_VALUES 'Wert_1' [ , 'Wert_2' , [ ... ] ]
Gibt eine durch Kommas getrennte Liste der möglichen Zeichenfolgenwerte an, die dem Tag zugewiesen werden können, wenn das Tag mit dem entsprechenden CREATE <Objekt>- oder ALTER <Objekt>-Befehl auf einem Objekt festgelegt wird.
Die maximale Anzahl von Tag-Werten in dieser Liste ist 50.
Standard: NULL (alle Zeichenfolgenwerte sind zulässig, auch ein leerer Zeichenfolgenwert (d. h.
' '
)).COMMENT = 'Zeichenfolgenliteral'
Gibt einen Kommentar für das Tag an.
Standard: Kein Wert
UNSET
Gibt eine (oder mehrere) Eigenschaften und/oder Parameter an, deren Einstellung für das Tag wieder aufgehoben werden sollen, wodurch sie auf die Standardwerte zurückgesetzt werden:
COMMENT
ALLOWED_VALUES
Nutzungshinweise¶
Weitere Informationen zur Tag-DDL-Autorisierung finden Sie unter erforderliche Berechtigungen.
Metadaten:
Achtung
Kunden müssen sicherstellen, dass bei der Nutzung des Snowflake-Dienstes keine personenbezogenen Daten (außer für ein Objekt „Benutzer“), sensible Daten, exportkontrollierte Daten oder andere regulierte Daten als Metadaten eingegeben werden. Weitere Informationen dazu finden Sie unter Metadatenfelder in Snowflake.
Beispiele¶
Benennen Sie das Tag cost_center
in cost_center_na
um, wobei na
für Nordamerika steht.
alter tag cost_center rename to cost_center_na;