<budget_name>!GET_SERVICE_TYPE_USAGE_V2¶
Affichez l’utilisation du crédit pour un budget par type de service.
Syntaxe¶
<budget_name>!GET_SERVICE_TYPE_USAGE_V2( '<start_month>' , '<end_month>' )
Arguments¶
'start_month'Spécifie le début de la période pour laquelle vous souhaitez renvoyer des informations d’utilisation. Spécifiée au format
YYYY-MM.'end_month'Spécifie la fin de la période pour laquelle vous souhaitez renvoyer des informations d’utilisation. Spécifiée au format
YYYY-MM.
Renvoie¶
La fonction renvoie les colonnes suivantes :
Nom de la colonne |
Type de données |
Description |
|---|---|---|
SERVICE_TYPE |
VARCHAR |
Affiche le service qui a utilisé des crédits. |
ENTITY_TYPE |
VARCHAR |
Type d’objet associé à la consommation de crédits. Tous les objets de type table tels que les tables, les vues, les vues matérialisées et les tables externes ont une valeur de |
ENTITY_ID |
NUMBER |
Identificateur interne de l’objet dans le budget. |
NAME |
VARCHAR |
Nom de l’objet associé à la consommation de crédits. |
CREDITS_USED |
FLOAT |
Nombre de crédits utilisés. C’est la somme de CREDITS_COMPUTE et de CREDITS_CLOUD. |
CREDITS_COMPUTE |
FLOAT |
Nombre de crédits de calcul utilisés. |
CREDITS_CLOUD |
FLOAT |
Nombre de crédits de services Cloud utilisés. |
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 :
N’importe quel rôle d’instance pour l’instance du budget.
Privilège USAGE sur la base de données et le schéma contenant l’instance de budget.
Rôle de la base de données Snowflake USAGE_VIEWER.
Le rôle suivant est requis pour afficher les résultats du budget du compte :
N’importe quel rôle d’application pour le budget du compte.
Rôle de la base de données Snowflake USAGE_VIEWER.
Pour plus d’informations, voir Rôles et privilèges Budgets.
Notes sur l’utilisation¶
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¶
Renvoyer les crédits consommés par les objets associés au budget my_budget en janvier, février et mars 2025 :
CALL db.sch1.my_budget!GET_SERVICE_TYPE_USAGE_V2('2025-01', '2025-03');