Artigo
04/01/2012

sp_changemergefilter (Transact-SQL)

Altera algumas propriedades do filtro de mesclagem. Esse procedimento armazenado é executado no Publicador, no banco de dados de publicação.

Ícone de vínculo de tópico Convenções de sintaxe Transact-SQL

Sintaxe

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

Argumentos

[ @publication= ] 'publication'
É o nome da publicação. publication é sysname, sem padrão.
[ @article= ] 'article'
É o nome do artigo. article é sysname, sem padrão.
[ @filtername= ] 'filtername'
É o nome do filtro atual. filtername é sysname, sem padrão.
[ @property= ] 'property'
É o nome da propriedade a ser alterada. property é sysname, sem padrão.

[ @value=] 'value'
É o novo valor para a propriedade especificada. value é nvarchar (1000), sem padrão.

Essa tabela descreve as propriedades de artigos e os valores para essas propriedades.

Propriedade	Valor	Descrição
filter_type	1	Filtro de junção. Essa opção é requerida para suporte a Assinantes SQL Server Compact 3.5 SP2.
	2	Relação de registro lógico.
	3	Filtro de junção é também uma relação de registro lógico.
filtername		Nome do filtro.
join_articlename		Nome do artigo de junção.
join_filterclause		Cláusula de filtro.
join_unique_key	true	A junção está em uma chave exclusiva
	false	A junção não está em uma chave exclusiva.

[ @force_invalidate_snapshot = ] force_invalidate_snapshot
Reconhece que a ação tomada por esse procedimento armazenado pode invalidar um instantâneo existente. force_invalidate_snapshot é um bit, com um padrão de 0.

0 especifica que as alterações no artigo de mesclagem não invalidam o instantâneo. Se o procedimento armazenado detectar que a alteração requer um novo instantâneo, ocorrerá um erro e nenhuma alteração será feita.

1 significa que as alterações no artigo de mesclagem podem invalidar o instantâneo e se houver assinaturas existentes que exigem um novo instantâneo, dará permissão para que o instantâneo existente seja marcado como obsoleto e um novo instantâneo seja criado.
[ @force_reinit_subscription = ] force_reinit_subscription
Reconhece que a ação tomada por esse procedimento armazenado pode requerer que as assinaturas existentes sejam reiniciadas. force_reinit_subscription é um bit, com um padrão de 0.

0 especifica que alterações no artigo de mesclagem não fazem com que a assinatura seja reiniciada. Se o procedimento armazenado detectar que a alteração irá requerer que as assinaturas existentes sejam reiniciadas, ocorrerá um erro e nenhuma alteração será feita.

1 significa que alterações no artigo de mesclagem causarão a reinicialização de assinaturas existentes e darão permissão para que a reinicialização ocorra.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_changemergefilter é usado em replicação de mesclagem.

A alteração do filtro em um artigo de mesclagem requer que o instantâneo, se existir, seja recriado. Isso é executado definindo @force_invalidate_snapshot como 1. Além disso, se houver assinaturas para este artigo, elas deverão ser reiniciadas. Isso é feito definindo @force_reinit_subscription como 1.

Para usar registros lógicos, a publicação e os artigos devem atender a vários requisitos. Para obter mais informações, consulte Agrupando alterações a linhas relacionadas com registros lógicos.