sp_changemergefilter (Transact-SQL)

Artículo
03/07/2014

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 temas Convenciones 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.
	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.