sp_addsubscriber (Transact-SQL)

  • Article

Ajoute un nouvel Abonné à un serveur de publication, lui permettant ainsi de recevoir des publications. Pour les publications transactionnelles et d'instantanés, cette procédure stockée s'exécute à partir du serveur de publication sur la base de données de publication. Pour les publications de fusion, elle s'exécute au niveau d'un serveur de distribution distant.

Important

Cette procédure stockée est désormais déconseillée. Vous n'avez donc plus besoin d'enregistrer un Abonné de façon explicite auprès du serveur de publication.

Icône Lien de rubrique Conventions de la syntaxe de Transact-SQL

Syntaxe

sp_addsubscriber [ @subscriber = ] 'subscriber'
    [ , [ @type = ] type ] 
    [ , [ @login = ] 'login' ]
    [ , [ @password = ] 'password' ]
    [ , [ @commit_batch_size = ] commit_batch_size ]
    [ , [ @status_batch_size = ] status_batch_size ]
    [ , [ @flush_frequency = ] flush_frequency ]
    [ , [ @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 ]
    [ , [ @description = ] 'description' ]
    [ , [ @security_mode = ] security_mode ]
    [ , [ @encrypted_password = ] encrypted_password ]
    [ , [ @publisher = ] 'publisher' ]

Arguments

  • [ @subscriber=] 'subscriber'
    Nom du serveur à ajouter en tant qu'abonné valide aux publications de ce serveur. subscriber est de type sysname et n'a pas de valeur par défaut.

  • [ @type=] type
    Type d'abonné. type est de type tinyint et peut prendre l'une des valeurs suivantes.

    Valeur

    Description

    0 (par défaut)

    Abonné Microsoft SQL Server

    1

    Serveur de la source de données ODBC.

    2

    Base de données Microsoft Jet

    3

    Fournisseur OLE DB

  • [ @login=] 'login'
    ID de connexion pour l'authentification SQL Server. login est de type sysname, avec NULL comme valeur par défaut.

    [!REMARQUE]

    Ce paramètre est déconseillé et n'est conservé que pour assurer la compatibilité descendante des scripts. La propriété est à présent spécifiée pour chaque abonnement lors de l'exécution de sp_addsubscription. Lorsqu'une valeur est spécifiée, elle sert de valeur par défaut lors de la création d'abonnements pour cet Abonné et un message d'avertissement s'affiche.

  • [ @password=] 'password'
    Mot de passe pour l'authentification SQL Server. password est de type nvarchar(524), avec NULL comme valeur par défaut.

    Remarque relative à la sécuritéRemarque relative à la sécurité

    N'utilisez pas de mot de passe vide. Utilisez un mot de passe fort.

    [!REMARQUE]

    Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis. La propriété est à présent spécifiée pour chaque abonnement lors de l'exécution de sp_addsubscription. Lorsqu'une valeur est spécifiée, elle sert alors de valeur par défaut au moment de la création des abonnements pour cet Abonné et un message d'avertissement s'affiche.

  • [ @commit_batch_size=] commit_batch_size
    Ce paramètre est déconseillé et n'est conservé que pour assurer la compatibilité descendante des scripts.

    [!REMARQUE]

    Lorsqu'une valeur est spécifiée, elle sert de valeur par défaut lors de la création d'abonnements pour cet Abonné et un message d'avertissement s'affiche.

  • [ @status_batch_size=] status_batch_size
    Ce paramètre est déconseillé et n'est conservé que pour assurer la compatibilité descendante des scripts.

    [!REMARQUE]

    Lorsqu'une valeur est spécifiée, elle sert de valeur par défaut lors de la création d'abonnements pour cet Abonné et un message d'avertissement s'affiche.

  • [ @flush_frequency=] flush_frequency
    Ce paramètre est déconseillé et n'est conservé que pour assurer la compatibilité descendante des scripts.

    [!REMARQUE]

    Lorsqu'une valeur est spécifiée, elle sert de valeur par défaut lors de la création d'abonnements pour cet Abonné et un message d'avertissement s'affiche.

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

    Valeur

    Description

    1

    Une fois

    2

    À la demande

    4

    Quotidienne

    8

    Hebdomadaire

    16

    Mensuelle

    32

    Mensuelle relative

    64 (valeur par défaut)

    Démarrage automatique

    128

    Périodique

    [!REMARQUE]

    Ce paramètre est déconseillé et n'est conservé que pour assurer la compatibilité descendante des scripts. La propriété est à présent spécifiée pour chaque abonnement lors de l'exécution de sp_addsubscription. Lorsqu'une valeur est spécifiée, elle sert alors de valeur par défaut au moment de la création des abonnements pour cet Abonné et un message d'avertissement s'affiche.

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

    [!REMARQUE]

    Ce paramètre est déconseillé et n'est conservé que pour assurer la compatibilité descendante des scripts. La propriété est à présent spécifiée pour chaque abonnement lors de l'exécution de sp_addsubscription. Lorsqu'une valeur est spécifiée, elle sert de valeur par défaut lors de la création d'abonnements pour cet Abonné et un message d'avertissement s'affiche.

  • [ @frequency_relative_interval=] frequency_relative_interval
    Date de l'Agent de réplication. 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)

    Première

    2

    Seconde

    4

    Troisième

    8

    Quatrième

    16

    Dernière

    [!REMARQUE]

    Ce paramètre est déconseillé et n'est conservé que pour assurer la compatibilité descendante des scripts. La propriété est à présent spécifiée pour chaque abonnement lors de l'exécution de sp_addsubscription. Lorsqu'une valeur est spécifiée, elle sert alors de valeur par défaut au moment de la création des abonnements pour cet Abonné et un message d'avertissement s'affiche.

  • [ @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.

    [!REMARQUE]

    Ce paramètre est déconseillé et n'est conservé que pour assurer la compatibilité descendante des scripts. La propriété est à présent spécifiée pour chaque abonnement lors de l'exécution de sp_addsubscription. Lorsqu'une valeur est spécifiée, elle sert de valeur par défaut lors de la création d'abonnements pour cet Abonné et un message d'avertissement s'affiche.

  • [ @frequency_subday=] frequency_subday
    Fréquence de replanification nécessaire pendant 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

    [!REMARQUE]

    Ce paramètre est déconseillé et n'est conservé que pour assurer la compatibilité descendante des scripts. La propriété est à présent spécifiée pour chaque abonnement lors de l'exécution de sp_addsubscription. Lorsqu'une valeur est spécifiée, elle sert alors de valeur par défaut au moment de la création des abonnements pour cet Abonné et un message d'avertissement s'affiche.

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

    [!REMARQUE]

    Ce paramètre est déconseillé et n'est conservé que pour assurer la compatibilité descendante des scripts. La propriété est à présent spécifiée pour chaque abonnement lors de l'exécution de sp_addsubscription. Lorsqu'une valeur est spécifiée, elle sert de valeur par défaut lors de la création d'abonnements pour cet Abonné et un message d'avertissement s'affiche.

  • [ @active_start_time_of_day=] active_start_time_of_day
    Heure à laquelle l’Agent de réplication est planifié pour la première fois, au format HHMMSS. active_start_time_of_day est de type int, avec 0 comme valeur par défaut.

    [!REMARQUE]

    Ce paramètre est déconseillé et n'est conservé que pour assurer la compatibilité descendante des scripts. La propriété est à présent spécifiée pour chaque abonnement lors de l'exécution de sp_addsubscription. Lorsqu'une valeur est spécifiée, elle sert de valeur par défaut lors de la création d'abonnements pour cet Abonné et un message d'avertissement s'affiche.

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

    [!REMARQUE]

    Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis. La propriété est à présent spécifiée pour chaque abonnement lors de l'exécution de sp_addsubscription. Lorsqu'une valeur est spécifiée, elle sert alors de valeur par défaut au moment de la création des abonnements pour cet Abonné et un message d'avertissement s'affiche.

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

    [!REMARQUE]

    Ce paramètre est déconseillé et n'est conservé que pour assurer la compatibilité descendante des scripts. La propriété est à présent spécifiée pour chaque abonnement lors de l'exécution de sp_addsubscription. Lorsqu'une valeur est spécifiée, elle sert de valeur par défaut lors de la création d'abonnements pour cet Abonné et un message d'avertissement s'affiche.

  • [ @active_end_date=] active_end_date
    Date à laquelle l'Agent de réplication 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).

    [!REMARQUE]

    Ce paramètre est déconseillé et n'est conservé que pour assurer la compatibilité descendante des scripts. La propriété est à présent spécifiée pour chaque abonnement lors de l'exécution de sp_addsubscription. Lorsqu'une valeur est spécifiée, elle sert de valeur par défaut lors de la création d'abonnements pour cet Abonné et un message d'avertissement s'affiche.

  • [ @description=] 'description'
    Texte de description de l'Abonné. description est de type nvarchar(255), avec NULL comme valeur par défaut.

  • [ @security_mode=] security_mode
    Représente le mode de sécurité implémenté. security_mode est de type int, avec 1 comme valeur par défaut. La valeur 0 spécifie l'authentification SQL Server. La valeur 1 spécifie l'authentification Windows.

    [!REMARQUE]

    Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis. La propriété est à présent spécifiée pour chaque abonnement lors de l'exécution de sp_addsubscription. Lorsqu'une valeur est spécifiée, elle sert alors de valeur par défaut au moment de la création des abonnements pour cet Abonné et un message d'avertissement s'affiche.

  • [ @encrypted_password=] encrypted_password
    Ce paramètre est déconseillé et n'est fourni que pour des raisons de compatibilité descendante. Si vous définissez une valeur autre que 0 pour encrypted_password, une erreur est retournée.

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

    [!REMARQUE]

    L'argument publisher ne doit pas être utilisé lors de la publication à partir d'un serveur de publication SQL Server.

Valeurs des codes de retour

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

Notes

sp_addsubscriber est utilisée lors des réplications transactionnelles, d'instantané et de fusion.

sp_addsubscriber n'est pas requise si l'Abonné dispose uniquement d'abonnements anonymes à des publications de fusion.

sp_addsubscriber écrit dans la table MSsubscriber_info de la base de données distribution.

Autorisations

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

Voir aussi

Référence

sp_changesubscriber (Transact-SQL)

sp_dropsubscriber (Transact-SQL)

sp_helpsubscriberinfo (Transact-SQL)

Concepts

Créer un abonnement par émission (push)

Créer un abonnement par extraction de données (pull)