sp_addsubscriber (Transact-SQL)

Article
02/01/2024

S’applique à : SQL Server Azure SQL Database

Ajoute un nouvel Abonné à un serveur de publication, lui permettant ainsi de recevoir des 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.

Important

Cette procédure stockée est désormais déconseillée. Vous n’êtes plus obligé d’inscrire explicitement un Abonné sur le serveur de publication.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_addsubscriber
    [ @subscriber = ] N'subscriber'
    [ , [ @type = ] type ]
    [ , [ @login = ] N'login' ]
    [ , [ @password = ] N'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 = ] N'description' ]
    [ , [ @security_mode = ] security_mode ]
    [ , [ @encrypted_password = ] encrypted_password ]
    [ , [ @publisher = ] N'publisher' ]
[ ; ]

Arguments

[ @subscriber = ] N’subscriber'

Nom du serveur à ajouter en tant qu’Abonné valide aux publications sur ce serveur. @subscriber est sysname, sans valeur par défaut.

[ @type = ] type

Type d’Abonné. @type est tinyint et peut être l’une de ces valeurs.

Valeur	Description
`0` (valeur par défaut)	Abonné SQL Server
`1`	Serveur de la source de données ODBC.
`2`	Base de données Microsoft Jet
`3`	Fournisseur OLE DB

[ @login = ] N’login'

ID de connexion pour l’authentification SQL Server. @login est sysname, avec la valeur par défaut NULL.

Remarque

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts. La propriété est maintenant spécifiée par abonnement lors de l’exécution de sp_addsubscription. Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @password = ] N’password'

Mot de passe pour l’authentification SQL Server. @password est nvarchar(524), avec la valeur par défaut NULL.

N’utilisez pas de mot de passe vide. Utilisez un mot de passe fort.

Remarque

[ @commit_batch_size = ] commit_batch_size

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts.

Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @status_batch_size = ] status_batch_size

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts.

Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @flush_frequency = ] flush_frequency

Ce paramètre est déconseillé et est maintenu pour la compatibilité descendante des scripts.

Lorsqu’une valeur est spécifiée, elle est utilisée comme valeur par défaut lors de la création d’abonnements sur cet Abonné et un message d’avertissement est retourné.

[ @frequency_type = ] frequency_type

Spécifie la fréquence avec laquelle planifier l’agent de réplication. @frequency_type est int et peut être l’une de ces valeurs.

Valeur	Description
`1`	Ponctuelle
`2`	À la demande
`4`	Quotidiennement
`8`	Hebdomadaire
`16`	Mensuelle
`32`	Mensuelle relative
`64` (valeur par défaut)	Démarrage automatique
`128`	Récurrent

Remarque

[ @frequency_interval = ] frequency_interval

Valeur appliquée à la fréquence définie par @frequency_type. @frequency_interval est int, avec la valeur par défaut 1.

Remarque

[ @frequency_relative_interval = ] frequency_relative_interval

Date de l’agent de réplication. Ce paramètre est utilisé lorsque @frequency_type est défini 32 sur (relatif mensuel). @frequency_relative_interval est int et peut être l’une de ces valeurs.

Valeur	Description
`1` (valeur par défaut)	First
`2`	Second
`4`	Third
`8`	Quatrième
`16`	Dernière

Remarque

[ @frequency_recurrence_factor = ] frequency_recurrence_factor

Facteur de périodicité utilisé par @frequency_type. @frequency_recurrence_factor est int, avec la valeur par défaut 0.

Remarque

[ @frequency_subday = ] frequency_subday

Fréquence à replanifier pendant la période définie. @frequency_subday est int et peut être l’une de ces valeurs.

Valeur	Description
`1`	Une fois
`2`	Second
`4` (valeur par défaut)	Minute
`8`	Heure

Remarque

[ @frequency_subday_interval = ] frequency_subday_interval

Intervalle de frequency_subday. @frequency_subday_interval est int, avec la valeur par défaut 5.

Remarque

[ @active_start_time_of_day = ] active_start_time_of_day

Heure du jour où l’agent de réplication est planifié pour la première fois, mis en forme comme HHmmss. @active_start_time_of_day est int, avec la valeur par défaut 0.

Remarque

[ @active_end_time_of_day = ] active_end_time_of_day

Heure du jour où l’agent de réplication cesse d’être planifié, mis en forme comme HHmmss. @active_end_time_of_day est int, avec une valeur par défaut , 235959ce qui signifie 11:59:59 P.M. comme mesuré sur une horloge de 24 heures.

Remarque

[ @active_start_date = ] active_start_date

Date à laquelle l’agent de réplication est planifié pour la première fois, mis en forme en tant que yyyyMMdd. @active_start_date est int, avec une valeur par défaut de 0.

Remarque

[ @active_end_date = ] active_end_date

Date à laquelle l’agent de réplication cesse d’être planifié, mis en forme en tant que yyyyMMdd. @active_end_date est int, avec une valeur par défaut 99991231, ce qui signifie le 31 décembre 9999.

Remarque

[ @description = ] N’description'

Description textuelle de l’Abonné. @description est nvarchar(255), avec la valeur par défaut NULL.

[ @security_mode = ] security_mode

Mode de sécurité implémenté. @security_mode est int, avec la valeur par défaut 1.

0 spécifie l’authentification SQL Server.
1spécifie Authentification Windows.

Remarque

[ @encrypted_password = ] encrypted_password

Ce paramètre est déconseillé et est fourni uniquement pour la compatibilité descendante. Définir @encrypted_password sur n’importe quelle valeur, mais 0 entraîne une erreur.

[ @publisher = ] N’publisher'

Spécifie un serveur de publication non-SQL Server. @publisher est sysname, avec la valeur par défaut NULL.

@publisher ne doit pas être utilisé lors de la publication à partir d’un serveur de publication SQL Server.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Notes

sp_addsubscriber est utilisé dans la réplication d’instantanés, la réplication transactionnelle et la réplication de fusion.

sp_addsubscriber n’est pas obligatoire lorsque l’Abonné dispose uniquement d’abonnements anonymes pour fusionner des publications.

sp_addsubscriber écrit dans la table MSsubscriber_info dans la base de données de distribution .

autorisations

Seuls les membres du rôle serveur fixe sysadmin peuvent s’exécuter.sp_addsubscriber

Partager via

sp_addsubscriber (Transact-SQL)

Syntaxe

Arguments

[ @subscriber = ] N’subscriber'

[ @type = ] type

[ @login = ] N’login'

[ @password = ] N’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 = ] N’description'

[ @security_mode = ] security_mode

[ @encrypted_password = ] encrypted_password

[ @publisher = ] N’publisher'

Valeurs des codes de retour

Notes

autorisations

Commentaires

Ressources supplémentaires

Partager via

sp_addsubscriber (Transact-SQL)

Syntaxe

Arguments

[ @subscriber = ] N’subscriber'

[ @type = ] type

[ @login = ] N’login'

[ @password = ] N’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 = ] N’description'

[ @security_mode = ] security_mode

[ @encrypted_password = ] encrypted_password

[ @publisher = ] N’publisher'

Valeurs des codes de retour

Notes

autorisations

Contenu connexe

Commentaires

Ressources supplémentaires