sp_start_job (Transact-SQL)

  • Articolo

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).

Questa stored procedure è di proprietà del ruolo db_owner . È possibile concedere EXECUTE autorizzazioni per qualsiasi utente, ma queste autorizzazioni possono 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

Contenuto correlato