<budget_name>!ADD_SHARED_RESOURCE¶

Syntax¶

<budget_name>!ADD_SHARED_RESOURCE( '<domain>' [ , '<instance>' ] )

Argumente¶

'domain'

Der Typ der Ressource, die dem Budget hinzugefügt wird. Gültige Werte:

• AI FUNCTION

• CORTEX CODE

• CORTEX AGENT

• SNOWFLAKE INTELLIGENCE

Wenn Sie kein zweites Argument angeben, verfolgt das Budget den Verbrauch für alle Ressourcen innerhalb der angegebenen Domäne.

'instance'

Optional. Gibt eine bestimmte Ressource innerhalb der ausgewählten domain an, um sie dem Budget hinzuzufügen.

Für Domänen, die eine Auswahl auf Instanzebene unterstützen (z. B. AI FUNCTION und CORTEX CODE), können Sie mit diesem Argument eine bestimmte Funktion oder Schnittstelle verfolgen.

Wenn Sie kein zweites Argument angeben, verfolgt das Budget alle Instanzen innerhalb der Domäne.

Beispiele:

• AI-Funktionen: AI_CLASSIFY, AI_COMPLETE

• Cortex Code: CORTEX_CODE_CLI, CORTEX_CODE_SNOWSIGHT

Die Auswahl auf Instanzebene ist nicht auf alle Domänen anwendbar. Beispiel: CORTEX AGENT und SNOWFLAKE INTELLIGENCE werden derzeit nur auf Domänenebene verfolgt.

Rückgabewerte¶

Gibt einen VARCHAR-Wert zurück, der angibt, ob die Ressource erfolgreich zum Budget hinzugefügt wurde oder nicht.

Wenn die Ressource nicht zum Budget hinzugefügt werden konnte, gibt die Funktion eine Fehlermeldung zurück.

Anforderungen an die Zugriffssteuerung¶

Die folgenden Berechtigungen und Rollen sind erforderlich, um diese Methode für ein kundenspezifisches Budget aufzurufen:

• ADMIN-Instanzrolle für die Budgetinstanz.

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

• USAGE-Berechtigung für die Datenbank und das Schema, die die hinzuzufügende Ressource enthalten (für Schemaobjekte).

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

Nutzungshinweise¶

• Sie können freigegebene Ressourcen nur zu kundenspezifischen Budgets hinzufügen.

• Um die Ergebnisse der Methode zu überprüfen, rufen Sie die GET_BUDGET_SCOPE-Methode auf.

• Wenn alle Objekte des angegebenen Entitätstyps hinzugefügt werden (z. B. alle AI-Funktionen), können Sie keine einzelnen Ressourcen dieses Typs hinzufügen.

• 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¶

Alle AI-Funktionen zum Budget hinzufügen:

CALL finance_budget!ADD_SHARED_RESOURCE('AI FUNCTION');

Eine bestimmte AI-Funktion zum Budget hinzufügen:

CALL finance_budget!ADD_SHARED_RESOURCE('AI FUNCTION', 'AI_CLASSIFY');

Alle Cortex Code-Workloads zum Budget hinzufügen:

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX CODE');

Cortex Code CLI-Workload zum Budget hinzufügen:

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX CODE', 'CORTEX_CODE_CLI');

Cortex Code Snowsight-Workload zum Budget hinzufügen:

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX CODE', 'CORTEX_CODE_SNOWSIGHT');

Cortex Agent-Workloads zum Budget hinzufügen:

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX AGENT');

Alle Snowflake Intelligence-Workloads zum Budget hinzufügen:

CALL finance_budget!ADD_SHARED_RESOURCE('SNOWFLAKE INTELLIGENCE');