<nom_budget>!GET_SERVICE_TYPE_USAGE¶

Affichez l’utilisation du crédit pour un budget par type de service.

Voir aussi :: <nom_budget>!GET_SPENDING_HISTORY

Syntaxe¶

<budget_name>!GET_SERVICE_TYPE_USAGE( SERVICE_TYPE => '<service_type>' ,
                                      TIME_DEPART => '<time_interval>' ,
                                      USER_TIMEZONE => '<timezone>' ,
                                      TIME_LOWER_BOUND => <constant_expr> ,
                                      TIME_UPPER_BOUND => <constant_expr>
                                    )

Copy

Arguments¶

SERVICE_TYPE => service_type

Le type de service utilisé pour limiter les résultats.

Valeurs valides :

Type de service qui consomme des crédits, qui peut être l’un des suivants :

AUTO_CLUSTERING

MATERIALIZED_VIEW

PIPE

QUERY_ACCELERATION

SEARCH_OPTIMIZATION

SERVERLESS_TASK

SNOWPIPE_STREAMING

WAREHOUSE_METERING

WAREHOUSE_METERING_READER

TIME_DEPART => time_interval

Intervalle de temps utilisé pour délimiter les enregistrements d’utilisation. Chaque ligne affiche l’utilisation du service pour l’intervalle de temps spécifié.

Valeurs valides :

HOUR, heure
DAY, jour
WEEK, semaine

USER_TIMEZONE => timezone

Chaîne spécifiant le fuseau horaire de l’utilisateur. La mesure du budget est basée sur le fuseau horaire UTC.

TIME_LOWER_BOUND => constant_expr

Début de la période au cours de laquelle les dépenses ont été effectuées.

TIME_UPPER_BOUND => constant_expr

Fin de l’intervalle de temps au cours duquel les dépenses ont été effectuées.

Renvoie¶

La fonction renvoie les colonnes suivantes :

Nom de la colonne	Type de données	Description
START_TIME	TIMESTAMP_TZ	Date et heure de l’utilisation.
ENTITY_ID	NUMBER	Identificateur interne de l’objet dans le budget.
NAME	VARCHAR	Nom de l’objet mesuré.
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 :
- Un rôle avec n’importe quel rôle d’instance pour l’instance de budget.
- Un rôle bénéficiant du privilège USAGE sur la base de données et le schéma qui contient l’instance de budget.
Le rôle suivant est requis pour afficher les résultats du budget du compte :

Un rôle avec n’importe quel rôle d’application pour le budget du compte.

Notes sur l’utilisation¶

Pour timezone, vous pouvez spécifier un nom de fuseau horaire ou un nom de lien de la version 2021a de la base de données de fuseaux horaires IANA (par exemple, America/Los_Angeles, Europe/London, UTC, Etc/GMT, etc.).

Note

Les noms de fuseaux horaires sont sensibles à la casse et doivent être entre guillemets simples (par ex. 'UTC').
Snowflake ne prend pas en charge la majorité des abréviations de fuseaux horaires (par exemple, PDT, EST, etc.) car une abréviation donnée peut faire référence à plusieurs fuseaux horaires différents. Par exemple, CST peut faire référence à l’heure normale centrale en Amérique du Nord (UTC-6), à l’heure normale de Cuba (UTC-5) et à l’heure normale de Chine (UTC+8).

Exemples¶

Affichez les crédits journaliers dépensés pour chaque entrepôt au cours de la semaine écoulée pour le budget du compte :

CALL snowflake.local.account_root_budget!GET_SERVICE_TYPE_USAGE(
   SERVICE_TYPE => 'WAREHOUSE_METERING',
   TIME_DEPART => 'day',
   USER_TIMEZONE => 'UTC',
   TIME_LOWER_BOUND => dateadd('day', -7, current_timestamp()),
   TIME_UPPER_BOUND => current_timestamp()
);

Copy

Messages d’erreur¶

Les scénarios suivants peuvent vous aider à résoudre les problèmes qui peuvent survenir.

Erreur	001044 (42P13): SQL compilation error: error line 0 at position -1 Invalid argument types for function 'GET_SERVICE_TYPE_USAGE': (VARCHAR(X), VARCHAR(X), VARCHAR(X), VARCHAR(X))
Cause	Vous avez appelé la méthode avec des arguments non valides ou un nombre d’arguments incorrect.
Solution	Vérifiez que les arguments que vous utilisez pour appeler la méthode sont valides et que vous avez inclus tous les arguments requis.

Erreur	002151 (22023): Uncaught exception of type 'STATEMENT_ERROR' on line 16 at position 23 : SQL compilation error: [:TIME_DEPART] is not a valid date/time component for function DATE_TRUNC.
Cause	L’argument TIME_DEPART est une chaîne non valide.
Solution	Utilisez l’une des valeurs valides énumérées ci-dessus.

Erreur	100094 (22000): Uncaught exception of type 'STATEMENT_ERROR' on line 16 at position 23 : Unknown timezone: '<invalid_timezone>'
Cause	L’argument USER_TIMEZONE est une chaîne non valide.
Solution	Utilisez une chaîne de fuseau horaire valide. Pour plus d’informations, consultez les notes sur l’utilisation ci-dessus.