Compartilhar via


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 da 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 atual do filtro. filtername é sysname, sem padrão.

  • [ @property= ] 'property'
    É o nome da propriedade a ser alterada. property é sysname, sem padrão.

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

    Essa tabela descreve as propriedades de artigos e os valores dessas propriedades.

    Propriedade

    Value

    Descrição

    filter_type

    1

    Filtro de junção.

    Essa opção é requerida para suporte a Assinantes SQL Server Compact.

     

    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
    Confirma 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 exige 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
    Confirma que a ação tomada por esse procedimento armazenado pode exigir que as assinaturas existentes sejam reinicializadas. 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 assinaturas existentes para ser reiniciada, 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 Agrupar alterações a linhas relacionadas com registros lógicos.

Permissões

Somente membros da função de servidor fixa sysadmin ou da função de banco de dados fixa db_owner podem executar sp_changemergefilter.

Consulte também

Referência

sp_addmergefilter (Transact-SQL)

sp_dropmergefilter (Transact-SQL)

sp_helpmergefilter (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)

Conceitos

Alterar propriedades da publicação e do artigo