sp_help_jobstep (Transact-SQL)

Aplica-se a:SQL Server

Retorna informações para as etapas em um trabalho usado por SQL Server Agent serviço para executar atividades automatizadas.

Convenções de sintaxe de Transact-SQL

Sintaxe

  
sp_help_jobstep { [ @job_id = ] 'job_id' | [ @job_name = ] 'job_name' }  
     [ , [ @step_id = ] step_id ]   
     [ , [ @step_name = ] 'step_name' ]   
     [ , [ @suffix = ] suffix ]   

Argumentos

[ @job_id = ] 'job_id' O número de identificação do trabalho para o qual retornar informações do trabalho. job_id é uniqueidentifier, com um padrão de NULL.

[ @job_name = ] 'job_name' O nome do trabalho. job_name é sysname, com um NULL padrão.

Observação

Job_id oujob_name devem ser especificados, mas ambos não podem ser especificados.

[ @step_id = ] step_id O número de identificação da etapa no trabalho. Se não for incluído, todas as etapas do trabalho serão incluídas. step_id é int, com um padrão de NULL.

[ @step_name = ] 'step_name' O nome da etapa no trabalho. step_name é sysname, com um padrão de NULL.

[ @suffix = ] suffix Um sinalizador que indica se uma descrição de texto é acrescentada à coluna flags na saída. sufixoé bit, com o padrão de 0. Se o sufixo for 1, uma descrição será acrescentada.

Valores do código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Nome da coluna	Tipo de dados	Descrição
step_id	int	Identificador exclusivo da etapa.
step_name	sysname	Nome da etapa no trabalho.
Subsistema	nvarchar(40)	Subsistema no qual o comando de etapa será executado.
command	nvarchar(max)	Comando executado na etapa.
sinalizadores	int	Um bitmask de valores que controlam o comportamento da etapa.
cmdexec_success_code	int	Para uma etapa CmdExec , esse é o código de saída do processo de um comando bem-sucedido.
on_success_action	tinyint	Ação a ser efetuada se a etapa tiver êxito: 1 = Encerrar o trabalho relatando êxito. 2 = Encerrar o trabalho relatando falha. 3 = Vá para a próxima etapa. 4 = Ir para a etapa.
on_success_step_id	int	Se on_success_action for 4, isso indicará a próxima etapa a ser executada.
on_fail_action	tinyint	O que fazer se a etapa falhar. Os valores são iguais aos on_success_action.
on_fail_step_id	int	Se on_fail_action for 4, isso indicará a próxima etapa a ser executada.
server	sysname	Reservado.
database_name	sysname	Para uma etapa do Transact-SQL, esse é o banco de dados no qual o comando é executado.
database_user_name	sysname	Para uma etapa do Transact-SQL, esse é o contexto do usuário do banco de dados no qual o comando é executado.
retry_attempts	int	Número máximo de vezes que o comando deve ser repetido (se for malsucedido).
retry_interval	int	Intervalo (em minutos) para quaisquer tentativas de repetição.
os_run_priority	int	Reservado.
output_file_name	nvarchar(200)	Arquivo no qual a saída de comando deve ser gravada (somente etapas Transact-SQL, CmdExec e PowerShell ).
last_run_outcome	int	Resultado da etapa na última vez em que foi executada: 0 = Falha 1 = Êxito 2 = Tentar novamente 3 = Cancelado 5 = Desconhecido
last_run_duration	int	Duração (hhmmss) da etapa na última vez que foi executada.
last_run_retries	int	Número de vezes que o comando foi repetido da última vez em que a etapa foi executada.
last_run_date	int	Data em que a execução da etapa foi iniciada pela última vez.
last_run_time	int	Hora em que a execução da etapa foi iniciada pela última vez.
proxy_id	int	Proxy da etapa do trabalho.

Comentários

sp_help_jobstep está no banco de dados msdb .

Permissões

Por padrão, os membros da função de servidor fixa sysadmin podem executar este procedimento armazenado. Deve ser concedida a outros usuários uma das seguintes funções de banco de dados fixas do SQL Server Agent no banco de dados msdb :

• SQLAgentUserRole

• SQLAgentReaderRole

• SQLAgentOperatorRole

Para obter detalhes sobre as permissões dessas funções, consulte Funções de banco de dados fixas do SQL Server Agent.

Os membros do SQLAgentUserRole só podem exibir etapas de trabalho para trabalhos que possuem.

Exemplos

a. Retornar informações de todas as etapas em um trabalho específico

O exemplo a seguir retorna todas as etapas do trabalho nomeado Weekly Sales Data Backup.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_jobstep  
    @job_name = N'Weekly Sales Data Backup' ;  
GO  

B. Retornar informações sobre uma etapa de trabalho específica

O exemplo a seguir retorna informações sobre a primeira etapa de trabalho do trabalho nomeado Weekly Sales Data Backup.

USE msdb ;  
GO  
  
EXEC dbo.sp_help_jobstep  
    @job_name = N'Weekly Sales Data Backup',  
    @step_id = 1 ;  
GO  

Consulte Também

sp_add_jobstep (Transact-SQL)
sp_delete_jobstep (Transact-SQL)
sp_help_job (Transact-SQL)
sp_update_jobstep (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)