<budget_name> !ADD_SHARED_RESOURCE¶

Syntaxe¶

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

Arguments¶

'domain'

Le type de ressource ajouté au budget. Valeurs valides :

• AI FUNCTION

• CORTEX CODE

• CORTEX AGENT

• SNOWFLAKE INTELLIGENCE

À moins que vous ne spécifiiez un deuxième argument, le budget suit la consommation de toutes les ressources du domaine spécifié.

'instance'

En option. Spécifie une ressource spécifique dans le domain sélectionné à ajouter au budget.

Pour les domaines qui prennent en charge la sélection au niveau de l’instance (tels que``AI FUNCTION`` et CORTEX CODE), cet argument vous permet de suivre une fonction ou une interface spécifique.

Si vous ne spécifiez pas de deuxième argument, le budget suit toutes les instances du domaine.

Exemples :

• Fonctions AI : AI_CLASSIFY, AI_COMPLETE

• Cortex Code : CORTEX_CODE_CLI, CORTEX_CODE_SNOWSIGHT

La sélection au niveau de l’instance n’est pas applicable à tous les domaines. Par exemple, CORTEX AGENT et SNOWFLAKE INTELLIGENCE sont actuellement suivis au niveau du domaine uniquement.

Renvoie¶

Renvoie une valeur VARCHAR qui indique si la ressource a été ajoutée avec succès au budget.

Si la ressource n’a pas pu être ajoutée au budget, la fonction renvoie un message d’erreur.

Exigences en matière de contrôle d’accès¶

Les privilèges et rôles suivants sont nécessaires pour appeler cette méthode pour un budget personnalisé :

• Rôle d’instance ADMIN <label-budgets_instance_roles> pour l’instance de budget.

• Privilège USAGE sur la base de données et le schéma contenant l’instance de budget.

• Privilège USAGE sur la base de données et le schéma contenant la ressource en cours d’ajout (pour les objets de schéma).

Pour plus d’informations, voir Rôles et privilèges Budgets.

Notes sur l’utilisation¶

• Vous ne pouvez ajouter des ressources partagées qu’aux budgets personnalisés.

• Pour vérifier les résultats de la méthode, appelez la méthode GET_BUDGET_SCOPE.

• Lorsque tous les objets du type d’entité spécifié sont ajoutés (par exemple, toutes les fonctions AI), vous ne pouvez pas ajouter de ressources individuelles de ce type.

• Le fait d’appeler cette méthode ne renvoie pas l’objet. Pour cette raison, vous ne pouvez pas utiliser le chaînage de méthodes pour appeler une autre méthode sur la valeur de retour de cette méthode. Au lieu de cela, appelez chaque méthode dans une instruction SQL distincte.

Exemples¶

Ajouter toutes les fonctions AI au budget :

CALL finance_budget!ADD_SHARED_RESOURCE('AI FUNCTION');

Ajouter une fonction spécifique AI au budget :

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

Ajouter toutes les charges de travail Cortex Code au budget :

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX CODE');

Ajouter la charge de travail Cortex Code CLI au budget :

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

Ajouter la charge de travail Cortex Code Snowsight au budget :

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

Ajouter les charges de travail Cortex Agent au budget :

CALL finance_budget!ADD_SHARED_RESOURCE('CORTEX AGENT');

Ajouter toutes les charges de travail Snowflake Intelligence au budget :

CALL finance_budget!ADD_SHARED_RESOURCE('SNOWFLAKE INTELLIGENCE');