sp_addsubscriber (Transact-SQL)sp_addsubscriber (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Ajoute un nouvel Abonné à un serveur de publication, lui permettant ainsi de recevoir des publications.Adds a new Subscriber to a Publisher, enabling it to receive 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.This stored procedure is executed at the Publisher on the publication database for snapshot and transactional publications; and for merge publications using a remote Distributor, this stored procedure is executed at the Distributor.

Important

Cette procédure stockée est désormais déconseillée.This stored procedure has been deprecated. Vous n'avez donc plus besoin d'enregistrer un Abonné de façon explicite auprès du serveur de publication.You are no longer required to explicitly register a Subscriber at the Publisher.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

  
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' ]  

ArgumentsArguments

[ @subscriber = ] 'subscriber'Nom du serveur à ajouter en tant qu’abonné valide aux publications de ce serveur.[ @subscriber = ] 'subscriber' Is the name of the server to be added as a valid Subscriber to the publications on this server. Subscriber est de type sysname, sans valeur par défaut.subscriber is sysname, with no default.

[ @type = ] typeType de l’abonné.[ @type = ] type Is the type of Subscriber. type est de type tinyintet peut prendre l’une des valeurs suivantes.type is tinyint, and can be one of these values.

ValueValue DescriptionDescription
0 (valeur par défaut)0 (default) MicrosoftMicrosoftSQL ServerSQL Server AbonnéSQL ServerSQL Server Subscriber
11 Serveur de la source de données ODBC.ODBC data source server
22 Base de données MicrosoftMicrosoft JetMicrosoftMicrosoft Jet database
33 Fournisseur OLE DBOLE DB provider

[ @login = ] 'login'ID de connexion pour SQL ServerSQL Server l’authentification.[ @login = ] 'login' Is the login ID for SQL ServerSQL Server Authentication. login est de type sysname, avec NULL comme valeur par défaut.login is sysname, with a default of NULL.

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. La propriété est maintenant spécifiée sur une base par abonnement lors de l’exécution de sp_addsubscription.The property is now specified on a per-subscription basis when executing 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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @password = ] 'password'Mot de passe pour SQL ServerSQL Server l’authentification.[ @password = ] 'password' Is the password for SQL ServerSQL Server Authentication. Password est de type nvarchar (524) , avec NULL comme valeur par défaut.password is nvarchar(524), with a default of NULL.

Important

N'utilisez pas de mot de passe vide.Do not use a blank password. Utilisez un mot de passe fort.Use a strong password.

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. La propriété est maintenant spécifiée sur une base par abonnement lors de l’exécution de sp_addsubscription.The property is now specified on a per-subscription basis when executing 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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @commit_batch_size = ] commit_batch_sizeCe paramètre est déconseillé et conservé pour la compatibilité descendante des scripts.[ @commit_batch_size = ] commit_batch_size This parameter has been deprecated and is maintained for backward compatibility of scripts.

Notes

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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @status_batch_size = ] status_batch_sizeCe paramètre est déconseillé et conservé pour la compatibilité descendante des scripts.[ @status_batch_size = ] status_batch_size This parameter has been deprecated and is maintained for backward compatibility of scripts.

Notes

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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @flush_frequency = ] flush_frequencyCe paramètre est déconseillé et conservé pour la compatibilité descendante des scripts.[ @flush_frequency = ] flush_frequency This parameter has been deprecated and is maintained for backward compatibility of scripts.

Notes

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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_type = ] frequency_typeFréquence de planification de l’agent de réplication.[ @frequency_type = ] frequency_type Is the frequency with which to schedule the replication agent. frequency_type est de type intet peut prendre l’une des valeurs suivantes.frequency_type is int, and can be one of these values.

