sp_update_jobschedule |
Mise à jour de tâche de planification |
|---|---|
| SQL Server | |
Syntaxe
|
sp_update_jobschedule [@job_id =] job_id, | [@job_name =] 'job_name', [@name =] 'name' [, [@new_name =] 'new_name'] [, [@enabled =] enabled] [, [@freq_type =] freq_type] [, [@freq_interval =] freq_interval] [, [@freq_subday_type =] freq_subday_type] [, [@freq_subday_interval =] freq_subday_interval] [, [@freq_relative_interval =] freq_relative_interval] [, [@freq_recurrence_factor =] freq_recurrence_factor] [, [@active_start_date =] active_start_date] [, [@active_end_date =] active_end_date] [, [@active_start_time =] active_start_time] [, [@active_end_time =] active_end_time] |
Paramètres
| Nom | Description | |
|---|---|---|
| [@job_id =] job_id | Ce paramètre permet d'indiquer le numéro d'identification du travail auquel appartient la planification. Le job_id est uniqueidentifier, avec une valeur par défaut de NULL. | |
| [@job_name =] 'job_name' | Ce paramètre permet d'indiquer le nom du travail auquel appartient la planification. Chaque nom de tâche doit être unique. Le job_name est sysname, avec une valeur par défaut de NULL. | |
| [@name =] 'name' | Ce paramètre permet d'indiquer le nom de la planification à modifier. Le name est sysname et est sans valeur par défaut. | |
| [@new_name =] 'new_name' | Ce paramètre permet d'indiquer un nouveau nom pour l'horaire. Le new_name est sysname, avec une valeur par défaut NULL. | |
| [@enabled =] enabled | Ce paramètre permet d'indiquer si la planification est activée (1) ou non activée (0). Le enabled est tinyint, avec une valeur par défaut NULL. | |
| [@freq_type =] freq_type | Ce paramètre permet d'indiquer la fréquence d'exécution du travail. Le freq_type est un entier, avec une valeur par défaut NULL, et peut être l'une de ces valeurs. | |
| Valeur | Description | |
| 1 | Une fois que | |
| 4 | Quotidiennement | |
| 8 | Hebdomadaire | |
| 16 | Mensuellement | |
| 32 | Mensuel, par rapport au freq_interval. | |
| 64 | Exécuté au démarrage de l'Agent SQL Server. | |
| 128 | Exécuter lorsque l'ordinateur est inactif. | |
| [@freq_interval =] freq_interval | Ce paramètre permet d'indiquer que les jours d'exécution du travail. Le freq_interval est un entier, avec une valeur par défaut NULL. La valeur de freq_interval dépend de la valeur de freq_type. Si valeur de freq_type, alors il y a un effet sur freq_interval : | |
| 1 (une fois que) | freq_interval n'est pas utilisé | |
| 4 (du quotidien) | Tous les jours freq_interval. | |
| 8 (hebdomadaire) | freq_interval est un ou plusieurs des éléments suivants (OR ensemble) : | |
| Valeur | Description | |
| 1 | Dimanche | |
| 2 | Lundi | |
| 4 | Mardi | |
| 8 | Mercredi | |
| 16 | Jeudi | |
| 32 | Vendredi | |
| 64 | Samedi | |
| Valeur | Description | |
| 16 (mensuelle) | Le jour freq_interval du mois. | |
| 32 (parent mensuel) | freq_interval peut être l'une de ces valeurs : | |
| Valeur | Description | |
| 1 | Dimanche | |
| 2 | Lundi | |
| 3 | Mardi | |
| 4 | Mercredi | |
| 5 | Jeudi | |
| 6 | Vendredi | |
| 7 | Samedi | |
| 8 | Jour | |
| 9 | Jour de semaine | |
| 10 | Jour de fin de semaine | |
| 64 | (lorsque l'Agent SQL Server démarre) freq_interval n'est pas utilisé. | |
| [@freq_subday_type> =] freq_subday_type | Ce paramètre permet d'indiquer les unités de freq_subday_interval. freq_subday_type est un entier, avec une valeur par défaut de NULL, et peut être l'une de ces valeurs : | |
| Valeur | Description (unité) | |
| 0x1 | A l'heure indiquée. | |
| 0x4 | Les minutes. | |
| 0x8 | Les heures. | |
| [@freq_subday_interval =] freq_subday_interval | Ce paramètre permet d'indiquer le nombre de périodes freq_subday_type devant se produire entre chaque exécution du travail. freq_subday_interval est un entier, avec une valeur par défaut NULL. | |
| [@freq_relative_interval =] freq_relative_interval | Ce paramètre permet d'indiquer l'occurrence du travail planifié de freq_interval chaque mois, si freq_interval est 32 (relatif mensuel). freq_relative_interval est un entier, avec une valeur par défaut NULL, et peut être l'une de ces valeurs. | |
| Valeur | Description (unité) | |
| 1 | Premier | |
| 2 | Deuxième | |
| 4 | Troisième | |
| 8 | Quatrième | |
| 16 | Dernier | |
| [@freq_recurrence_factor =] freq_recurrence_factor | Ce paramètre permet d'indiquer le nombre de mois entre l'exécution planifiée du travail. freq_recurrence_factor est utilisé uniquement si freq_type est 8, 16 ou 32. Le freq_recurrence_factor est un entier, avec une valeur par défaut de NULL. | |
| [@active_start_date =] active_start_date | Ce paramètre permet d'indiquer la date à laquelle l'exécution du travail peut commencer. active_start_date est un entier, avec une valeur par défaut de NULL. Les valeurs doivent être au format AAAAMMJJ. Si active_start_date n'est pas NULL, la date doit être supérieure ou égale à 19900101. | |
| [@active_end_date =] active_end_date | Ce paramètre permet d'indiquer la date à laquelle l'exécution du travail peut s'arrêter. active_end_date est un entier, avec une valeur par défaut NULL. Les valeurs doivent être au format AAAAMMJJ. | |
| [@active_start_time =] active_start_time | Ce paramètre permet d'indiquer l'heure à laquelle n'importe quel jour entre active_start_date et active_end_date commence l'exécution de la tâche. active_start_time est un entier, avec une valeur par défaut de NULL. Les valeurs doivent être saisies à l'aide du formulaire HHMMSS. | |
| [@active_end_time =] active_end_time | Ce paramètre permet d'indiquer l'heure d'un jour entre active_start_date et active_end_date pour terminer l'exécution du travail. Le active_end_time est un entier, avec une valeur par défaut NULL. Les valeurs doivent être saisies à l'aide du formulaire HHMMSS. | |
Retour
| Valeur | Description |
|---|---|
| 0 | Cette valeur permet d'indiquer un succès. |
| 1 | Cette valeur permet d'indiquer un échec. |
Description
Cette Stored Procedure permet de modifier les paramètres de planification pour le travail spécifié.
Remarques
- Le paramètre job_id ou job_name doit être spécifié ; mais les deux paramètres ne peuvent pas être spécifiés en même temps.
- Le sp_update_jobschedule doit être exécuté à partir de la base de données msdb.
- La mise à jour d'une planification de tâche incrémente le numéro de version de la tâche.
- Les autorisations d'exécution par défaut sont le rôle public.
Exemple
L'exemple suivant permet de désactiver et de modifier le nom de la planification d'archivage du lundi du travail d'archivage des tables :
- USE msdb
- EXEC sp_update_jobschedule @job_name = 'Tables Archive',
- @name = 'Archive Lundi',
- @new_name = 'Archive du Lundi - DEACTIVATED',
- @enabled = 0
Dernière mise à jour : Dimanche, le 29 Août 2021