Schéma :: ACCOUNT_USAGE

Vue WAREHOUSE_EVENTS_HISTORY¶

Note

Cette vue est généralement disponible (GA) avec le bundle de changements de comportement 2024_04. Pour utiliser la fonction GA, le bundle de changements de comportement 2024_04 ne doit pas être désactivé dans votre compte. Pour plus d’informations sur les modifications apportées aux vues, voir Vue WAREHOUSE_EVENTS_HISTORY (ACCOUNT_USAGE) : nouvelles colonnes et modifications des événements.

Cette vue Account Usage peut être utilisée pour renvoyer les événements qui ont été déclenchés pour les entrepôts à un ou plusieurs clusters de votre compte au cours des 365 derniers jours (1 année).

Les événements pris en charge sont les suivants :

Création, destruction ou modification d’un entrepôt, y compris le redimensionnement de l’entrepôt.
Reprise ou suspension d’un entrepôt.
Reprise, suspension ou redimensionnement d’un cluster dans un entrepôt (entrepôts à un ou plusieurs clusters).
Arrêt ou démarrage des clusters supplémentaires dans un entrepôt (entrepôts à plusieurs clusters uniquement).

Colonnes¶

Nom de la colonne	Type de données	Description
TIMESTAMP	TIMESTAMP_LTZ	L’horodatage lorsque l’événement est déclenché.
WAREHOUSE_ID	NUMBER	L’ID d’entrepôt unique (attribué par Snowflake) qui correspond au nom de l’entrepôt dans votre compte.
WAREHOUSE_NAME	VARCHAR	Le nom de l’entrepôt dans votre compte.
CLUSTER_NUMBER	NUMBER	Si un événement a été déclenché pour un cluster spécifique dans un entrepôt multi-clusters, le numéro du cluster (commençant par 1) pour lequel l’événement a été déclenché ; si l’événement a été déclenché pour tous les clusters de l’entrepôt ou n’est pas applicable pour un entrepôt à un seul cluster, NULL s’affiche.
EVENT_NAME	VARCHAR	Nom de l’événement. Pour la liste des valeurs possibles, voir Descriptions EVENT_NAME.
EVENT_REASON	VARCHAR	La cause de l’événement. Pour la liste des valeurs possibles, voir Descriptions EVENT_REASON.
EVENT_STATE	VARCHAR	État d’un événement qui prend du temps à se terminer : STARTED ou COMPLETED.
USER_NAME	VARCHAR	Utilisateur qui a initié l’événement.
ROLE_NAME	VARCHAR	Rôle actif dans la session au moment où l’événement était initié.
QUERY_ID	VARCHAR	Identificateur interne / généré par le système pour l’instruction SQL.
SIZE	VARCHAR	Taille actuelle de l’entrepôt au moment de l’événement. Cette valeur n’est disponible que pour les événements WAREHOUSE_CONSISTENT. Dans le cas contraire, cette valeur est NULL.
CLUSTER_COUNT	NUMBER	Nombre de clusters d’entrepôts au moment de l’événement. Cette valeur n’est disponible que pour les événements WAREHOUSE_CONSISTENT. Dans le cas contraire, cette valeur est NULL.

Descriptions EVENT_NAME¶

Événements liés à l’entrepôt¶

La table suivante décrit les valeurs valides de la colonne EVENT_NAME pour les événements liés à l’entrepôt :

EVENT_NAME

Description

CREATE_WAREHOUSE

Déclenché par la création d’un nouvel entrepôt, ce qui peut se produire lorsqu’un utilisateur crée manuellement un entrepôt ou lorsqu’un compte est provisionné et que l’entrepôt par défaut est automatiquement créé dans le compte.

Numéro du cluster	Aucun (N/A)
Statut de l’événement	COMPLETED ou STARTED
Motif de l’événement	Aucun (N/A)

Impact sur les coûts : aucun si le cluster est créé avec INITIALLY_SUSPENDED = TRUE. Sinon, le comptage commence lorsque toutes les ressources de calcul sont provisionnées pour l’entrepôt ou lorsque l’entrepôt commence à traiter les instructions (si l’entrepôt commence à traiter les instructions avant que les ressources ne soient entièrement provisionnées).

DROP_WAREHOUSE

Déclenché lorsqu’un entrepôt existant est supprimé ; toutes les requêtes en cours d’exécution sur l’entrepôt sont arrêtées et les ressources informatiques sont libérées.

Numéro du cluster	Aucun (N/A)
Statut de l’événement	COMPLETED ou STARTED
Motif de l’événement	Aucun (N/A)

Impact sur les coûts : le comptage des ressources de calcul de l’entrepôt s’arrête lorsque l’exécution en cours de toutes les requêtes est terminée.

