Compartir a través de


sp_changemergefilter (Transact-SQL)

Cambia algunas propiedades del filtro de mezcla. Este procedimiento almacenado se ejecuta en el publicador de la base de datos de publicaciones.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

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'
    Es el nombre de la publicación. publication es de tipo sysname y no tiene ningún valor predeterminado.

  • [ @article=] 'article'
    Es el nombre del artículo. article es de tipo sysname y no tiene ningún valor predeterminado.

  • [ @filtername= ] 'filtername'
    Es el nombre actual del filtro. filtername es de tipo sysname y no tiene ningún valor predeterminado.

  • [ @property= ] 'property'
    Es el nombre de la propiedad que se va a cambiar. property es de tipo sysname y no tiene ningún valor predeterminado.

  • [ @value=] 'value'
    Es el nuevo valor de la propiedad especificada. valuees de tipo nvarchar(1000) y no tiene ningún valor predeterminado.

    En esta tabla se describen las propiedades de los artículos y los valores de esas propiedades.

    Propiedad

    Valor

    Descripción

    filter_type

    1

    Filtro de combinación.

    Esta opción es necesaria para admitir los suscriptores de SQL Server Compact 3.5 SP2.

     

    2

    Relación de registros lógicos.

     

    3

    El filtro de combinación también es una relación de registros lógicos.

    filtername

     

    Nombre del filtro.

    join_articlename

     

    Nombre del artículo de combinación.

    join_filterclause

     

    Cláusula de filtro.

    join_unique_key

    true

    La combinación se hace sobre una clave exclusiva.

     

    false

    La combinación no se hace sobre una clave exclusiva.

  • [ @force_invalidate_snapshot = ] force_invalidate_snapshot
    Confirma que la acción realizada por este procedimiento almacenado puede invalidar una instantánea existente. force_invalidate_snapshot es de tipo bit y su valor predeterminado es 0.

    0 especifica que los cambios en el artículo de mezcla no invalidarán la instantánea. Si el procedimiento almacenado detecta que el cambio requiere una nueva instantánea, se producirá un error y no se realizarán cambios.

    1 especifica que los cambios realizados en el artículo de mezcla pueden invalidar la instantánea y, si hay suscripciones existentes que requieran una nueva instantánea, concede permiso para marcar como obsoleta la instantánea existente y generar una nueva.

  • [ @force_reinit_subscription = ] force_reinit_subscription
    Confirma que la acción realizada por este procedimiento almacenado puede requerir la reinicialización de las suscripciones existentes. force_reinit_subscription es de tipo bit y su valor predeterminado es 0.

    0 especifica que los cambios en el artículo de mezcla no harán que se reinicialice la suscripción. Si el procedimiento almacenado detecta que el cambio requiere la reinicialización de las suscripciones existentes, se producirá un error y no se realizarán cambios.

    1 especifica que los cambios realizados en el artículo de mezcla harán que se reinicialicen las suscripciones existentes y concede permiso para que se lleve a cabo la reinicialización.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_changemergefilter se utiliza en la replicación de mezcla.

Para cambiar el filtro de un artículo de mezcla es preciso recrear la instantánea, si ya existe. Para ello, se define @force_invalidate_snapshot como 1. Asimismo, si hay suscripciones para este artículo, es necesario reinicializarlas. Para ello, se define @force_reinit_subscription como 1.

Para utilizar registros lógicos, la publicación y los artículos deben satisfacer una serie de requisitos. Para obtener más información, vea Agrupar cambios en filas relacionadas con registros lógicos.

Permisos

Sólo los miembros de la función fija de servidor sysadmin o de la función fija de base de datos db_owner pueden ejecutar sp_changemergefilter.