sp_addsubscriber (Transact-SQL)

S’applique à : SQL ServerAzure SQL Database

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’êtes plus obligé d’inscrire explicitement un Abonné sur le serveur de publication.

Conventions de la syntaxe Transact-SQL

Syntaxe

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

Arguments

[ @subscriber = ] N’subscriber'

Nom du serveur à ajouter en tant qu’Abonné valide aux publications sur ce serveur. @subscriber est sysname, sans valeur par défaut.

[ @type = ] type

Type d’Abonné. @type est tinyint et peut être l’une de ces valeurs.

Valeur Description
0 (valeur par défaut) Abonné SQL Server
1 Serveur de la source de données ODBC.
2 Base de données Microsoft Jet
3 Fournisseur OLE DB

[ @login = ] N’login'

ID de connexion pour l’authentification SQL Server. @login est sysname, avec la valeur par défaut NULL.

Remarque

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts. La propriété est maintenant spécifiée par abonnement lors de l’exécution de sp_addsubscription. Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @password = ] N’password'

Mot de passe pour l’authentification SQL Server. @password est nvarchar(524), avec la valeur par défaut NULL.

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

Remarque

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts. La propriété est maintenant spécifiée par abonnement lors de l’exécution de sp_addsubscription. Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @commit_batch_size = ] commit_batch_size

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts.

Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @status_batch_size = ] status_batch_size

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts.

Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @flush_frequency = ] flush_frequency

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts.

Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @frequency_type = ] frequency_type

Spécifie la fréquence avec laquelle planifier l’agent de réplication. @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

Remarque

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts. La propriété est maintenant spécifiée par abonnement lors de l’exécution de sp_addsubscription. Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @frequency_interval = ] frequency_interval

Valeur appliquée à la fréquence définie par @frequency_type. @frequency_interval est int, avec la valeur par défaut 1.

Remarque

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts. La propriété est maintenant spécifiée par abonnement lors de l’exécution de sp_addsubscription. Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @frequency_relative_interval = ] frequency_relative_interval

Date de l’agent de réplication. 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

Remarque

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts. La propriété est maintenant spécifiée par abonnement lors de l’exécution de sp_addsubscription. Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

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

Remarque

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts. La propriété est maintenant spécifiée par abonnement lors de l’exécution de sp_addsubscription. Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

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

Remarque

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts. La propriété est maintenant spécifiée par abonnement lors de l’exécution de sp_addsubscription. Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @frequency_subday_interval = ] frequency_subday_interval

Intervalle de frequency_subday. @frequency_subday_interval est int, avec la valeur par défaut 5.

Remarque

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts. La propriété est maintenant spécifiée par abonnement lors de l’exécution de sp_addsubscription. Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @active_start_time_of_day = ] active_start_time_of_day

Heure du jour où l’agent de réplication est planifié pour la première fois, mis en forme comme HHmmss. @active_start_time_of_day est int, avec la valeur par défaut 0.

Remarque

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts. La propriété est maintenant spécifiée par abonnement lors de l’exécution de sp_addsubscription. Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @active_end_time_of_day = ] active_end_time_of_day

Heure du jour où l’agent de réplication 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.

Remarque

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts. La propriété est maintenant spécifiée par abonnement lors de l’exécution de sp_addsubscription. Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @active_start_date = ] active_start_date

Date à laquelle l’agent de réplication 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.

Remarque

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts. La propriété est maintenant spécifiée par abonnement lors de l’exécution de sp_addsubscription. Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @active_end_date = ] active_end_date

Date à laquelle l’agent de réplication cesse d’être planifié, mis 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.

Remarque

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts. La propriété est maintenant spécifiée par abonnement lors de l’exécution de sp_addsubscription. Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @description = ] N’description'

Description textuelle de l’Abonné. @description est nvarchar(255), avec la valeur par défaut NULL.

[ @security_mode = ] security_mode

Mode de sécurité implémenté. @security_mode est int, avec la valeur par défaut 1.

  • 0 spécifie l’authentification SQL Server.
  • 1spécifie Authentification Windows.

Remarque

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts. La propriété est maintenant spécifiée par abonnement lors de l’exécution de sp_addsubscription. Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @encrypted_password = ] encrypted_password

Ce paramètre est déconseillé et est fourni uniquement pour la compatibilité descendante. Définir @encrypted_password sur n’importe quelle valeur, mais 0 entraîne une erreur.

[ @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 publication à partir d’un serveur de publication SQL Server.

Valeurs des codes de retour

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

Notes

sp_addsubscriber est utilisé dans la réplication d’instantanés, la réplication transactionnelle et la réplication de fusion.

sp_addsubscriber n’est pas obligatoire lorsque l’Abonné dispose uniquement d’abonnements anonymes pour fusionner des publications.

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

autorisations

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