ALTER_WAREHOUSE

Déclenché lorsque les propriétés d’un entrepôt existant sont modifiées, y compris le redimensionnement de l’entrepôt. Si l’entrepôt est redimensionné, des événements RESIZE_WAREHOUSE supplémentaires sont déclenchés. Cet événement peut également déclencher des événements RESUME_WAREHOUSE ou SUSPEND_WAREHOUSE.

Numéro du cluster	Aucun (N/A)
Statut de l’événement	COMPLETED ou STARTED
Motif de l’événement	Aucun (N/A)

Impact sur les coûts : dépend des événements déclenchés par l’instruction ALTER.

RESIZE_WAREHOUSE

Déclenché par la modification de la taille d’un entrepôt, qui augmente ou diminue les ressources de calcul dans chaque cluster de l’entrepôt. Pour un entrepôt en fonctionnement, cet événement déclenche également un événement RESIZE_CLUSTER pour chaque cluster de l’entrepôt.

Numéro du cluster	Aucun (N/A)
Statut de l’événement	STARTED
Motif de l’événement	WAREHOUSE_RESIZE

Impact sur les coûts : le redimensionnement d’un entrepôt en cours d’exécution ajoute ou supprime des ressources de calcul pour chaque cluster de l’entrepôt. Les ressources nouvellement ajoutées commencent à être comptées dès leur provisionnement. Les ressources supprimées cessent d’être comptées une fois que le traitement des requêtes en cours d’exécution prend fin.

Redimensionner un entrepôt suspendu ne met pas en marche de nouvelles ressources pour l’entrepôt.

RESUME_WAREHOUSE

Déclenché lorsqu’un entrepôt suspendu est repris ou qu’un nouvel entrepôt est créé avec INITIALLY_SUSPENDED = FALSE. Cet événement déclenche également un événement RESUME_CLUSTER pour chaque cluster de l’entrepôt.

Numéro du cluster	Aucun (s’applique à tous les clusters)
Statut de l’événement	STARTED
Motif de l’événement	WAREHOUSE_AUTORESUME ou WAREHOUSE_RESUME

Impact sur les coûts : le comptage commence lorsque toutes les ressources de calcul sont provisionnées pour l’entrepôt.

SUSPEND_WAREHOUSE

Déclenché lorsqu’un entrepôt en cours d’exécution est suspendu. Cet événement déclenche également un événement SUSPEND_CLUSTER pour chaque cluster de l’entrepôt.

Numéro du cluster	Aucun (s’applique à tous les clusters)
Statut de l’événement	STARTED
Motif de l’événement	WAREHOUSE_AUTOSUSPEND ou WAREHOUSE_SUSPEND

Impact sur les coûts : le comptage des ressources de calcul de l’entrepôt s’arrête à la fin de toutes les instructions en cours.

WAREHOUSE_CONSISTENT

Déclenché lorsque les modifications en attente apportées à un entrepôt sont terminées. Pour plus d’informations, voir Événement d’entrepôt indiquant qu’une opération est terminée.

Numéro du cluster	NULL
Statut de l’événement	COMPLETED
Motif de l’événement	NULL

Impact sur les coûts : aucun. Le comptage se produit pour l’événement d’entrepôt qui est enregistré à l’état STARTED avant l’événement WAREHOUSE_CONSISTENT.

Pour plus d’informations, consultez l’impact sur les coûts des événements d’entrepôt décrits dans les lignes précédentes.

Événements liés aux clusters :¶

La table suivante décrit les valeurs valides de la colonne EVENT_NAME pour les événements liés au cluster :

EVENT_NAME

Description

RESUME_CLUSTER

Déclenché lorsqu’un cluster suspendu est repris.

Numéro du cluster	Numéro du cluster repris (toujours `1` pour un entrepôt à un seul cluster)
Statut de l’événement	STARTED
Motif de l’événement	WAREHOUSE_AUTORESUME ou WAREHOUSE_RESUME (entrepôt à un seul cluster) MULTICLUSTER_SPINUP (entrepôt à plusieurs clusters)

Impact sur les coûts : le comptage commence sur les ressources de calcul pour le cluster lorsqu’elles sont provisionnées.

SUSPEND_CLUSTER

Déclenché lorsqu’un cluster en cours d’exécution est suspendu.

Numéro du cluster	Numéro du cluster suspendu (toujours `1` pour un entrepôt à un seul cluster).
Statut de l’événement	STARTED
Raison de l’événement :	WAREHOUSE_AUTOSUSPEND ou WAREHOUSE_SUSPEND (entrepôt à un seul cluster) MULTICLUSTER_SPINDOWN (entrepôt à plusieurs clusters) RESOURCE_MONITOR_SUSPEND

