sp_addsubscription (Transact-SQL)

S’applique à :SQL ServerAzure SQL Database

Ajoute un abonnement à une publication et définit l'état de l'abonné. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.

Conventions de la syntaxe Transact-SQL

Syntaxe

sp_addsubscription
    [ @publication = ] N'publication'
    [ , [ @article = ] N'article' ]
    [ , [ @subscriber = ] N'subscriber' ]
    [ , [ @destination_db = ] N'destination_db' ]
    [ , [ @sync_type = ] N'sync_type' ]
    [ , [ @status = ] N'status' ]
    [ , [ @subscription_type = ] N'subscription_type' ]
    [ , [ @update_mode = ] N'update_mode' ]
    [ , [ @loopback_detection = ] N'loopback_detection' ]
    [ , [ @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 ]
    [ , [ @optional_command_line = ] N'optional_command_line' ]
    [ , [ @reserved = ] N'reserved' ]
    [ , [ @enabled_for_syncmgr = ] N'enabled_for_syncmgr' ]
    [ , [ @offloadagent = ] offloadagent ]
    [ , [ @offloadserver = ] N'offloadserver' ]
    [ , [ @dts_package_name = ] N'dts_package_name' ]
    [ , [ @dts_package_password = ] N'dts_package_password' ]
    [ , [ @dts_package_location = ] N'dts_package_location' ]
    [ , [ @distribution_job_name = ] N'distribution_job_name' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @backupdevicetype = ] N'backupdevicetype' ]
    [ , [ @backupdevicename = ] N'backupdevicename' ]
    [ , [ @mediapassword = ] N'mediapassword' ]
    [ , [ @password = ] N'password' ]
    [ , [ @fileidhint = ] fileidhint ]
    [ , [ @unload = ] unload ]
    [ , [ @subscriptionlsn = ] subscriptionlsn ]
    [ , [ @subscriptionstreams = ] subscriptionstreams ]
    [ , [ @subscriber_type = ] subscriber_type ]
    [ , [ @memory_optimized = ] memory_optimized ]
[ ; ]

Arguments

[ @publication = ] N’publication'

Nom de la publication. @publication est sysname, sans valeur par défaut.

[ @article = ] N’article'

Article auquel la publication est abonnée. @article est sysname, avec la valeur par défaut all. Si all, un abonnement est ajouté à tous les articles de cette composition. Seules les valeurs des serveurs de publication Oracle sont prises en charge ou NULL sont prises en charge pour les serveurs de all publication Oracle.

[ @subscriber = ] N’subscriber'

Nom de l'Abonné. @subscriber est sysname, avec la valeur par défaut NULL.

[ @destination_db = ] N’destination_db'

Nom de la base de données de destination dans laquelle placer des données répliquées. @destination_db est sysname, avec la valeur par défaut NULL. Quand NULL, @destination_db est défini sur le nom de la base de données de publication. Pour les serveurs de publication Oracle, @destination_db doit être spécifié. Pour un abonné non-SQL Server, spécifiez une valeur de (destination par défaut) pour @destination_db.

[ @sync_type = ] N’sync_type'

Type de synchronisation d’abonnement. @sync_type est nvarchar(255) et peut être l’une des valeurs suivantes :

¹ Cette option a été déconseillée. Utilisez plutôt la prise en charge de la réplication uniquement.

² Non pris en charge pour les abonnements aux publications non-SQL Server.

[ @status = ] N’status'

État de l’abonnement. @status est sysname, avec la valeur par défaut NULL. Lorsque ce paramètre n’est pas défini explicitement, la réplication la définit automatiquement sur l’une de ces valeurs.

[ @subscription_type = ] N’subscription_type'

Type d’abonnement. @subscription_type est nvarchar(4), avec la valeur par défaut push. Peut être push ou pull. Les Agent de distribution des abonnements push résident sur le serveur de distribution et les Agent de distribution des abonnements par extraction résident sur l’Abonné. @subscription_type pouvez pull créer un abonnement pull nommé connu du serveur de publication. Pour plus d’informations, consultez S’abonner à des publications.

[ @update_mode = ] N’update_mode'

Le type de mise à jour. @update_mode est nvarchar(30) et peut être l’une de ces valeurs.

Les valeurs sync tran et queued tran ne sont pas autorisées si la publication en cours d’abonnement autorise DTS.

[ @loopback_detection = ] N’loopback_detection'

Indique si l'Agent de distribution envoie des transactions à un abonné qui en est l'auteur. @loopback_detection est nvarchar(5) et peut être l’une de ces valeurs.

[ @frequency_type = ] frequency_type

Fréquence à laquelle planifier la tâche de distribution. @frequency_type est int et peut être l’une de ces valeurs.

[ @frequency_interval = ] frequency_interval

Valeur à appliquer à la fréquence définie par @frequency_type. @frequency_interval est int, avec la valeur par défaut NULL.

[ @frequency_relative_interval = ] frequency_relative_interval

Date du Agent de distribution. 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.

