<budget_name> !GET_BUDGET_SCOPE¶

Renvoie les ressources et les balises qui ont été ajoutées à un budget personnalisé. Permet de déterminer quelle consommation de ressources est suivie par le budget.

La liste ne comprend pas :

Objets qui ont été ajoutés automatiquement (par exemple, les pools de calcul et les entrepôts créés et détenus par une Snowflake Native App).
Objets qui ont été ajoutés lorsqu’une balise a été ajoutée au budget.

Syntaxe¶

<budget_name>!GET_BUDGET_SCOPE()

Renvoie¶

Cette méthode renvoie un objet JSON avec les clés suivantes :

resource_tags

Les balises de ressources qui ont été ajoutées au budget. Les ressources appartiennent au budget si elles sont balisées avec ces balises. Contient les champs suivants :

operator

La logique de correspondance utilisée pour les balises de ressources. Peut prendre l’une des valeurs suivantes :

UNION : Une ressource est incluse dans le budget si elle est balisée avec n’importe laquelle des paires balise-valeur dans le tableau tags.
INTERSECTION : Une ressource doit être balisée avec toutes les paires balise-valeur dans le tableau tags à inclure dans le budget.

tags

Un tableau d’objets de balises, chacun avec les champs suivants :

tagId: Identificateur interne de la balise.
tagDatabase: Base de données qui contient la balise.
tagSchema: Schéma qui contient la balise.
tagName: Nom de la balise.
tagValues: Tableau de valeurs de balise associées à la balise.

resources

Un tableau des ressources qui ont été ajoutées directement au budget. Chaque objet contient les champs suivants :

resourceId: Identificateur interne de la ressource.
resourceName: Nom de la ressource.
resourceDomain: Domaine de la ressource (par exemple, WAREHOUSE, DATABASE, TABLE).
schemaName: Schéma qui contient la ressource.
databaseName: Base de données qui contient la ressource.

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

Les privilèges et rôles minimaux suivants sont nécessaires pour afficher les résultats des budgets personnalisés :

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.

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

Notes sur l’utilisation¶

Cette méthode ne peut être appelée que pour les instances de budget personnalisé.
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.

Exemple¶

Obtenir toutes les ressources et balises qui ont été ajoutées au budget budget_db.budget_schema.my_budget :

CALL budget_db.budget_schema.my_budget!GET_BUDGET_SCOPE();