- Catégories :
GET_JOB_HISTORY¶
Renvoie l’historique des tâches pour les tâches Snowpark Container Services qui ont été exécutées pendant l’intervalle de temps spécifié. La fonction renvoie à la fois la tâche en cours et la tâche supprimée.
- Voir aussi :
Syntaxe¶
SNOWFLAKE.SPCS.GET_JOB_HISTORY(
[ CREATED_TIME_START => <constant_expr> ],
[ CREATED_TIME_END => <constant_expr> ],
[ RESULT_LIMIT = <integer> ])
Arguments¶
CREATED_TIME_START => constant_exprHeure de début, au format TIMESTAMP_LTZ (par exemple, “2024-04-05 01:02:03”) pour l’intervalle de temps pendant lequel les tâches ont été créés pour récupérer l’historique des tâches. Pour les fonctions disponibles pour créer des données, des heures et des horodatages, voir Fonctions de date et d’heure.
Par défaut : 14 jours à partir de l’horodatage actuel.
CREATED_TIME_END => constant_exprHeure de fin, au format TIMESTAMP_LTZ, pour l’intervalle de temps permettant de récupérer l’historique des tâches.
Par défaut : Horodatage actuel.
RESULT_LIMIT => integerNombre maximum de lignes à renvoyer.
Si le nombre de lignes correspondantes dépasse la limite spécifiée, seuls les tâches avec les horodatages les plus récents sont renvoyés, jusqu’à la limite spécifiée.
Plage : 1 à 10000
Par défaut : 100
Sortie¶
La fonction renvoie les colonnes suivantes :
Colonne |
Type de données |
Description |
|---|---|---|
|
VARCHAR |
ID de l’instruction EXECUTE JOB SERVICE SQL. |
|
NUMBER |
Identificateur interne/généré par le système pour la tâche. |
|
VARCHAR |
Nom de la tâche. |
|
VARCHAR |
Nom de la base de données dans laquelle la tâche est créée. |
|
VARCHAR |
Nom du schéma dans lequel la tâche est créée. |
|
TIMESTAMP_LTZ |
Heure à laquelle la tâche a été créée. |
|
TIMESTAMP_LTZ |
Heure à laquelle la tâche a été terminée. |
|
TIMESTAMP_LTZ |
Heure à laquelle la tâche a été supprimée. |
|
VARCHAR |
Statut de la tâche. |
|
VARCHAR |
Informations complémentaires sur le statut de la tâche. |
|
OBJECT |
Paires clé-valeur qui décrivent les instances de tâches et les conteneurs. |
|
VARCHAR |
Nom du pool de calcul dans lequel la tâche a été exécutée. |
|
VARCHAR |
Rôle qui possède la tâche. |
|
VARCHAR |
Type de rôle propriétaire de la tâche, soit ROLE, soit DATABASE_ROLE. |
|
OBJECT |
Paires clé-valeur décrivant les paramètres spécifiés lors de la création de la tâche. |
|
OBJECT |
Paires clé-valeur qui décrivent l’objet de gestion. NULL si la tâche n’est pas gérée par Snowflake. |
Exigences en matière de contrôle d’accès¶
Le rôle PUBLIC possède le privilège d’utilisation de cette fonction.
Tout le monde peut appeler cette fonction, mais la sortie dépend du rôle actuel. La sortie n’inclut que les tâches qui appartiennent au rôle actuel.
Exemples¶
Renvoie l’historique de toutes les tâches créées par le rôle actuel au cours des 14 derniers jours (la valeur par défaut
CREATED_TIME_START).SELECT * FROM TABLE(SNOWFLAKE.SPCS.GET_JOB_HISTORY(());
L’exemple de sortie suivant ne montre qu’une seule tâche :
+--------------------------------------+-----+-------------+---------------+-------------+-------------------------------+-------------------------------+--------------+--------+-----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+-----------+-----------------+-----------------+-----------------+ | QUERY_ID | ID | NAME | DATABASE_NAME | SCHEMA_NAME | CREATED_TIME | COMPLETED_TIME | DELETED_TIME | STATUS | MESSAGE | INSTANCE_STATUSES | COMPUTE_POOL_NAME | OWNER | OWNER_ROLE_TYPE | PARAMETERS | MANAGING_OBJECT | |--------------------------------------+-----+-------------+---------------+-------------+-------------------------------+-------------------------------+--------------+--------+-----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+-----------+-----------------+-----------------+-----------------| | 01bd46d2-0004-be62-0000-ff07016490a6 | 131 | MY_TEST_JOB | TUTORIAL_DB | DATA_SCHEMA | 2025-06-25 17:50:00.728 -0700 | 2025-06-25 17:50:10.515 -0700 | NULL | DONE | Job completed successfully. | { | TUTORIAL_COMPUTE_POOL | TEST_ROLE | ROLE | { | NULL | | | | | | | | | | | | "failedInstances": 0, | | | | "ASYNC": true | | | | | | | | | | | | | "instances": [ | | | | } | | | | | | | | | | | | | { | | | | | | | | | | | | | | | | | "containers": [ | | | | | | | | | | | | | | | | | { | | | | | | | | | | | | | | | | | "containerName": "main", | | | | | | | | | | | | | | | | | "image": "org-account.registry.snowflakecomputing.com/tutorial_db/data_schema/tutorial_repository/my_job_image:latest", | | | | | | | | | | | | | | | | | "imageSha256": "sha256:ff07f19f233cfe76a889e39d9d7098d528312acc789f1c0cf929556a56c61a9a", | | | | | | | | | | | | | | | | | "lastExitCode": 0, | | | | | | | | | | | | | | | | | "message": "Completed successfully", | | | | | | | | | | | | | | | | | "restartCount": 0, | | | | | | | | | | | | | | | | | "startTime": "", | | | | | | | | | | | | | | | | | "status": "DONE" | | | | | | | | | | | | | | | | | } | | | | | | | | | | | | | | | | | ], | | | | | | | | | | | | | | | | | "instanceId": "0" | | | | | | | | | | | | | | | | | } | | | | | | | | | | | | | | | | | ], | | | | | | | | | | | | | | | | | "pendingInstances": 0, | | | | | | | | | | | | | | | | | "runningInstances": 0, | | | | | | | | | | | | | | | | | "succeededInstances": 1, | | | | | | | | | | | | | | | | | "totalInstances": 1 | | | | | | | | | | | | | | | | | } | | | | | | +--------------------------------------+-----+-------------+---------------+-------------+-------------------------------+-------------------------------+--------------+--------+-----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+-----------+-----------------+-----------------+-----------------+
Renvoie l’historique d’un maximum de 10 tâches qui appartiennent au rôle actuel et qui ont été exécutées au cours des trois derniers jours.
SELECT * FROM TABLE(snowflake.spcs.get_job_history( result_limit => 10, created_time_start => dateadd('day', -3, current_timestamp()) ));
Récupère jusqu’à 10 tâches exécutées entre il y a trois jours et il y a un jour, sans compter aujourd’hui.
SELECT * FROM TABLE(SNOWFLAKE.SPCS.GET_JOB_HISTORY( RESULT_LIMIT => 10, CREATED_TIME_START => DATEADD('day', -3, CURRENT_TIMESTAMP()), CREATED_TIME_END => DATEADD('day', -1, CURRENT_TIMESTAMP())));