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.
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 Once
può 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
(esito positivo) o 1
(errore).
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, questa stored procedure può essere eseguita dai membri del ruolo predefinito del server sysadmin . Solo i membri del ruolo sysadmin possono usare questa stored procedure per modificare gli attributi dei processi di proprietà di altri utenti.