Catégories :: Fonctions de table

<service_name>!SPCS_GET_EVENTS¶

Renvoie les événements que Snowflake a collectés pour le service spécifié. Pour plus d’informations, voir Accès aux événements de la plateforme.

Note

La fonction n’est prise en charge que pour les services et les tâches créés dans la version 9.20 ou ultérieure.

Voir aussi :: Surveiller les services

Syntaxe¶

<service_name>!SPCS_GET_EVENTS(
  [ START_TIME => <constant_expr> ],
  [ END_TIME => <constant_expr> ] )

Copy

Arguments¶

START_TIME => constant_expr

Heure de début (au format TIMESTAMP_LTZ) pour la plage de temps à partir de laquelle récupérer des événements. Pour les fonctions disponibles pour créer des données, des heures et des horodatages, voir Fonctions de date et d’heure.

Si START_TIME n’est pas spécifiée, la valeur par défaut est un jour auparavant.

END_TIME => constant_expr

Heure de fin (au format TIMESTAMP_LTZ) pour la plage de temps à partir de laquelle récupérer des événements.

Si END_TIME n’est pas spécifiée, la valeur par défaut est l’horodatage actuel.

Sortie¶

Colonne	Type	Description
TIMESTAMP	TIMESTAMP_NTZ	Horodatage temps universel coordonné (UTC) du moment où Snowflake a collecté l’événement. Cette valeur correspond à la colonne TIMESTAMP dans la table des événements.
SEVERITY	VARCHAR	Gravité de l’événement. Cette valeur correspond au champ `severity_text` de la colonne RECORD dans la table des événements.
EVENT_NAME	VARCHAR	Nom de l’événement. Cette valeur correspond au champ `name` de la colonne RECORD dans la table des événements.
EVENT_DETAILS	OBJECT	Détails sur l’événement. Cette valeur correspond à la colonne VALUE dans la table des événements.
INSTANCE_ID	NUMBER	Identificateur de l’instance de service si l’événement est lié à une instance de service. Cette valeur correspond au champ `snow.service.instance` de la colonne RESOURCE_ATTRIBUTES dans la table des événements.
CONTAINER_NAME	VARCHAR	Nom du conteneur si l’événement est lié à un conteneur. Cette valeur correspond au champ `snow.service.container.name` de la colonne RESOURCE_ATTRIBUTES dans la table des événements.
RECORD	OBJECT	Informations sur l’événement au format JSON. Cette valeur correspond à la colonne RECORD dans la table des événements.
RECORD_ATTRIBUTES	OBJECT	Informations complémentaires sur l’événement. Cette valeur correspond à la colonne RECORD_ATTRIBUTES dans la table des événements.

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

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

Privilège	Objet	Remarques
OWNERSHIP	Service	OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

Le privilège USAGE relatif à la base de données et au schéma parents est exigé pour effectuer des opérations sur tout objet d’un schéma. Notez qu’un rôle doté d’un privilège quelconque sur un schéma permet à ce rôle de résoudre le schéma. Par exemple, un rôle doté du privilège CREATE sur un schéma peut créer des objets sur ce schéma sans également avoir le privilège USAGE attribué sur ce schéma.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation¶

Il peut s’écouler quelques minutes avant que les événements n’apparaissent dans la sortie.

Exemples¶

Récupérer les événements que Snowflake a enregistrés pour la tâche my_test_job au cours de la journée écoulée.

SELECT * FROM TABLE(my_test_job!SPCS_GET_EVENTS());

Copy

Exemple de sortie :

+-------------------------+----------+-------------------------+----------------------------------------+-------------+----------------+--------------------------------------+-------------------+
| TIMESTAMP               | SEVERITY | EVENT_NAME              | EVENT_DETAILS                          | INSTANCE_ID | CONTAINER_NAME | RECORD                               | RECORD_ATTRIBUTES |
|-------------------------+----------+-------------------------+----------------------------------------+-------------+----------------+--------------------------------------+-------------------|
| 2025-06-26 00:23:40.933 | INFO     | CONTAINER.STATUS_CHANGE | {                                      |        NULL | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Completed successfully", |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "DONE"                     |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
| 2025-06-26 00:23:35.919 | INFO     | CONTAINER.STATUS_CHANGE | {                                      |        NULL | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Running",                |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "READY"                    |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
| 2025-06-26 00:23:34.127 | INFO     | CONTAINER.STATUS_CHANGE | {                                      |        NULL | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Waiting to start",       |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "PENDING"                  |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
+-------------------------+----------+-------------------------+----------------------------------------+-------------+----------------+--------------------------------------+-------------------+

Récupérer les événements que Snowflake a enregistrés pour la tâche my_test_job au cours des trois derniers jours.

SELECT * FROM TABLE(my_test_job!SPCS_GET_EVENTS(START_TIME => DATEADD('day', -3, CURRENT_TIMESTAMP())));

Copy