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.

Important :
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)

Aide et Informations

Assistance sur SQL Server 2005