ANOMALY_INSIGHTS!GET_TOP_WAREHOUSES_ON_DATE

Retourne les entrepôts ayant la plus forte variation de consommation pour une date donnée, déterminée en comparant le jour spécifié avec le jour précédent. Permet d’enquêter sur les anomalies de coûts au niveau du compte et de l’organisation.

Syntaxe

SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_TOP_WAREHOUSES_ON_DATE(
  '<date>',
  <number_of_warehouses>,
  <account_name> )
Copy

Arguments

'date'

Spécifie la date pour laquelle vous souhaitez renvoyer les données de consommation.

Type de données : DATE

number_of_warehouses

Limite le nombre d’entrepôts renvoyés par la méthode. Par exemple, si vous spécifiez 5, la méthode ne renvoie que les cinq premiers entrepôts en termes de variation de la consommation.

Type de données : NUMBER

account_name

Spécifie une expression qui détermine le(s) compte(s) pour le(s)quel(s) les données de consommation sont renvoyées. Vous pouvez spécifier les valeurs suivantes :

  • 'account_name' : Renvoie les données de l’entrepôt pour le compte spécifié. Vous devez spécifier le nom du compte, et non l’emplacement du compte.

  • CURRENT_ACCOUNT_NAME() : Renvoie les données de l’entrepôt pour le compte actuel.

  • NULL : Renvoie les données de l’entrepôt pour l’ensemble de l’organisation, et non pour un compte spécifique.

Renvoie

Renvoie une table avec les colonnes suivantes :

Nom de la colonne

Type de données

Description

WAREHOUSE_NAME

VARCHAR

Nom de l’entrepôt.

WAREHOUSE_ID

NUMBER

Identificateur de l’entrepôt généré par le système.

CONSUMPTION

NUMBER (38,9)

Montant de la consommation du jour spécifié en crédits.

COST_CHANGE

NUMBER (38,9)

Différence entre la consommation du jour spécifié et celle du jour précédent.

Exigences en matière de contrôle d’accès

Les utilisateurs ayant l’un des rôles suivants peuvent appeler cette méthode :

  • Rôle ACCOUNTADMIN

  • Rôle GLOBALORGADMIN

Notes sur l’utilisation

  • Pour renvoyer les données d’un autre compte ou de l’ensemble de l’organisation, vous devez exécuter cette méthode à partir du compte de l’organisation ou d’un compte ORGADMIN.

  • Vous ne pouvez pas utiliser cette méthode pour renvoyer une devise comme unité de mesure de la consommation.

Exemple

Renvoie les six premiers entrepôts de l’organisation en termes de changement de consommation en comparant le 9 août 2024 et le 10 août 2024.

CALL SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_TOP_WAREHOUSES_ON_DATE('2024-08-10', 6, NULL);
Copy

Renvoie les cinq premiers entrepôts du compte actuel en termes de variation de consommation en comparant le 8 décembre 2024 et le 9 décembre 2024.

CALL SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_TOP_WAREHOUSES_ON_DATE(
  '2024-12-09', 5, CURRENT_ACCOUNT_NAME());
Copy

Retourne les trois premiers entrepôts du compte my_acct en termes de variation de consommation en comparant le 8 novembre 2024 et le 9 novembre 2024.

CALL SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_TOP_WAREHOUSES_ON_DATE(
  '2024-11-09', 5, 'my_acct');
Copy