ValueValue DescriptionDescription
11 Une foisOne time
22 À la demandeOn demand
44 Tous les joursDaily
88 SemaineWeekly
1616 MoisMonthly
3232 Mensuelle relativeMonthly relative
64 (valeur par défaut)64 (default) Démarrage automatiqueAutostart
128128 PériodiqueRecurring

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. La propriété est maintenant spécifiée sur une base par abonnement lors de l’exécution de sp_addsubscription.The property is now specified on a per-subscription basis when executing 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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_interval=** ] frequency_interval[@frequency_interval=** ] frequency_interval
Valeur appliquée à la fréquence définie par frequency_type.Is the value applied to the frequency set by frequency_type. frequency_interval est de type int, avec 1 comme valeur par défaut.frequency_interval is int, with a default of 1.

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. La propriété est maintenant spécifiée sur une base par abonnement lors de l’exécution de sp_addsubscription.The property is now specified on a per-subscription basis when executing 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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_relative_interval = ] frequency_relative_intervalDate de l’agent de réplication.[ @frequency_relative_interval = ] frequency_relative_interval Is the date of the replication agent. Ce paramètre est utilisé lorsque frequency_type a la valeur 32 (mensuelle relative).This parameter is used when frequency_type is set to 32 (monthly relative). frequency_relative_interval est de type intet peut prendre l’une des valeurs suivantes.frequency_relative_interval is int, and can be one of these values.

ValueValue DescriptionDescription
1 (par défaut)1 (default) PremièreFirst
22 SecondeSecond
44 TroisièmeThird
88 QuatrièmeFourth
1616 DernièreLast

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. La propriété est maintenant spécifiée sur une base par abonnement lors de l’exécution de sp_addsubscription.The property is now specified on a per-subscription basis when executing 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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_recurrence_factor = ] frequency_recurrence_factorFacteur de récurrence utilisé par frequency_type.[ @frequency_recurrence_factor = ] frequency_recurrence_factor Is the recurrence factor used by frequency_type. frequency_recurrence_factor est de type int, avec 0comme valeur par défaut.frequency_recurrence_factor is int, with a default of 0.

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. La propriété est maintenant spécifiée sur une base par abonnement lors de l’exécution de sp_addsubscription.The property is now specified on a per-subscription basis when executing 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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_subday = ] frequency_subdayFréquence de replanification au cours de la période définie.[ @frequency_subday = ] frequency_subday Is how often to reschedule during the defined period. frequency_subday est de type intet peut prendre l’une des valeurs suivantes.frequency_subday is int, and can be one of these values.

ValueValue DescriptionDescription
11 Une foisOnce
22 SecondeSecond
4 (par défaut)4 (default) MinuteMinute
88 HeureHour

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. La propriété est maintenant spécifiée sur une base par abonnement lors de l’exécution de sp_addsubscription.The property is now specified on a per-subscription basis when executing 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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @frequency_subday_interval = ] frequency_subday_intervalIntervalle de frequency_subday.[ @frequency_subday_interval = ] frequency_subday_interval Is the interval for frequency_subday. frequency_subday_interval est de type int, avec 5comme valeur par défaut.frequency_subday_interval is int, with a default of 5.

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. La propriété est maintenant spécifiée sur une base par abonnement lors de l’exécution de sp_addsubscription.The property is now specified on a per-subscription basis when executing 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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @active_start_time_of_day = ] active_start_time_of_dayHeure de la journée à laquelle l’agent de réplication est planifié pour la première fois, au format HHMMSS.[ @active_start_time_of_day = ] active_start_time_of_day Is the time of day when the replication agent is first scheduled, formatted as HHMMSS. active_start_time_of_day est de type int, avec 0comme valeur par défaut.active_start_time_of_day is int, with a default of 0.

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. La propriété est maintenant spécifiée sur une base par abonnement lors de l’exécution de sp_addsubscription.The property is now specified on a per-subscription basis when executing 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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @active_end_time_of_day = ] active_end_time_of_dayHeure de la journée à laquelle l’agent de réplication cesse d’être planifié, au format HHMMSS.[ @active_end_time_of_day = ] active_end_time_of_day Is the time of day when the replication agent stops being scheduled, formatted as HHMMSS. active_end_time_of_dayest de type int, avec 235959 comme valeur par défaut, ce qui signifie 11:59:59 P.M.active_end_time_of_dayis int, with a default of 235959, which means 11:59:59 P.M. mesurée sur une horloge de 24 heures.as measured on a 24-hour clock.

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. La propriété est maintenant spécifiée sur une base par abonnement lors de l’exécution de sp_addsubscription.The property is now specified on a per-subscription basis when executing 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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @active_start_date = ] active_start_dateDate à laquelle l’agent de réplication est planifié pour la première fois, au format AAAAMMJJ.[ @active_start_date = ] active_start_date Is the date when the replication agent is first scheduled, formatted as YYYYMMDD. active_start_date est de type int, avec 0 comme valeur par défaut.active_start_date is int, with a default of 0.

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. La propriété est maintenant spécifiée sur une base par abonnement lors de l’exécution de sp_addsubscription.The property is now specified on a per-subscription basis when executing 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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @active_end_date = ] active_end_dateDate à laquelle l’agent de réplication cesse d’être planifié, au format AAAAMMJJ.[ @active_end_date = ] active_end_date Is the date when the replication agent stops being scheduled, formatted as YYYYMMDD. active_end_date est de type int, avec 99991231 comme valeur par défaut, ce qui correspond au 31 décembre 9999.active_end_date is int, with a default of 99991231, which means December 31, 9999.

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. La propriété est maintenant spécifiée sur une base par abonnement lors de l’exécution de sp_addsubscription.The property is now specified on a per-subscription basis when executing 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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @description = ] 'description'Description textuelle de l’abonné.[ @description = ] 'description' Is a text description of the Subscriber. Description est de type nvarchar (255) , avec NULL comme valeur par défaut.description is nvarchar(255), with a default of NULL.

