sp_start_job (Transact-SQL)
Aplica-se a:SQL ServerInstância Gerenciada de SQL do Azure
Instrui o SQL Server Agent a executar um trabalho imediatamente.
Convenções de sintaxe de Transact-SQL
Sintaxe
sp_start_job
[ [ @job_name = ] N'job_name' ]
[ , [ @job_id = ] 'job_id' ]
[ , [ @error_flag = ] error_flag ]
[ , [ @server_name = ] N'server_name' ]
[ , [ @step_name = ] N'step_name' ]
[ , [ @output_flag = ] output_flag ]
[ ; ]
Argumentos
@job_name [ = ] N'job_name'
O nome do trabalho a ser iniciado. @job_name é sysname, com um padrão de NULL
.
Devem ser especificados @job_id ou @job_name , mas ambos não podem ser especificados.
@job_id [ = ] 'job_id'
O número de identificação do trabalho a ser iniciado. @job_id é uniqueidentifier, com um padrão de NULL
.
Devem ser especificados @job_id ou @job_name , mas ambos não podem ser especificados.
@error_flag [ = ] error_flag
Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.
@server_name [ = ] N'server_name'
O servidor de destino no qual iniciar o trabalho. @server_name é sysname, com um padrão de NULL
. @server_name deve ser um dos servidores de destino para os quais o trabalho está direcionado no momento.
@step_name [ = ] N'step_name'
O nome da etapa na qual a execução do trabalho será iniciada. @step_name é sysname, com um padrão de NULL
. Aplica-se apenas a trabalhos locais.
@output_flag [ = ] output_flag
Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.
Valores do código de retorno
0
(sucesso) ou 1
(falha).
Conjunto de resultados
Nenhum.
Comentários
Esse procedimento armazenado está no msdb
banco de dados.
Este procedimento armazenado compartilha o nome de com um objeto semelhante para o serviço Azure Elastic Jobs para Banco de sp_start_job
Dados SQL do Azure. Para obter informações sobre a versão de trabalhos elásticos, consulte jobs.sp_start_job (Azure Elastic Jobs) (Transact-SQL).
Esse procedimento armazenado pertence à função db_owner . Você pode conceder EXECUTE
permissões para qualquer usuário, mas essas permissões podem ser substituídas durante uma atualização do SQL Server.
Outros usuários devem receber uma das seguintes funções de banco de dados fixas msdb
do SQL Server Agent no banco de dados:
- 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 de SQLAgentUserRole e SQLAgentReaderRole só podem iniciar trabalhos que possuem. Os membros de SQLAgentOperatorRole podem iniciar todos os trabalhos locais, incluindo trabalhos que pertencem a outros usuários. Os membros do sysadmin podem iniciar todos os trabalhos locais e multisservidor.
Exemplos
O exemplo a seguir inicia um trabalho denominado Weekly Sales Data Backup
.
USE msdb;
GO
EXEC dbo.sp_start_job N'Weekly Sales Data Backup';
GO
Conteúdo relacionado
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de