<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

  • HYBRID_TABLE_REQUESTS

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