sp_addsubscriber_schedule (Transact-SQL)

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 de Transact-SQL

Syntaxe

sp_addsubscriber_schedule [ @subscriber = ] '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 = ] 'publisher' ]

Arguments

• [ @subscriber = ] 'subscriber'
  Nom de l'Abonné. subscriber est de type sysname. Le nom de l'abonné doit être unique dans la base de données, il ne doit pas encore exister et ne peut pas avoir la valeur NULL.

• [ @agent_type = ] agent_type
  Type d'agent. agent_type est de type smallint et peut prendre l'une des valeurs suivantes.

  Valeur	Description
  0 (valeur par défaut)	Agent de distribution
  1	Agent de fusion

• [ @frequency_type = ] frequency_type
  Fréquence de planification de l'Agent de distribution. frequency_type est de type int et peut prendre l'une des valeurs suivantes.

  Valeur	Description
  1	Une fois
  2	Sur demande
  4	Quotidiennement
  8	Hebdomadairement
  16	Mensuellement
  32	Relatif mensuel
  64 (valeur par défaut)	Démarrage automatique
  128	Périodique

• [ @frequency_interval = ] frequency_interval
  Valeur à appliquer à la fréquence définie par frequency_type. frequency_interval est de type int, avec 1 comme valeur par défaut.

• [ @frequency_relative_interval = ] frequency_relative_interval
  Date de l'Agent de distribution. Ce paramètre est utilisé lorsque frequency_type a la valeur 32 (fréquence mensuelle relative). frequency_relative_interval est de type int et peut prendre l'une des valeurs suivantes.

  Valeur	Description
  1 (valeur par défaut)	Premier
  2	Deuxième
  4	Troisième
  8	Quatrième
  16	Dernier

• [ @frequency_recurrence_factor = ] frequency_recurrence_factor
  Facteur de récurrence utilisé par frequency_type. frequency_recurrence_factor est de type int, avec 0 comme valeur par défaut.

• [ @frequency_subday = ] frequency_subday
  Fréquence de replanification au cours de la période définie. frequency_subday est de type int et peut prendre l'une des valeurs suivantes.

  Valeur	Description
  1	Une fois
  2	Seconde
  4 (valeur par défaut)	Minute
  8	Heure

• [ @frequency_subday_interval = ] frequency_subday_interval
  Intervalle pour frequency_subday. frequency_subday_interval est de type int, avec 5 comme valeur par défaut.

• [ @active_start_time_of_day = ] active_start_time_of_day
  Heure de la journée à laquelle l'Agent de distribution est planifié pour la première fois, représentée au format HHMMSS. active_start_time_of_day est de type int, avec 0 comme valeur par défaut.

• [ @active_end_time_of_day = ] active_end_time_of_day
  Heure de la journée à laquelle l'Agent de distribution cesse d'être planifié, représentée au format HHMMSS. active_end_time_of_day est de type int, avec 235959 comme valeur par défaut (ce qui correspond à 23:59:59 avec un affichage horaire au format 24 heures).

• [ @active_start_date = ] active_start_date
  Date à laquelle l'Agent de distribution est planifié pour la première fois, représentée au format AAAAMMJJ. active_start_date est de type int, avec 0 comme valeur par défaut.

• [ @active_end_date = ] active_end_date
  Date à laquelle l'Agent de distribution cesse d'être planifié, représentée au format AAAAMMJJ. active_end_date est de type int, avec 99991231 comme valeur par défaut (ce qui correspond au 31 décembre 9999).

• [ @publisher = ] 'publisher'
  Spécifie un serveur de publication non-MicrosoftSQL Server. publisher est de type sysname, avec NULL comme valeur par défaut.

  [!REMARQUE]

  L'argument publisher ne doit pas être spécifié pour un serveur de publication SQL Server.

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

sp_addsubscriber_schedule est utilisée lors des réplications transactionnelles, de capture instantanée et de fusion.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin peuvent exécuter sp_addsubscriber_schedule.

Voir aussi

Référence

sp_changesubscriber_schedule (Transact-SQL)

Procédures stockées système (Transact-SQL)