sp_changemergefilter (Transact-SQL)sp_changemergefilter (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

Modifie certaines propriétés du filtre de fusion.Changes some merge filter properties. Cette procédure stockée est exécutée sur le serveur de publication dans la base de données de publication.This stored procedure is executed at the Publisher on the publication database.

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

SyntaxeSyntax

  
sp_changemergefilter [ @publication= ] 'publication'  
        , [ @article= ] 'article'  
        , [ @filtername= ] 'filtername'  
        , [ @property= ] 'property'  
        , [ @value= ] 'value'  
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]  
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]  

ArgumentsArguments

[ @publication = ] 'publication' Est le nom de la publication.[ @publication = ] 'publication' Is the name of the publication. publication est sysname, sans valeur par défaut.publication is sysname, with no default.

[ @article = ] 'article' Est le nom de l’article.[ @article = ] 'article' Is the name of the article. article est sysname, sans valeur par défaut.article is sysname, with no default.

[ @filtername = ] 'filtername' Est le nom actuel du filtre.[ @filtername = ] 'filtername' Is the current name of the filter. FilterName est sysname, sans valeur par défaut.filtername is sysname, with no default.

[ @property = ] 'property' Est le nom de la propriété à modifier.[ @property = ] 'property' Is the name of the property to change. propriété est sysname, sans valeur par défaut.property is sysname, with no default.

[ @value = ] 'value' Est la nouvelle valeur pour la propriété spécifiée.[ @value = ] 'value' Is the new value for the specified property. valeurest nvarchar (1000) , sans valeur par défaut.valueis nvarchar(1000), with no default.

Le tableau ci-dessous décrit les propriétés des articles et les valeurs de ces propriétés.This table describes the properties of articles and the values for those properties.

PropriétéProperty ValueValue DescriptionDescription
filter_typefilter_type 11 Filtre de jointure.Join filter.

Cette option est nécessaire pour la prise en charge d'Abonnés SQL Server CompactSQL Server Compact.This option is required to support SQL Server CompactSQL Server Compact Subscribers.
22 Relation d'enregistrement logique.Logical record relationship.
33 Un filtre de jointure est également une relation d'enregistrement logique.Join filter is also a logical record relationship.
filternamefiltername Nom du filtre.Name of the filter.
join_articlenamejoin_articlename Nom de l'article de jointure.Name of the join article.
join_filterclausejoin_filterclause Clause Filtre.Filter clause.
join_unique_keyjoin_unique_key truetrue La jointure se fait sur une clé unique.Join is on a unique key
falsefalse La jointure ne se fait pas sur une clé unique.Join is not on a unique key.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot Confirme que l’action entreprise par cette procédure stockée peut invalider un instantané existant.[ @force_invalidate_snapshot = ] force_invalidate_snapshot Acknowledges that the action taken by this stored procedure may invalidate an existing snapshot. àce_invalidate_snapshot est un bits, avec une valeur par défaut 0.force_invalidate_snapshot is a bit, with a default 0.

0 Spécifie que les modifications apportées à l’article de fusion n’invalident pas l’instantané n’est pas valide.0 specifies that changes to the merge article do not cause the snapshot to be invalid. Si la procédure stockée détecte que la modification requiert un nouvel instantané, une erreur se produit et aucune modification n'est effectuée.If the stored procedure detects that the change does require a new snapshot, an error occurs and no changes are made.

1 signifie que les modifications apportées à l’article de fusion peuvent invalider l’instantané n’est pas valide, et s’il existe des abonnements existants qui nécessitent un nouvel instantané, autorise l’instantané existant soit marqué comme obsolète et de générer un nouvel instantané.1 means that changes to the merge article may cause the snapshot to be invalid, and if there are existing subscriptions that would require a new snapshot, gives permission for the existing snapshot to be marked as obsolete and a new snapshot generated.

[ @force_reinit_subscription = ] force_reinit_subscription Confirme que l’action entreprise par cette procédure stockée peut nécessiter la réinitialisation des abonnements existants.[ @force_reinit_subscription = ] force_reinit_subscription Acknowledges that the action taken by this stored procedure may require existing subscriptions to be reinitialized. àce_reinit_subscription est un bits avec une valeur par défaut 0.force_reinit_subscription is a bit with a default of 0.

0 Spécifie que les modifications apportées à l’article de fusion ne provoquent pas la réinitialisation de l’abonnement.0 specifies that changes to the merge article do not cause the subscription to be reinitialized. Si la procédure stockée détecte que la modification nécessite la réinitialisation des abonnements existants, une erreur se produit et aucune modification n'est effectuée.If the stored procedure detects that the change would require existing subscriptions to be reinitialized, an error occurs and no changes are made.

1 signifie que les modifications à l’article de fusion entraîne la réinitialisation des abonnements existants et autorise la réinitialisation des abonnements se produise.1 means that changes to the merge article will cause existing subscriptions to be reinitialized, and gives permission for the subscription reinitialization to occur.

Valeurs des codes de retourReturn Code Values

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

NotesRemarks

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

La modification d'un filtre sur un article de fusion nécessite de recréer l'instantané, s'il existe.Changing the filter on a merge article requires the snapshot, if one exists, to be recreated. Cette opération est effectuée en définissant le **@force_invalidate_snapshot** à 1.This is performed by setting the **@force_invalidate_snapshot** to 1. De même, s'il existe des abonnements à cet article, les abonnements doivent être réinitialisés.Also, if there are subscriptions to this article, the subscriptions need to be reinitialized. Cela est effectué en définissant le **@force_reinit_subscription** à 1.This is done by setting the **@force_reinit_subscription** to 1.

Pour utiliser des enregistrements logiques, la publication et les articles doivent répondre à certaines conditions.To use logical records, the publication and articles must meet a number of requirements. Pour plus d’informations, consultez Regrouper les modifications apportées à des lignes connexes à l’aide d’enregistrements logiques.For more information, see Group Changes to Related Rows with Logical Records.

AutorisationsPermissions

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

Voir aussiSee Also

Changer les propriétés des publications et des articles Change Publication and Article Properties
sp_addmergefilter (Transact-SQL) sp_addmergefilter (Transact-SQL)
sp_dropmergefilter (Transact-SQL) sp_dropmergefilter (Transact-SQL)
sp_helpmergefilter (Transact-SQL) sp_helpmergefilter (Transact-SQL)
Procédures stockées système (Transact-SQL)System Stored Procedures (Transact-SQL)