Impact sur les coûts : le comptage des ressources de calcul du cluster s’arrête lorsque l’exécution en cours de toutes les requêtes est terminée.

RESIZE_CLUSTER

Déclenché lorsqu’un cluster est redimensionné, généralement à la suite du redimensionnement d’un entrepôt.

Numéro du cluster	Numéro du cluster redimensionné (toujours `1` pour un entrepôt à un seul cluster).
Statut de l’événement	STARTED
Motif de l’événement	WAREHOUSE_AUTORESUME ou WAREHOUSE_RESUME (entrepôt à un seul cluster) MULTICLUSTER_SPINDOWN ou MULTICLUSTER_SPINUP (entrepôt à plusieurs clusters) WAREHOUSE_RESIZE

Impact sur les coûts : dépend de l’ajout ou de la suppression de ressources de calcul en raison du redimensionnement. Les ressources nouvellement ajoutées commencent à être comptées dès leur provisionnement. Les ressources supprimées cessent d’être comptées une fois que le traitement des requêtes en cours d’exécution prend fin.

SPINUP_CLUSTER

Déclenché lorsqu’un cluster est démarré (entrepôt à plusieurs clusters uniquement) ; se produit généralement lorsque la taille minimale ou maximale du cluster est augmentée.

Numéro du cluster	Numéro du cluster qui a été démarré
Statut de l’événement	STARTED
Motif de l’événement	WAREHOUSE_RESIZE (entrepôt à un seul cluster) MULTICLUSTER_SPINUP (entrepôt à plusieurs clusters)

Impact sur les coûts : le comptage commence sur les ressources de calcul pour le cluster lorsqu’elles sont provisionnées.

SPINDOWN_CLUSTER

Déclenché lorsqu’un cluster en cours d’exécution est arrêté (entrepôt à plusieurs clusters) ; se produit généralement lorsque la taille minimale ou maximale du cluster est réduite.

Numéro du cluster	Numéro du cluster qui a été arrêté
Statut de l’événement	STARTED
Motif de l’événement	WAREHOUSE_RESIZE (entrepôt à un seul cluster) MULTICLUSTER_SPINDOWN (entrepôt à plusieurs clusters)

Impact sur les coûts : le comptage des ressources de calcul du cluster s’arrête lorsque l’exécution en cours de toutes les requêtes est terminée.

Descriptions EVENT_REASON¶

La table suivante décrit les valeurs valides de la colonne EVENT_REASON :

EVENT_REASON	Description
WAREHOUSE_AUTORESUME	Un entrepôt suspendu a été repris automatiquement parce que AUTO_RESUME est activé pour l’entrepôt et qu’une instruction SQL a été soumise à l’entrepôt.
WAREHOUSE_RESUME	Un entrepôt suspendu a été repris manuellement par un utilisateur.
WAREHOUSE_AUTOSUSPEND	Un entrepôt en cours d’exécution a été suspendu automatiquement parce que AUTO_SUSPEND est activé pour l’entrepôt et que la période d’inactivité définie pour AUTO_SUSPEND est passée.
WAREHOUSE_SUSPEND	Un entrepôt en cours d’exécution a été suspendu manuellement par un utilisateur.
WAREHOUSE_RESIZE	Un entrepôt a été redimensionné.
RESOURCE_MONITOR_SUSPEND	Un entrepôt a été suspendu parce que le quota de crédit pour le moniteur de ressources de l’entrepôt a été atteint.
MULTICLUSTER_SPINUP	Un cluster nouveau ou suspendu a été provisionné dans un entrepôt à plusieurs clusters ; non applicable aux entrepôts à un seul cluster.
MULTICLUSTER_SPINDOWN	Un cluster en cours d’exécution a été arrêté dans un entrepôt multi-clusters ; non applicable aux entrepôts à un seul cluster.

Notes sur l’utilisation¶

La latence de la vue peut aller jusqu’à trois heures.

Un événement peut produire plusieurs lignes dans la vue s’il déclenche des événements supplémentaires liés.
La valeur des colonnes EVENT_REASON, USER_NAME, ROLE_NAME et QUERY_ID sont NULL pour un événement WAREHOUSE_CONSISTENT.
L’événement WAREHOUSE_CONSISTENT peut partager le même horodatage avec un autre événement de l’entrepôt et être listé dans le désordre.

Événement d’entrepôt indiquant qu’une opération est terminée¶

Les événements qui créent un entrepôt, modifient la taille de l’entrepôt ou le nombre de clusters, ou suspendent un entrepôt, ne sont pas des opérations atomiques. Cela signifie qu’un certain temps est nécessaire pour que ces opérations se terminent complètement.

