Share via


sp_check_subset_filter (Transact-SQL)

Se aplica a:SQL ServerAzure SQL Managed Instance

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 nvarchar(400), sin ningún valor predeterminado.

[ @subset_filterclause = ] 'subset_filterclause' Es la cláusula filter que se está probando. subset_filterclause es nvarchar(1000), sin ningún valor predeterminado.

[ @has_dynamic_filters = ] has_dynamic_filters Es si la cláusula filter es un filtro de fila con parámetros. has_dynamic_filters es bit, con un valor predeterminado de NULL y es un parámetro de salida. Devuelve un valor de 1 cuando la cláusula filter es un filtro de fila con parámetros.

Conjuntos de resultados

Nombre de la columna Tipo de datos Descripción
can_use_partition_groups bit Es si la publicación califica para usar particiones precalpiadas; donde 1 significa que se pueden usar particiones precalutadas y 0 significa que no se pueden usar.
has_dynamic_filters bit Es si la cláusula de filtro proporcionada incluye al menos un filtro de fila con parámetros; donde 1 significa que se usa un filtro de fila con parámetros y 0 significa que no se usa dicha función.
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 Si la función HOST_NAME() se usa en la cláusula filter, donde 1 significa que esta función está presente.
uses_suser_sname bit Si la función SUSER_SNAME() se usa en la cláusula filter, donde 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 usa en la replicación de mezcla.

sp_check_subset_filter se puede ejecutar en cualquier tabla incluso si la tabla no está publicada. 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 db_owner rol fijo de base de datos pueden ejecutar sp_check_subset_filter.

Consulte también

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