sp_start_job (Transact-SQL)
Richiede a SQL Server Agent l'esecuzione immediata di un processo.
Sintassi
sp_start_job
{ [@job_name =] 'job_name'
| [@job_id =] job_id }
[ , [@error_flag =] error_flag]
[ , [@server_name =] 'server_name']
[ , [@step_name =] 'step_name']
[ , [@output_flag =] output_flag]
Argomenti
- [ @job_name= ] 'job_name'
Nome del processo da avviare. È necessario specificare l'argomento job_id o l'argomento jjob_name ma non è possibile specificarli entrambi. job_name è di tipo sysname e il valore predefinito è NULL.
- [ @job_id= ] job_id
Numero di identificazione del processo da avviare. È necessario specificare l'argomento job_id o l'argomento jjob_name ma non è possibile specificarli entrambi. job_id è di tipo uniqueidentifier e il valore predefinito è NULL.
- [ @error_flag= ] error_flag
Identificazione a solo scopo informativo. Supporto non fornito. Non è garantita la compatibilità con le versioni future.
- [ @server_name= ] 'server_name'
Server di destinazione in cui avviare il processo. server_name è di tipo nvarchar(128) e il valore predefinito è NULL. server_name deve corrispondere a uno dei server di destinazione a cui è indirizzato il processo.
- [ @step_name= ] 'step_name'
Nome del passaggio da cui iniziare l'esecuzione del processo. Viene applicato solo ai processi locali. step_name è di tipo sysname e il valore predefinito è NULL.
- [ @output_flag= ] output_flag
Identificazione a solo scopo informativo. Supporto non fornito. Non è garantita la compatibilità con le versioni future.
Set di risultati
Nessuno
Osservazioni
Questa stored procedure è archiviata nel database msdb.
Autorizzazioni
Per impostazione predefinita, questa stored procedure può essere eseguita dai membri del ruolo predefinito del server sysadmin. Gli altri utenti devono appartenere a uno dei seguenti ruoli predefiniti del database di SQL Server Agent nel database msdb:
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
Per informazioni 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 quelli di proprietà di altri utenti. I membri di sysadmin possono avviare tutti i processi locali e multiserver.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
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
Vedere anche
Riferimento
sp_delete_job (Transact-SQL)
sp_help_job (Transact-SQL)
sp_stop_job (Transact-SQL)
sp_update_job (Transact-SQL)
Stored procedure di sistema (Transact-SQL)