sp_start_job (Transact-SQL)
Richiede a SQL Server Agent l'esecuzione immediata di un processo.
Convenzioni della sintassi Transact-SQL
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 job_id o job_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 job_id o job_name, ma non è possibile specificarli entrambi. job_id è di tipo uniqueidentifier e il valore predefinito è NULL.[ @error_flag= ] error_flag
Identificato solo a scopo informativo. Non supportato. 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
Identificato solo a scopo informativo. Non supportato. Non è garantita la compatibilità con le versioni future.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
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.
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