<nom_budget>!GET_SPENDING_HISTORY¶

Affichez l’historique des dépenses pour un budget.

Voir aussi :: <nom_budget>!GET_SERVICE_TYPE_USAGE

Syntaxe¶

<budget_name>!GET_SPENDING_HISTORY( [ TIME_LOWER_BOUND => <constant_expr> ,
                                      TIME_UPPER_BOUND => <constant_expr> ] )

Copy

Arguments facultatifs¶

TIME_LOWER_BOUND => constant_expr, . TIME_UPPER_BOUND => constant_expr

Période (au format d’horodatage UTC) au cours de laquelle les dépenses ont été effectuées.

Vous devez définir des limites temporelles inférieures et supérieures pour limiter les résultats en fonction d’un intervalle de temps.

Renvoie¶

La fonction renvoie les colonnes suivantes :

Nom de la colonne	Type de données	Description
MEASUREMENT_DATE	DATE	Date à laquelle l’utilisation a eu lieu.
SERVICE_TYPE	VARCHAR	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`
CREDITS_SPENT	FLOAT	Nombre de crédits utilisés.

Nom de la colonne

Type de données

Description

MEASUREMENT_DATE

DATE

Date à laquelle l’utilisation a eu lieu.

SERVICE_TYPE

VARCHAR

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

CREDITS_SPENT

FLOAT

Nombre de crédits 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.

Exemples¶

Affichez l’historique des dépenses pour le budget my_budget dans le schéma budget_db.budget_schema :

CALL budget_db.budget_schema.my_budget!GET_SPENDING_HISTORY();

Copy

Consultez l’historique des dépenses des 7 derniers jours pour le budget du compte :

CALL snowflake.local.account_root_budget!GET_SPENDING_HISTORY(
  TIME_LOWER_BOUND=>dateadd('days', -7, current_timestamp()),
  TIME_UPPER_BOUND=>current_timestamp()
);

Copy