sp_addsubscriber (Transact-SQL)
S’applique à :
SQL ServerAzure 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
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é.
[ @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
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é.
[ @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
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é.
[ @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
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é.
[ @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
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é.
[ @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
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é.
[ @frequency_subday_interval = ] frequency_subday_interval
Intervalle de frequency_subday. @frequency_subday_interval est int, avec la valeur par défaut 5.
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é.
[ @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
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é.
[ @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
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é.
[ @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
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é.
[ @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
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é.
[ @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.
0spécifie l’authentification SQL Server.1spécifie Authentification Windows.
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é.
[ @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