sp_addsubscriber_schedule (Transact-SQL)
S’applique à : SQL Server Azure SQL Managed Instance
Ajoute une planification de l'Agent de distribution et de l'Agent de fusion. Cette procédure stockée est exécutée sur n'importe quelle base de données du serveur de publication.
Conventions de la syntaxe Transact-SQL
Syntaxe
sp_addsubscriber_schedule
[ @subscriber = ] N'subscriber'
[ , [ @agent_type = ] agent_type ]
[ , [ @frequency_type = ] frequency_type ]
[ , [ @frequency_interval = ] frequency_interval ]
[ , [ @frequency_relative_interval = ] frequency_relative_interval ]
[ , [ @frequency_recurrence_factor = ] frequency_recurrence_factor ]
[ , [ @frequency_subday = ] frequency_subday ]
[ , [ @frequency_subday_interval = ] frequency_subday_interval ]
[ , [ @active_start_time_of_day = ] active_start_time_of_day ]
[ , [ @active_end_time_of_day = ] active_end_time_of_day ]
[ , [ @active_start_date = ] active_start_date ]
[ , [ @active_end_date = ] active_end_date ]
[ , [ @publisher = ] N'publisher' ]
[ ; ]
Arguments
[ @subscriber = ] N’subscriber'
Nom de l'Abonné. @subscriber est sysname, sans valeur par défaut. @subscriber doit être unique dans la base de données, ne doit pas déjà exister et ne peut pas être NULL
.
[ @agent_type = ] agent_type
Type d’agent. @agent_type est smallint et peut être l’une de ces valeurs.
Valeur | Description |
---|---|
0 (valeur par défaut) |
Agent de distribution |
1 |
Agent de fusion |
[ @frequency_type = ] frequency_type
Spécifie la fréquence avec laquelle planifier le Agent de distribution. @frequency_type est int et peut être l’une de ces valeurs.
Valeur | Description |
---|---|
1 |
Ponctuelle |
2 |
À la demande |
4 |
Quotidiennement |
8 |
Hebdomadaire |
16 |
Mensuelle |
32 |
Mensuelle relative |
64 (valeur par défaut) |
Démarrage automatique |
128 |
Récurrent |
[ @frequency_interval = ] frequency_interval
Valeur à appliquer à la fréquence définie par frequency_type. @frequency_interval est int, avec la valeur par défaut 1
.
[ @frequency_relative_interval = ] frequency_relative_interval
Date du Agent de distribution. Ce paramètre est utilisé lorsque frequency_type est défini 32
sur (relatif mensuel). @frequency_relative_interval est int et peut être l’une de ces valeurs.
Valeur | Description |
---|---|
1 (valeur par défaut) |
First |
2 |
Second |
4 |
Third |
8 |
Quatrième |
16 |
Dernière |
[ @frequency_recurrence_factor = ] frequency_recurrence_factor
Facteur de périodicité utilisé par frequency_type. @frequency_recurrence_factor est int, avec la valeur par défaut 0
.
[ @frequency_subday = ] frequency_subday
Fréquence à replanifier pendant la période définie. @frequency_subday est int et peut être l’une de ces valeurs.
Valeur | Description |
---|---|
1 |
Une fois |
2 |
Second |
4 (valeur par défaut) |
Minute |
8 |
Heure |
[ @frequency_subday_interval = ] frequency_subday_interval
Intervalle de frequency_subday. @frequency_subday_interval est int, avec la valeur par défaut 5
.
[ @active_start_time_of_day = ] active_start_time_of_day
Heure du jour où la Agent de distribution est planifiée pour la première fois, mise en forme comme HHmmss
. @active_start_time_of_day est int, avec la valeur par défaut 0
.
[ @active_end_time_of_day = ] active_end_time_of_day
Heure du jour où le Agent de distribution cesse d’être planifié, mis en forme comme HHmmss
. @active_end_time_of_day est int, avec une valeur par défaut , 235959
ce qui signifie 11:59:59 P.M. comme mesuré sur une horloge de 24 heures.
[ @active_start_date = ] active_start_date
Date à laquelle le Agent de distribution est planifié pour la première fois, mis en forme en tant que yyyyMMdd
. @active_start_date est int, avec une valeur par défaut de 0
.
[ @active_end_date = ] active_end_date
Date à laquelle la Agent de distribution cesse d’être planifiée, mise en forme comme yyyyMMdd
suit : @active_end_date est int, avec une valeur par défaut 99991231
, ce qui signifie le 31 décembre 9999.
[ @publisher = ] N’publisher'
Spécifie un serveur de publication non-SQL Server. @publisher est sysname, avec la valeur par défaut NULL
.
@publisher ne doit pas être spécifié pour un serveur de publication SQL Server.
Valeurs des codes de retour
0
(réussite) or 1
(échec).
Notes
sp_addsubscriber_schedule
est utilisé dans la réplication d’instantanés, la réplication transactionnelle et la réplication de fusion.
autorisations
Seuls les membres du rôle serveur fixe sysadmin peuvent s’exécuter.sp_addsubscriber_schedule