Par exemple, si un entrepôt est suspendu à l’aide d’une instruction ALTER WAREHOUSE. .. SUSPEND, toutes les requêtes en cours d’exécution sur l’entrepôt doivent être terminées (ou expirer) avant de pouvoir être suspendues. Dans certains cas, plusieurs événements d’entrepôt peuvent être en cours (par exemple, redimensionnement et suspension). Lorsque tous les événements de l’entrepôt sont terminés, l’entrepôt est dans un état cohérent.

Si un événement d’entrepôt est consigné à l’état STARTED dans la colonne EVENT_STATE, il n’est jamais consigné à l’état COMPLETED. Au contraire, un événement enregistré avec l’état STARTED est toujours suivi d’un événement WAREHOUSE_CONSISTENT. Si plusieurs événements d’entrepôt sont enregistrés avec l’état d’événement STARTED, ces événements sont regroupés dans le même événement WAREHOUSE_CONSISTENT.

Si un événement d’entrepôt est consigné à l’état COMPLETED dans la colonne EVENT_STATE, aucun événement WAREHOUSE_CONSISTENT ne suit, à moins qu’un autre événement en attente ne soit consigné à l’état STARTED.

Exemples¶

Voir l’historique des événements de la semaine précédente¶

Voir l’historique des événements de l’entrepôt my_wh pour la semaine précédente en exécutant l’instruction suivante :

SELECT timestamp, warehouse_name, cluster_number,
       event_name, event_reason, event_state,
       size, cluster_count
  FROM SNOWFLAKE.ACCOUNT_USAGE.WAREHOUSE_EVENTS_HISTORY
  WHERE warehouse_name = 'MY_WH'
  AND timestamp > DATEADD('day', -7, CURRENT_TIMESTAMP())
  ORDER BY timestamp DESC;

Copy

Exemple de résultats de l’historique des événements¶

Historique des événements pour une instruction sans modifications en attente¶

Une instruction ALTER WAREHOUSE est consignée à l’état COMPLETED lorsqu’il n’y a pas d’autres modifications en attente. Par exemple, l’instruction suivante met à jour le commentaire pour l’entrepôt my_wh :

ALTER WAREHOUSE my_wh SET
  COMMENT = 'Updated comment for warehouse';

Copy

Cette instruction donne lieu à la ligne suivante dans la vue WAREHOUSE_EVENTS_HISTORY :

TIMESTAMP	WAREHOUSE_NAME	EVENT_NAME	EVENT_STATE	SIZE	CLUSTER_COUNT
2024-04-26 16:42:13.513 +0000	MY_WH	ALTER_WAREHOUSE	COMPLETED	NULL	NULL

L’historique des événements d’une instruction suivie d’un événement WAREHOUSE_CONSISTENT¶

Lorsqu’une instruction ALTER WAREHOUSE modifie la taille de l’entrepôt, des événements supplémentaires suivent. Par exemple, redimensionner l’entrepôt my_wh :

ALTER WAREHOUSE my_wh SET
  WAREHOUSE_SIZE = 'SMALL';

Copy

Cette instruction produit les lignes suivantes dans la vue WAREHOUSE_EVENTS_HISTORY :

TIMESTAMP	WAREHOUSE_NAME	EVENT_NAME	EVENT_STATE	SIZE	CLUSTER_COUNT
2024-05-29 15:13:05.874 +0000	MY_WH	ALTER_WAREHOUSE	STARTED	NULL	NULL
2024-05-29 15:13:05.874 +0000	MY_WH	RESIZE_WAREHOUSE	STARTED	NULL	NULL
2024-05-29 15:13:06.036 +0000	MY_WH	WAREHOUSE_CONSISTENT	COMPLETED	SMALL	1
2024-05-29 15:13:06.036 +0000	MY_WH	RESIZE_CLUSTER	COMPLETED	NULL	NULL

Historique des événements pour un événement d’entrepôt initié par Snowflake¶

Lorsque Snowflake reprend un entrepôt à plusieurs clusters, les événements d’entrepôt suivants sont consignés :

TIMESTAMP	WAREHOUSE_NAME	EVENT_NAME	EVENT_STATE	SIZE	CLUSTER_COUNT
2024-04-23 17:04:11.618 +0000	MY_WH	SPINUP_CLUSTER	STARTED	NULL	NULL
2024-04-23 17:04:11.657 +0000	MY_WH	RESUME_CLUSTER	STARTED	NULL	NULL
2024-04-23 17:04:11.657 +0000	MY_WH	WAREHOUSE_CONSISTENT	COMPLETED	LARGE	5