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

Icône Lien de rubriqueConventions 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.