sp_reinitmergepullsubscription (Transact-SQL)sp_reinitmergepullsubscription (Transact-SQL)

S’APPLIQUE À : ouiSQL Server nonAzure SQL Database nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Signale un abonnement de fusion extrait en vue de sa réinitialisation lors de la prochaine exécution de l'Agent de fusion.Marks a merge pull subscription for reinitialization the next time the Merge Agent runs. Cette procédure stockée est exécutée dans la base de données d'abonnement de l'abonné.This stored procedure is executed at the Subscriber in the subscription database.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

  
sp_reinitmergepullsubscription [ [ @publisher = ] 'publisher' ]  
    [ , [ @publisher_db = ] 'publisher_db' ]  
    [ , [ @publication = ] 'publication' ]  
    [ , [ @upload_first = ] 'upload_first'  

ArgumentsArguments

[ @publisher = ] 'publisher' Est le nom du serveur de publication.[ @publisher = ] 'publisher' Is the name of the Publisher. serveur de publication est sysname, avec une valeur par défaut de tous.publisher is sysname, with a default of ALL.

[ @publisher_db = ] 'publisher_db' Est le nom de la base de données du serveur de publication.[ @publisher_db = ] 'publisher_db' Is the name of the Publisher database. publisher_db est sysname, avec une valeur par défaut de tous.publisher_db is sysname, with a default of ALL.

[ @publication = ] 'publication' Est le nom de la publication.[ @publication = ] 'publication' Is the name of the publication. publication est sysname, avec une valeur par défaut de tous.publication is sysname, with a default of ALL.

[ @upload_first = ] 'upload_first' Est que les modifications sur l’abonné sont téléchargées avant la réinitialisation de l’abonnement.[ @upload_first = ] 'upload_first' Is whether changes at the Subscriber are uploaded before the subscription is reinitialized. upload_first est nvarchar (5) , avec FALSE comme valeur par défaut.upload_first is nvarchar(5), with a default of FALSE. Si true, les modifications sont téléchargées avant la réinitialisation de l’abonnement.If true, changes are uploaded before the subscription is reinitialized. Si false, modifications ne sont pas téléchargées.If false, changes are not uploaded.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_reinitmergepullsubscription est utilisé dans la réplication de fusion.sp_reinitmergepullsubscription is used in merge replication.

Si vous ajoutez, supprimez ou modifiez un filtre paramétré, les modifications en attente chez l'abonné ne peuvent pas être chargées sur le serveur de publication pendant la réinitialisation.If you add, drop, or change a parameterized filter, pending changes at the Subscriber cannot be uploaded to the Publisher during reinitialization. Si vous voulez télécharger les modifications en attente, synchronisez tous les abonnements avant de modifier le filtre.If you want to upload pending changes, synchronize all subscriptions before changing the filter.

ExempleExample

-- 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 @publicationDB AS sysname;
DECLARE @publication AS sysname;
SET @publicationDB = N'AdventureWorks2012';
SET @publication = N'AdvWorksSalesOrdersMerge';

USE [AdventureWorks2012Replica]

-- Execute at the Subscriber to reinitialize the pull subscription. 
-- Pending changes at the Subscrber are lost.
EXEC sp_reinitmergepullsubscription 
    @publisher = $(PubServer),
    @publisher_db = @publicationDB,
    @publication = @publication,
    @upload_first = N'false';
GO

-- Start the Merge Agent.

ExempleExample

-- 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 @publicationDB AS sysname;
DECLARE @publication AS sysname;
SET @publicationDB = N'AdventureWorks2012';
SET @publication = N'AdvWorksSalesOrdersMerge';

USE [AdventureWorks2012Replica]

-- Execute at the Subscriber to reinitialize the pull subscription, 
-- and upload pending changes at the Subscriber. 
EXEC sp_reinitmergepullsubscription 
    @publisher = $(PubServer),
    @publisher_db = @publicationDB,
    @publication = @publication,
    @upload_first = N'true';
GO

-- Start the Merge Agent.

AutorisationsPermissions

Seuls les membres de la sysadmin rôle serveur fixe ou le db_owner rôle de base de données fixe peuvent exécuter sp_reinitmergepullsubscription.Only members of the sysadmin fixed server role or the db_owner fixed database role can execute sp_reinitmergepullsubscription.

Voir aussiSee Also

Réinitialiser un abonnement Reinitialize a Subscription
Réinitialiser des abonnements Reinitialize Subscriptions
Procédures stockées système (Transact-SQL)System Stored Procedures (Transact-SQL)