Kategorien:

DDL für Benutzer und Sicherheit

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;