sp_check_subset_filter (Transact-SQL)

Se utiliza para comprobar una cláusula de filtro en una tabla para determinar si es válida para esa tabla. Este procedimiento almacenado devuelve información sobre el filtro suministrado, incluso si el filtro es apto para su uso con particiones precalculadas. Este procedimiento almacenado se ejecuta en el publicador de la base de datos que contiene la publicación.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_check_subset_filter [ @filtered_table = ] 'filtered_table' 
        , [ @subset_filterclause = ] 'subset_filterclause'
    [ , [ @has_dynamic_filters = ] has_dynamic_filters OUTPUT ]

Argumentos

• [ @filtered_table= ] 'filtered_table'
  Es el nombre de una tabla filtrada. filtered_table es de tipo nvarchar(400) y no tiene ningún valor predeterminado.

• [ @subset_filterclause = ] 'subset_filterclause'
  Es la cláusula de filtro que se comprueba. subset_filterclause es de tipo nvarchar(1000) y no tiene ningún valor predeterminado.

• [ @has_dynamic_filters= ] has_dynamic_filters
  Especifica si la cláusula de filtro es un filtro de fila con parámetros. has_dynamic_filters es de tipo bit, su valor predeterminado es NULL y es un parámetro OUTPUT. Devuelve el valor 1 cuando la cláusula de filtro es un filtro de fila con parámetros.

Conjuntos de resultados

Nombre de columna	Tipo de datos	Descripción
can_use_partition_groups	bit	Especifica si la publicación es apta para el uso de particiones precalculadas, donde 1 significa que se pueden utilizar particiones precalculadas y 0 lo contrario.
has_dynamic_filters	bit	Especifica si la cláusula de filtro suministrada incluye al menos un filtro de fila con parámetros; 1 significa que se utiliza un filtro de fila con parámetros y 0 significa que esa función no se utiliza.
dynamic_filters_function_list	nvarchar(500)	Lista de las funciones de la cláusula de filtro que filtran un artículo dinámicamente; las funciones están separadas por puntos y comas.
uses_host_name	bit	Especifica si se utiliza la función HOST_NAME() en la cláusula de filtro; 1 significa que esta función está presente.
uses_suser_sname	bit	Especifica si se utiliza la función SUSER_SNAME() en la cláusula de filtro; 1 significa que esta función está presente.

Valores de código de retorno

0 (correcto) o 1 (error)

Comentarios

sp_check_subset_filter se utiliza en la replicación de mezcla.

sp_check_subset_filter se puede ejecutar en cualquier tabla, aunque ésta no se haya publicado. Este procedimiento almacenado se puede utilizar para comprobar una cláusula de filtro antes de definir un artículo filtrado.

Permisos

Solo los miembros del rol fijo de servidor sysadmin o del rol fijo de base de datos db_owner pueden ejecutar sp_check_subset_filter.

Vea también

Conceptos

Optimizar el rendimiento de los filtros con parámetros con particiones calculadas previamente