sp_start_job (Transact-SQL)
Si applica a: SQL Server Istanza gestita di SQL di Azure
Indica a SQL Server Agent di eseguire immediatamente un processo.
Convenzioni relative alla sintassi Transact-SQL
Sintassi
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 ]
[ ; ]
Argomenti
[ @job_name = ] N'job_name'
Nome del processo da avviare. @job_name è sysname, con il valore predefinito NULL
.
È necessario specificare @job_id o @job_name , ma non è possibile specificare entrambi.
[ @job_id = ] 'job_id'
Numero di identificazione del processo da avviare. @job_id è uniqueidentifier, con un valore predefinito .NULL
È necessario specificare @job_id o @job_name , ma non è possibile specificare entrambi.
[ @error_flag = ] error_flag
Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.
[ @server_name = ] N'server_name'
Server di destinazione in cui avviare il processo. @server_name è sysname, con un valore predefinito .NULL
@server_name deve essere uno dei server di destinazione a cui è attualmente destinato il processo.
[ @step_name = ] N'step_name'
Nome del passaggio da cui iniziare l'esecuzione del processo. @step_name è sysname, con un valore predefinito .NULL
Viene applicato solo ai processi locali.
[ @output_flag = ] output_flag
Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.
Valori del codice restituito
0
(esito positivo) o 1
(errore).
Set di risultati
Nessuno.
Osservazioni:
Questa stored procedure si trova nel msdb
database.
Questa stored procedure condivide il nome di con un oggetto simile per il servizio Processi elastici di sp_start_job
Azure per database SQL di Azure. Per informazioni sulla versione dei processi elastici, vedere jobs.sp_start_job (processi elastici di Azure).
È possibile concedere EXECUTE
autorizzazioni per questa procedura, ma queste autorizzazioni potrebbero essere sottoposte a override durante un aggiornamento di SQL Server.
È necessario concedere ad altri utenti uno dei ruoli predefiniti del database di SQL Server Agent seguenti:msdb
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
Per informazioni dettagliate sulle autorizzazioni di questi ruoli, vedere Ruoli di database predefiniti di SQL Server Agent.
I membri di SQLAgentUserRole e SQLAgentReaderRole possono avviare solo i processi di cui sono proprietari. I membri di SQLAgentOperatorRole possono avviare tutti i processi locali, inclusi i processi di proprietà di altri utenti. I membri di sysadmin possono avviare tutti i processi locali e multiserver.
Esempi
Nell'esempio seguente viene avviato un processo denominato Weekly Sales Data Backup
.
USE msdb;
GO
EXEC dbo.sp_start_job N'Weekly Sales Data Backup';
GO