jobs.sp_stop_job (Azure Elastic Jobs) (Transact-SQL)

Aplica-se a: Banco de Dados SQL do Azure

Instrui o agente de trabalho elástico a interromper a execução de um trabalho no serviço de Trabalhos Elásticos do Azure para o Banco de Dados SQL do Azure.

Esse procedimento armazenado compartilha o nome de sp_stop_job com um objeto semelhante no SQL Server para o serviço SQL Server Agent. Para obter informações sobre a versão do SQL Server Agent, consulte sp_stop_job.

Convenções de sintaxe de Transact-SQL

Sintaxe

[jobs].sp_stop_job [ @job_execution_id = ] ' job_execution_id '

Argumentos

@job_execution_id

O número de identificação da execução de trabalho a ser interrompida. job_execution_id é uniqueidentifier, com o padrão de NULL.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Permissões

Por padrão, os membros da função de servidor fixa sysadmin podem executar este procedimento armazenado. Somente os membros da função sysadmin podem usar esse procedimento armazenado para editar os atributos dos trabalhos pertencentes a outros usuários.

Comentários

Todos os horários em trabalhos elásticos estão no fuso horário UTC.

Para identificar a job_execution_id execução de um trabalho atual, use jobs.job_executions.

Exemplos

Identificar e interromper a execução de um trabalho

O exemplo a seguir mostra como identificar uma execução de trabalho no jobs.job_executions e, em seguida, cancelar uma execução de trabalho usando o job_execution_id, por exemplo 01234567-89ab-cdef-0123-456789abcdef.

Conecte-se ao job_database e execute o seguinte comando:

--Connect to the job database specified when creating the job agent

-- View all active executions to determine job_execution_id
SELECT job_name
, job_execution_id
, job_version
, step_id
, is_active
, lifecycle
, start_time
, current_attempts
, current_attempt_start_time
, last_message
, target_group_name
, target_server_name
, target_database_name
FROM jobs.job_executions
WHERE is_active = 1 AND job_name = 'ResultPoolsJob'
ORDER BY start_time DESC;
GO

-- Cancel job execution with the specified job_execution_id
EXEC jobs.sp_stop_job '01234567-89ab-cdef-0123-456789abcdef';