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 , 235959ce 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 yyyyMMddsuit : @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) ou 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