sp_addsubscriber (Transact-SQL)
Ajoute un nouvel Abonné à un serveur de publication, lui permettant ainsi de recevoir des publications. Pour les publications transactionnelles et de captures instantanées, 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.
![]() |
---|
Cette procédure stockée a cependant été retirée des fonctionnalités. Vous n'avez donc plus besoin d'enregistrer un Abonné de façon explicite auprès du serveur de publication. |
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, sans 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 (valeur par défaut)
Microsoft Abonné 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 a été désapprouvé 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é :
N'utilisez pas de mot de passe vide, mais un mot de passe fort. Remarque :
Ce paramètre a été désapprouvé 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 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 a été désapprouvé 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 a été désapprouvé 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 a été désapprouvé 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
Mensuel relatif
64 (valeur par défaut)
Démarrage automatique
128
Périodique
Remarque :
Ce paramètre est à déconseiller 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.
[@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 a été désapprouvé 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)
Premier
2
Deuxième
4
Troisième
8
Quatrième
16
Dernier
Remarque :
Ce paramètre est à déconseiller 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.
[ @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 a été désapprouvé 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 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
Deuxième
4 (valeur par défaut)
Minute
8
Heure
Remarque :
Ce paramètre est à déconseiller 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.
[ @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 a été désapprouvé 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 de la journée à laquelle l'Agent de réplication 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.Remarque :
Ce paramètre a été désapprouvé 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 de la journée à laquelle l'Agent de réplication 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).Remarque :
Ce paramètre est à déconseiller 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, représentée au format AAAAMMJJ. active_start_date est de type int, avec 0 comme valeur par défaut.Remarque :
Ce paramètre a été désapprouvé 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 a été désapprouvé 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'
Description de l'Abonné. description est de type nvarchar(255), avec NULL comme valeur par défaut.
[ @security_mode=] security_mode
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éconseiller 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 a été désapprouvé 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, de capture instantanée 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 de 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)
Autres ressources
Procédure : créer un abonnement par envoi de données (programmation Transact-SQL de réplication)
Procédure : créer un abonnement par extraction de données (programmation Transact-SQL de réplication)