[ @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 NULL.

[ @frequency_subday = ] frequency_subday

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

[ @frequency_subday_interval = ] frequency_subday_interval

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

[ @active_start_time_of_day = ] active_start_time_of_day

Heure du jour où la Agent de distribution est planifiée pour la première fois, mise en forme comme HHmmss. @active_start_time_of_day est int, avec la valeur par défaut NULL.

[ @active_end_time_of_day = ] active_end_time_of_day

Heure du jour où le Agent de distribution cesse d’être planifié, mis en forme comme HHmmss. @active_end_time_of_day est int, avec la valeur par défaut NULL.

[ @active_start_date = ] active_start_date

Date à laquelle le Agent de distribution 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 NULL.

[ @active_end_date = ] active_end_date

Date à laquelle la Agent de distribution cesse d’être planifiée, mise en forme comme yyyyMMddsuit : @active_end_date est int, avec une valeur par défaut de NULL.

[ @optional_command_line = ] N’optional_command_line'

Invite de commandes facultative à exécuter. @optional_command_line est nvarchar(4000), avec la valeur par défaut NULL.

[ @reserved = ] N’reserved'

Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.

[ @enabled_for_syncmgr = ] N’enabled_for_syncmgr'

Indique si l’abonnement peut être synchronisé via le Gestionnaire de synchronisation Windows. @enabled_for_syncmgr est nvarchar(5), avec une valeur par défaut NULL, qui est identique à false. Si false, l’abonnement n’est pas inscrit auprès du Gestionnaire de synchronisation Windows. Si true, l’abonnement est inscrit auprès du Gestionnaire de synchronisation Windows et peut être synchronisé sans démarrer SQL Server Management Studio. Non pris en charge pour les serveurs de publication Oracle.

[ @offloadagent = ] déchargement

Indique si l'Agent peut être activé à distance. @offloadagent est bit, avec la valeur par défaut 0.

[ @offloadserver = ] N’offloadserver'

Indique le nom réseau du serveur à utiliser pour l'activation à distance. @offloadserver est sysname, avec la valeur par défaut NULL.

[ @dts_package_name = ] N’dts_package_name'

Spécifie le nom du package DTS (Data Transformation Services). @dts_package_name est sysname, avec la valeur par défaut NULL. Par exemple, pour spécifier un package nommé DTSPub_Package, le paramètre est le suivant : @dts_package_name = N'DTSPub_Package'. Ce paramètre est disponible avec les abonnements envoyés. Pour ajouter des informations de package DTS à un abonnement par extraction, utilisez sp_addpullsubscription_agent.

[ @dts_package_password = ] N’dts_package_password'

Spécifie le mot de passe sur le package, s’il en existe un. @dts_package_password est sysname, avec la valeur par défaut NULL.

[ @dts_package_location = ] N’dts_package_location'

Spécifie l'emplacement du package. @dts_package_location est nvarchar(12), avec une valeur par défaut NULL, qui est identique à distributor. L’emplacement du package peut être distributor ou subscriber.

[ @distribution_job_name = ] N’distribution_job_name'

Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.

[ @publisher = ] N’publisher'

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

[ @backupdevicetype = ] N’backupdevicetype'

Indique le type d'unité de sauvegarde utilisé lors de l'initialisation d'un Abonné à partir d'une sauvegarde. @backupdevicetype est nvarchar(20) et peut être l’une des valeurs suivantes :

@backupdevicetype est utilisé uniquement lorsque @sync_method est défini sur initialize_with_backup.

[ @backupdevicename = ] N’backupdevicename'

Indique le nom de l'unité utilisée lors de l'initialisation d'un Abonné à partir d'une sauvegarde. @backupdevicename est nvarchar(1000), avec la valeur par défaut NULL.

[ @mediapassword = ] N’mediapassword'

Indique un mot de passe pour le support spécifié, si un mot de passe a été défini lors du formatage du support. @mediapassword est sysname, avec la valeur par défaut NULL.

[ @password = ] N’password'

Indique un mot de passe pour la sauvegarde, si un mot de passe a été défini lors de la création de celle-ci. @password est sysname, avec la valeur par défaut NULL.

[ @fileidhint = ] fileidhint

Identifie une valeur ordinale du jeu de sauvegarde à restaurer. @fileidhint est int, avec la valeur par défaut NULL.

[ @unload = ] décharger

Indique si une unité de sauvegarde sur bande doit être déchargée une fois l'initialisation de la sauvegarde terminée. @unload est bit, avec une valeur par défaut 1, qui spécifie que la bande doit être déchargée. @unload est utilisé uniquement lorsque @backupdevicetype est tape.

[ @subscriptionlsn = ] subscriptionlsn

Spécifie le numéro séquentiel dans le journal auquel un abonnement doit commencer à remettre des modifications à un nœud dans une topologie de réplication transactionnelle d'égal à égal. @subscriptionlsn est binary(10), avec la valeur par défaut NULL. Utilisé avec une valeur @sync_type de initialize from lsn vérifier que toutes les transactions pertinentes sont répliquées vers un nouveau nœud. Pour plus d’informations, consultez Peer-to-Peer - Réplication transactionnelle.

[ @subscriptionstreams = ] subscriptionstreams

Nombre de connexions autorisées par Agent de distribution pour appliquer des lots de modifications en parallèle à un Abonné, tout en conservant la plupart des caractéristiques transactionnelles présentes lors de l’utilisation d’un thread unique. @subscriptionstreams est tinyint, avec une valeur par défaut de NULL. Une plage de valeurs est 164 prise en charge. Ce paramètre n’est pas pris en charge pour les abonnés non-SQL Server, les serveurs de publication Oracle ou les abonnements d’égal à égal. Chaque fois que @subscriptionstreams est utilisé, des lignes supplémentaires sont ajoutées dans la msreplication_subscriptions table (une ligne par flux) avec une agent_id valeur définie NULLsur .

[ @subscriber_type = ] subscriber_type

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

[ @memory_optimized = ] memory_optimized

Indique que l’abonnement prend en charge les tables mémoire optimisées. @memory_optimized est bit, avec la valeur par défaut (0false). 1 (true) signifie que l’abonnement prend en charge les tables mémoire optimisées.

Valeurs des codes de retour

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

Notes

sp_addsubscriptionest utilisé dans instantané réplication et la réplication transactionnelle.

Lorsqu’il sp_addsubscription est exécuté par un membre du rôle serveur fixe sysadmin pour créer un abonnement Push, le travail Agent de distribution est implicitement créé et s’exécute sous le compte de service SQL Server Agent. Nous vous recommandons d’exécuter sp_addpushsubscription_agent et de spécifier les informations d’identification d’un autre compte Windows spécifique à l’agent pour @job_login et @job_password. Pour plus d’informations, voir Replication Agent Security Model.

sp_addsubscription empêche les abonnés ODBC et OLE DB d’accéder aux publications qui :

• Ont été créés avec le @sync_method natif dans l’appel à sp_addpublication.

• Contiennent des articles ajoutés à la publication avec la procédure stockée sp_addarticle dont la valeur de paramètre @pre_creation_cmd est 3 (tronquer).

• Essayez de définir @update_mode sur sync tran.

• ont un article configuré pour utiliser des instructions paramétrables.

En outre, si une publication a l’option @allow_queued_tran définie sur true (ce qui active la mise en file d’attente des modifications sur l’Abonné jusqu’à ce qu’elle puisse être appliquée au serveur de publication), la colonne timestamp d’un article est scriptée comme horodatage et les modifications apportées à cette colonne sont envoyées à l’Abonné. L'abonné génère et met à jour la valeur de la colonne timestamp. Pour un abonné ODBC ou OLE DB, sp_addsubscription échoue si une tentative est effectuée pour s’abonner à une publication qui a @allow_queued_tran définie sur true et des articles avec des colonnes d’horodatage dans celui-ci.

Si un abonnement n’utilise pas de package DTS, il ne peut pas s’abonner à une publication définie sur @allow_transformable_subscriptions. Si la table issue de la publication doit être répliquée vers un abonnement DTS et un abonnement non-DTS, deux publications indépendantes doivent être créées : une pour chaque type d'abonnement.

Lors de la sélection des options replication support onlysync_type , initialize with backupou initialize from lsn, l’agent de lecture du journal doit s’exécuter après l’exécution sp_addsubscription, afin que les scripts de configuration soient écrits dans la base de données de distribution. L'Agent de lecture du journal doit s'exécuter sous un compte membre du rôle serveur fixe sysadmin . Lorsque l’option @sync_type est définie Automaticsur , aucune action spéciale de l’agent de lecture du journal n’est requise.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin ou db_owner rôle de base de données fixe peuvent s’exécuter sp_addsubscription. Pour les abonnements par extraction, les utilisateurs disposant de connexions dans la liste d’accès aux publications peuvent s’exécuter sp_addsubscription.

Exemples

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). For information about how to use scripting variables  
-- on the command line and in SQL Server Management Studio, see the 
-- "Executing Replication Scripts" section in the topic
-- "Programming Replication Using System Stored Procedures".

DECLARE @publication AS sysname;
DECLARE @subscriber AS sysname;
DECLARE @subscriptionDB AS sysname;
SET @publication = N'AdvWorksProductTran';
SET @subscriber = $(SubServer);
SET @subscriptionDB = N'AdventureWorks2022Replica';

--Add a push subscription to a transactional publication.
USE [AdventureWorks2022]
EXEC sp_addsubscription 
  @publication = @publication, 
  @subscriber = @subscriber, 
  @destination_db = @subscriptionDB, 
  @subscription_type = N'push';

--Add an agent job to synchronize the push subscription.
EXEC sp_addpushsubscription_agent 
  @publication = @publication, 
  @subscriber = @subscriber, 
  @subscriber_db = @subscriptionDB, 
  @job_login = $(Login), 
  @job_password = $(Password);
GO

Contenu connexe

• Créer un abonnement par émission (push)
• Créer un abonnement pour un abonné non SQL Server
• S’abonner aux Publications
• sp_addpushsubscription_agent (Transact-SQL)
• sp_changesubstatus (Transact-SQL)
• sp_dropsubscription (Transact-SQL)
• sp_helpsubscription (Transact-SQL)
• Procédures stockées système (Transact-SQL)