Condividi tramite

  • Articolo

sp_start_job (Transact-SQL)

Richiede a SQL Server Agent l'esecuzione immediata di un processo.

Icona di collegamento a un argomentoConvenzioni 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 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
    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