<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

  • DATA_QUALITY_MONITORING

  • HYBRID_TABLE_REQUESTS

  • MATERIALIZED_VIEW

  • PIPE

  • QUERY_ACCELERATION

  • SEARCH_OPTIMIZATION

  • SERVERLESS_ALERTS

  • 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

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

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).

  • 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

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

Pour résoudre les problèmes qui peuvent survenir lorsque vous appelez cette méthode, voir Vous ne pouvez pas appeler avec succès la méthode GET_SERVICE_TYPE_USAGE.

Langage: Français