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> ]) 

Copy

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(()); 

Copy

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()) )); 

Copy

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()))); 

Copy