- Categorias:
GET_JOB_HISTORY¶
Retorna o histórico de trabalhos para trabalhos do Snowpark Container Services que foram executados dentro do intervalo de tempo especificado. A função retorna o trabalho em execução e o excluído.
- Consulte também:
Sintaxe¶
SNOWFLAKE.SPCS.GET_JOB_HISTORY(
[ CREATED_TIME_START => <constant_expr> ],
[ CREATED_TIME_END => <constant_expr> ],
[ RESULT_LIMIT = <integer> ])
Argumentos¶
CREATED_TIME_START => constant_exprHora de início, no formato TIMESTAMP_LTZ (por exemplo, “2024-04-05 01:02:03”) do intervalo em que os trabalhos foram criados para recuperar o histórico de trabalhos. Para as funções disponíveis para construção de dados, hora e carimbo de data/hora, consulte Funções de data e hora.
Padrão: 14 dias a partir do carimbo de data/hora atual.
CREATED_TIME_END => constant_exprHora de término, no formato TIMESTAMP_LTZ, do intervalo para recuperar o histórico de trabalhos.
Padrão: Carimbo de data/hora atual.
RESULT_LIMIT => integerNúmero máximo de linhas a retornar.
Se o número de linhas correspondentes exceder o limite especificado, somente os trabalhos com os carimbos de data/hora mais recentes serão retornados até o limite especificado.
Faixa: 1 a 10000
Padrão: 100
Saída¶
A função retorna as seguintes colunas:
Coluna |
Tipo de dados |
Descrição |
|---|---|---|
|
VARCHAR |
ID da instrução EXECUTE JOB SERVICE SQL. |
|
NUMBER |
Identificador interno/gerado pelo sistema para o trabalho. |
|
VARCHAR |
Nome do trabalho. |
|
VARCHAR |
Nome do banco de dados no qual o trabalho é criado. |
|
VARCHAR |
Nome do esquema no qual o trabalho é criado. |
|
TIMESTAMP_LTZ |
Hora em que o trabalho foi criado. |
|
TIMESTAMP_LTZ |
Hora em que o trabalho foi concluído. |
|
TIMESTAMP_LTZ |
Hora em que o trabalho foi excluído. |
|
VARCHAR |
Status do trabalho. |
|
VARCHAR |
Informações adicionais sobre o status do trabalho. |
|
OBJECT |
Pares chave-valor que descrevem instâncias de trabalho e contêineres. |
|
VARCHAR |
Nome do pool de computação onde o trabalho foi executado. |
|
VARCHAR |
Função proprietária do trabalho. |
|
VARCHAR |
Tipo de função que é proprietária do trabalho, seja ROLE ou DATABASE_ROLE. |
|
OBJECT |
Pares chave-valor que descrevem os parâmetros que foram especificados quando o trabalho foi criado. |
|
OBJECT |
Pares chave-valor que descrevem o objeto de gerenciamento. NULL se o trabalho não for gerenciado pelo Snowflake. |
Requisitos de controle de acesso¶
A função PUBLIC tem o privilégio para usar esta função.
Todos podem chamar esta função, mas a saída depende da função atual. A saída inclui apenas os trabalhos pertencentes à função atual.
Exemplos¶
Retorna o histórico do trabalho de todos os trabalhos criados pela função atual nos últimos 14 dias (o valor padrão
CREATED_TIME_START).SELECT * FROM TABLE(SNOWFLAKE.SPCS.GET_JOB_HISTORY(());
O exemplo de saída a seguir mostra apenas um trabalho:
+--------------------------------------+-----+-------------+---------------+-------------+-------------------------------+-------------------------------+--------------+--------+-----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+-----------+-----------------+-----------------+-----------------+ | 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 | | | | | | | | | | | | | | | | | } | | | | | | +--------------------------------------+-----+-------------+---------------+-------------+-------------------------------+-------------------------------+--------------+--------+-----------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------+-----------------------+-----------+-----------------+-----------------+-----------------+
Retorna o histórico de trabalhos de até 10 trabalhos pertencentes à função atual que foram executados nos últimos três dias.
SELECT * FROM TABLE(snowflake.spcs.get_job_history( result_limit => 10, created_time_start => dateadd('day', -3, current_timestamp()) ));
Recupera até 10 trabalhos executados entre três dias atrás e um dia atrás, sem incluir hoje.
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())));