<budget_name>!SET_SPENDING_LIMIT¶

Syntax¶

<budget_name>!SET_SPENDING_LIMIT(<number>)

Argumente¶

number

Die Anzahl der Credits, die dem Budget pro Monat zugewiesen werden. Wenn die Gesamtnutzung aller dem Budget zugeordneten Objekte diese Zahl für den laufenden Monat erreicht, hat das Budget 100 % des Ausgabenlimits erreicht.

Für das Kontobudget tragen alle von unterstützten Objekte zur Credit-Nutzung bei.

Wenn für ein Budget kein Wert angegeben wird, hat das Budget kein Ausgabenlimit, wird nie 100 % Auslastung erreichen und keine Benachrichtigungen auslösen.

Standardwert: -1 (kein Ausgabenlimit).

Rückgabewerte¶

The spending limit has been updated to <n> credits.

Anforderungen an die Zugriffssteuerung¶

• Die folgenden Mindestberechtigungen und Rollen sind erforderlich, um die Ergebnisse für kundenspezifische Budgets anzuzeigen:

  • ADMIN-Instanzrolle für die Budgetinstanz.

  • USAGE-Berechtigung für die Datenbank und das Schema, die die Budgetinstanz enthalten.

• Die folgende Rolle ist erforderlich, um die Ergebnisse für das Kontobudget anzuzeigen:

  Anwendungsrolle BUDGET_ADMIN für das Kontobudget.

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

Nutzungshinweise¶

• Das Argument number muss eine positive Ganzzahl sein.

• Wenn Sie diese Methode aufrufen, wird das Objekt nicht zurückgegeben. Aus diesem Grund können Sie keine Methodenverkettung verwenden, um eine andere Methode mit dem Rückgabewert dieser Methode aufzurufen. Rufen Sie jede Methode in einer separaten SQL-Anweisung auf.

Beispiele¶

Setzen Sie das Ausgabenlimit für das Kontobudget auf 500 Credits pro Monat:

CALL snowflake.local.account_root_budget!SET_SPENDING_LIMIT(500);

Setzen Sie das Ausgabenlimit für das Budget my_database.my_schema.my_budget auf 100 Credits pro Monat.

CALL my_database.my_schema.my_budget!SET_SPENDING_LIMIT(100);