ALTER BUDGET

Vollqualifizierter Name: SNOWFLAKE.CORE.BUDGET

Bearbeitet die Eigenschaften eines kundenspezifischen Budgets:

  • Umbenennen des Budgets

  • Zuordnen oder Entziehen eines Tags

  • Zuordnen oder Entziehen des Kommentars

Siehe auch:

CREATE BUDGET, SHOW BUDGET, DROP BUDGET

Syntax

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> RENAME TO <new_name>

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> UNSET COMMENT

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

ALTER SNOWFLAKE.CORE.BUDGET [ IF EXISTS ] <name> UNSET TAG <tag_name> [ , <tag_name> ... ]
Copy

Parameter

name

Gibt den Bezeichner (d. h. den Namen) des Budgets an.

Wenn der Bezeichner Leerzeichen oder Sonderzeichen enthält, muss die gesamte Zeichenfolge in doppelte Anführungszeichen gesetzt werden. Bei Bezeichnern, die in doppelte Anführungszeichen eingeschlossen sind, ist auch die Groß- und Kleinschreibung zu beachten.

Weitere Informationen dazu finden Sie unter Anforderungen an Bezeichner.

SET ...

Gibt eine oder mehrere Budget-Eigenschaften an, die festgelegt werden sollen.

COMMENT = 'string_literal'

Legt den Kommentar zum Budget fest. Dies kann auch mit dem Befehl COMMENT erfolgen.

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

Gibt den Namen des Tags und den Wert der Tag-Zeichenfolge an.

Der Tag-Wert ist immer eine Zeichenfolge, die maximale 256 Zeichen lang sein kann.

Weitere Informationen zur Angabe von Tags in einer Anweisung finden Sie unter Tag-Kontingente für Objekte und Spalten.

UNSET ...

Gibt eine (oder mehrere) Eigenschaften und/oder Parameter an, deren Einstellung für das Budget wieder aufgehoben werden sollen, wodurch sie auf die Standardwerte zurückgesetzt werden:

  • COMMENT

  • TAG tag_name [ , tag_name ... ]

Anforderungen an die Zugriffssteuerung

Eine Rolle, die zur Ausführung dieses SQL-Befehls verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung / Rolle

Objekt

Anmerkungen

ADMIN

Budget

Der Rolle, die zum Bearbeiten der Eigenschaften eines kundenspezifischen Budgets verwendet wird, muss diese Instanzrolle zugewiesen sein.

Beachten Sie, dass für die Bearbeitung eines Objekts in einem Schema auch die Berechtigung USAGE für die übergeordnete Datenbank und das Schema erforderlich ist.

Weitere Informationen dazu finden Sie unter Rollen und Berechtigungen für Budgets.

Nutzungshinweise

  • Sie können die Eigenschaften nur für ein kundenspezifisches Budget bearbeiten.

  • Um auf diese Klasse über deren nicht qualifizierten Namen zu verweisen, fügen Sie die Datenbank und das Schema der Klasse in Ihren Suchpfad ein.

Beispiele

Legen Sie das Tag dept für das Budget my_budget im aktuellen Schema fest:

ALTER SNOWFLAKE.CORE.BUDGET my_budget SET TAG dept = 'finance';
Copy