Categorias:: Funções de tabela

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:: Execução de um serviço de trabalho

Sintaxe¶

SNOWFLAKE.SPCS.GET_JOB_HISTORY(
  [ CREATED_TIME_START => <constant_expr> ],
  [ CREATED_TIME_END => <constant_expr> ],
  [ RESULT_LIMIT = <integer> ])

Argumentos¶

CREATED_TIME_START => constant_expr

Hora 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_expr

Hora 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 => integer

Nú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
`QUERY_ID`	VARCHAR	ID da instrução EXECUTE JOB SERVICE SQL.
`ID`	NUMBER	Identificador interno/gerado pelo sistema para o trabalho.
`NAME`	VARCHAR	Nome do trabalho.
`DATABASE_NAME`	VARCHAR	Nome do banco de dados no qual o trabalho é criado.
`SCHEMA_NAME`	VARCHAR	Nome do esquema no qual o trabalho é criado.
`CREATED_TIME`	TIMESTAMP_LTZ	Hora em que o trabalho foi criado.
`COMPLETED_TIME`	TIMESTAMP_LTZ	Hora em que o trabalho foi concluído.
`DELETED_TIME`	TIMESTAMP_LTZ	Hora em que o trabalho foi excluído.
`STATUS`	VARCHAR	Status do trabalho.
`MESSAGE`	VARCHAR	Informações adicionais sobre o status do trabalho.
`INSTANCE_STATUSES`	OBJECT	Pares chave-valor que descrevem instâncias de trabalho e contêineres.
`COMPUTE_POOL_NAME`	VARCHAR	Nome do pool de computação onde o trabalho foi executado.
`OWNER`	VARCHAR	Função proprietária do trabalho.
`OWNER_ROLE_TYPE`	VARCHAR	Tipo de função que é proprietária do trabalho, seja ROLE ou DATABASE_ROLE.
`PARAMETERS`	OBJECT	Pares chave-valor que descrevem os parâmetros que foram especificados quando o trabalho foi criado.
`MANAGING_OBJECT`	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())));