jobs.sp_add_job (travaux élastiques Azure) (Transact-SQL)

  • Article

S’applique à Azure SQL Database

Ajoute un nouveau travail dans le service Travaux élastiques Azure pour Azure SQL Database.

Cette procédure stockée partage le nom d’un sp_add_job objet similaire dans SQL Server pour le service SQL Server Agent. Pour plus d’informations sur la version de SQL Server Agent, consultez sp_add_job (Transact-SQL).

Conventions de la syntaxe Transact-SQL

Syntaxe

[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 ]

Arguments

@job_name

Nom du travail. Le nom doit être unique et ne peut pas contenir le caractère pourcentage (%). job_name est nvarchar(128), sans valeur par défaut.

@description

Description du travail. la description est nvarchar(512), avec la valeur par défaut NULL. Si la description est omise, une chaîne vide est utilisée.

@enabled

Spécifie si la planification du travail est activée. Activé est bit, avec une valeur par défaut de 0 (désactivée). Si 0, le travail n’est pas activé et ne s’exécute pas selon sa planification ; toutefois, il peut être exécuté manuellement. Si 1, le travail s’exécute en fonction de sa planification et peut également être exécuté manuellement.

@schedule_interval_type

La valeur indique quand le travail doit être exécuté. schedule_interval_type est nvarchar(50), avec une valeur par défaut Once, et peut être l’une des valeurs suivantes :

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

@schedule_interval_count

Nombre de périodes schedule_interval_count à effectuer entre chaque exécution du travail. schedule_interval_count est int, avec la valeur par défaut 1. La valeur doit être supérieure ou égale à 1.

@schedule_start_time

Date à laquelle l'exécution du travail peut commencer. schedule_start_time est DATETIME2, avec la valeur par défaut 0001-01-01 00 :00 :00.0000000.

Toutes les heures indiquées dans les tâches élastiques sont exprimées dans le fuseau horaire UTC.

@schedule_end_time

Date à laquelle l'exécution du travail peut s'arrêter. schedule_end_time est DATETIME2, avec la valeur par défaut 9999-12-31 11 :59 :59.00000000.

Toutes les heures indiquées dans les tâches élastiques sont exprimées dans le fuseau horaire UTC.

@job_id

Numéro d'identification du travail affecté si le travail est correctement créé. job_id est une variable de sortie de type uniqueidentifier.

Codet de retour

0 (réussite) ou 1 (échec)

Notes

La procédure jobs.sp_add_job stockée doit être exécutée à partir de la base de données de l’agent de travail spécifiée lors de la création de l’agent de travail.

Après jobs.sp_add_job avoir été exécuté pour ajouter un travail, jobs.sp_add_jobstep pouvez être utilisé pour ajouter des étapes qui effectuent les activités du travail. Le numéro de version initial du travail est 0incrémenté au 1 moment de l’ajout de la première étape.

Autorisations

Par défaut, les membres du rôle serveur fixe sysadmin peuvent exécuter cette procédure stockée. Seuls des membres de sysadmin peuvent utiliser cette procédure stockée pour modifier les attributs des travaux qui appartiennent à d’autres utilisateurs.

Contenu connexe