sp_changesubscriber_schedule (Transact-SQL)

  • Article

S’applique à : SQL Server Azure SQL Managed Instance

Modifie la planification de l'Agent de distribution ou de fusion pour un abonné. 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_changesubscriber_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. Le nom de l’Abonné 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, avec une valeur par défaut de 0.

  • 0indique une Agent de distribution.
  • 1indique une Agent de fusion.

[ @frequency_type = ] frequency_type

Spécifie la fréquence avec laquelle planifier la tâche 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 appliquée à la fréquence définie par @frequency_type. @frequency_interval est int, et dépend de la valeur de @frequency_type.

Valeur de @frequency_type Effet sur @frequency_interval
1 (valeur par défaut) @frequency_interval n’est pas utilisé.
4 Tous les @frequency_interval jours.
8 @frequency_interval est un ou plusieurs des éléments suivants (combinés à un | (OR au niveau du bit) (Transact-SQL) opérateur logique) :

1 = Dimanche
2 = Lundi
4 = Mardi
8 = Mercredi
16 = jeudi
32 = vendredi
64 = Samedi
16 Le @frequency_interval jour du mois.
32 @frequency_interval est l’une des options suivantes :

1 = Dimanche
2 = Lundi
3 = Mardi
4 = Mercredi
5 = jeudi
6 = vendredi
7 = Samedi
8 = Jour
9 = Jour de la semaine
10 = Jour du week-end
64 @frequency_interval n’est pas utilisé.
128 @frequency_interval n’est pas utilisé.

[ @frequency_relative_interval = ] frequency_relative_interval

Date de la tâche de distribution. @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

Spécifie la fréquence, en minutes, de 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

Nombre de périodes frequency_subday qui se produisent entre chaque exécution du travail. @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 tâche de distribution est planifiée pour la première fois. @active_start_time_of_day est int, avec la valeur par défaut NULL.

[ @active_end_time_of_day = ] active_end_time_of_day

Heure du jour où la tâche de distribution cesse d’être planifiée. @active_end_time_of_day est int, avec une valeur par défaut , 235959ce qui signifie 11:59:59 P.M. sur une horloge de 24 heures.

[ @active_start_date = ] active_start_date

Date à laquelle la tâche de distribution est planifiée pour la première fois, mise en forme en tant que yyyyMMdd. @active_start_date est int, avec une valeur par défaut de NULL.

[ @active_end_date = ] active_end_date

Date à laquelle la tâche de distribution cesse d’être planifiée, mise en forme en tant que yyyyMMdd. @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 utilisé lors de la modification des propriétés d’article sur un serveur de publication SQL Server.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Notes

sp_changesubscriber_schedule est utilisé dans tous les types de réplication.

autorisations

Seuls les membres du rôle serveur fixe sysadmin peuvent s’exécuter.sp_changesubscriber_schedule

Contenu connexe