sp_addsubscriber (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.

  Notes

  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.

  Notes

  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.

  Notes

  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.

  Notes

  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.

  Notes

  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

  Notes

  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.

  Notes

  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

  Notes

  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.

  Notes

  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

  Notes

  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.

  Notes

  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.

  Notes

  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).

  Notes

  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.

  Notes

  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).

  Notes

  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.

  Notes

  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.

  Notes

  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 serveur fixe sysadmin peuvent exécuter sp_addsubscriber.

Voir aussi

Tâches

Référence