Partager via

  • Article

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.

Icône Lien de rubriqueConventions 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é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 serveur fixe sysadmin peuvent exécuter sp_addsubscriber.