Condividi tramite


jobs.sp_add_job (processi elastici di Azure) (Transact-SQL)

Si applica a:database SQL di Azure

Aggiunge un nuovo processo nel servizio Processi elastici di Azure per database SQL di Azure.

Questa stored procedure condivide il nome di sp_add_job con un oggetto simile in SQL Server per il servizio SQL Server Agent. Per informazioni sulla versione di SQL Server Agent, vedere sp_add_job (Transact-SQL).

Convenzioni relative alla sintassi Transact-SQL

Sintassi

[jobs].sp_add_job [ @job_name = ] 'job_name'  
  [ , [ @description = ] 'description' ]
  [ , [ @enabled = ] enabled ]
  [ , [ @schedule_interval_type = ] schedule_interval_type ]  
  [ , [ @schedule_interval_count = ] schedule_interval_count ]
  [ , [ @schedule_start_time = ] schedule_start_time ]
  [ , [ @schedule_end_time = ] schedule_end_time ]
  [ , [ @job_id = ] job_id OUTPUT ]

Argomenti

@job_name

Il nome del processo. Il nome deve essere univoco e non può contenere il carattere percentuale (%). job_name è nvarchar(128), senza impostazione predefinita.

@description

Descrizione del processo. description è nvarchar(512), con un valore predefinito .NULL Se la descrizione viene omessa, viene usata una stringa vuota.

@enabled

Specifica se la pianificazione del processo è abilitata. Enabled è bit, con un valore predefinito pari a 0 (disabilitato). Se 0, il processo non è abilitato e non viene eseguito in base alla pianificazione, ma può essere eseguito manualmente. Se 1, il processo verrà eseguito in base alla pianificazione e può anche essere eseguito manualmente.

@schedule_interval_type

Valore che indica quando deve essere eseguito il processo. schedule_interval_type è nvarchar(50), con un valore predefinito e Oncepuò essere uno dei valori seguenti:

  • Once
  • Minutes
  • Hours
  • Days
  • Weeks
  • Months

@schedule_interval_count

Numero di periodi di schedule_interval_count da eseguire tra ogni esecuzione del processo. schedule_interval_count è int, con il valore predefinito 1. Il valore deve essere maggiore o uguale a 1.

@schedule_start_time

Data in cui l'esecuzione del processo può avere inizio. schedule_start_time è DATETIME2, con il valore predefinito 0001-01-01 00:00:00.0000000.

Tutti gli orari nei processi elastici sono espressi nel fuso orario UTC.

@schedule_end_time

Data in cui l'esecuzione del processo può essere arrestata. schedule_end_time è DATETIME2, con il valore predefinito 9999-12-31 11:59:59.0000000.

Tutti gli orari nei processi elastici sono espressi nel fuso orario UTC.

@job_id

Numero di identificazione del processo assegnato al processo se creato correttamente. job_id è una variabile di output di tipo uniqueidentifier.

Valori del codice restituito

0 (operazione completata) o 1 (operazione non riuscita)

Osservazioni:

La stored procedure jobs.sp_add_job deve essere eseguita dal database dell'agente processo specificato durante la creazione dell'agente di processo.

Dopo jobs.sp_add_job l'esecuzione per aggiungere un processo, è possibile usare jobs.sp_add_jobstep per aggiungere passaggi che eseguono le attività per il processo. Il numero di versione iniziale del processo è 0, che viene incrementato a 1 quando viene aggiunto il primo passaggio.

Autorizzazioni

Per impostazione predefinita, i membri del ruolo predefinito del server sysadmin possono eseguire questa stored procedure. Solo i membri del ruolo sysadmin possono usare questa stored procedure per modificare gli attributi dei processi di proprietà di altri utenti.