[ @security_mode = ] security_modeEst le mode de sécurité implémenté.[ @security_mode = ] security_mode Is the implemented security mode. security_mode est de type int, avec 1 comme valeur par défaut.security_mode is int, with a default of 1. 0 spécifie SQL ServerSQL Server l’authentification.0 specifies SQL ServerSQL Server Authentication. 1 spécifie l’authentification Windows.1 specifies Windows Authentication.

Notes

Ce paramètre est déconseillé et n'est maintenu que dans un but de compatibilité ascendante avec les scripts déjà établis.This parameter has been deprecated and is maintained for backward compatibility of scripts. La propriété est maintenant spécifiée sur une base par abonnement lors de l’exécution de sp_addsubscription.The property is now specified on a per-subscription basis when executing 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.When a value is specified, it will be used as a default when creating subscriptions at this Subscriber and a warning message will be returned.

[ @encrypted_password = ] encrypted_passwordCe paramètre est déconseillé et fourni à des fins de compatibilité descendante uniquement si la valeur de encrypted_password est définie sur n’importe quelle valeur, mais 0 génère une erreur.[ @encrypted_password = ] encrypted_password This parameter has been deprecated and is provided for backward-compatibility only Setting encrypted_password to any value but 0 will result in an error.

[ @publisher = ] 'publisher'Spécifie un serveur SQL ServerSQL Server de publication non-.[ @publisher = ] 'publisher' Specifies a non- SQL ServerSQL Server Publisher. Publisher est de type sysname, avec NULL comme valeur par défaut.publisher is sysname, with a default of NULL.

Notes

l' éditeur ne doit pas être utilisé lors de SQL ServerSQL Server la publication à partir d’un serveur de publication.publisher should not be used when publishing from a SQL ServerSQL Server Publisher.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_addsubscriber est utilisé dans la réplication d’instantané, la réplication transactionnelle et la réplication de fusion.sp_addsubscriber is used in snapshot replication, transactional replication, and merge replication.

la valeur sp_addsubscriber n’est pas requise lorsque l’abonné dispose uniquement d’abonnements anonymes aux publications de fusion.sp_addsubscriber is not required when the Subscriber will only have anonymous subscriptions to merge publications.

sp_addsubscriber écrit dans la table MSsubscriber_info de la base de données de distribution .sp_addsubscriber writes to the MSsubscriber_info table in the distribution database.

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin peuvent exécuter sp_addsubscriber.Only members of the sysadmin fixed server role can execute sp_addsubscriber.

Voir aussiSee Also

Create a Push Subscription Create a Push Subscription
Créer un abonnement par extraction de données Create a Pull Subscription
sp_changesubscriber (Transact-SQL) sp_changesubscriber (Transact-SQL)
sp_dropsubscriber (Transact-SQL) sp_dropsubscriber (Transact-SQL)
sp_helpsubscriberinfo (Transact-SQL)sp_helpsubscriberinfo (Transact-SQL)