sp_check_subset_filter (Transact-SQL)

É usado para verificar uma cláusula de filtro em qualquer tabela para determinar se a cláusula é válida para a tabela. Esse procedimento armazenado retorna informações sobre o filtro fornecido, inclusive se o filtro está qualificado para uso com partições pré-computadas. Esse procedimento armazenado é executado no Publicador, no banco de dados que contém a publicação.

Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

• [ @filtered_table= ] 'filtered_table'
  É o nome de uma tabela filtrada. filtered_table é nvarchar(400), sem padrão.

• [ @subset_filterclause = ] 'subset_filterclause'
  É a cláusula de filtro que está sendo testada. subset_filterclause é nvarchar(1000), sem padrão.

• [ @has_dynamic_filters= ] has_dynamic_filters
  Especifica se a cláusula de filtro é um filtro de linha com parâmetros. has_dynamic_filters é bit, com um padrão de NULL, e é um parâmetro de saída. Retorna um valor 1 quando a cláusula de filtro for um filtro de linha com parâmetros.

Conjuntos de resultados

Nome da coluna	Tipo de dados	Descrição
can_use_partition_groups	bit	Se a publicação se qualifica para usar partições pré-computadas; onde 1 significa que partições pré-computadas podem ser usadas e 0 significa que não podem ser usadas.
has_dynamic_filters	bit	Se a cláusula de filtro fornecida incluir pelo menos um filtro de linha com parâmetros, onde 1 significa que um filtro de linha com parâmetros é usado e 0 significa que tal função não é usada.
dynamic_filters_function_list	nvarchar(500)	Lista de funções na cláusula de filtro que filtra dinamicamente um artigo, onde cada função é separada por um ponto e vírgula.
uses_host_name	bit	Se a função HOST_NAME () for usada na cláusula de filtro, onde 1 significa que essa função está presente.
uses_suser_sname	bit	Se a função SUSER_SNAME() for usada na cláusula de filtro, onde 1 significa que essa função está presente.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Comentários

sp_check_subset_filter é usado em replicação de mesclagem.

sp_check_subset_filter pode ser executado em qualquer tabela, mesmo se a tabela não for publicada. Esse procedimento armazenado pode ser usado para verificar uma cláusula de filtro antes de definir um artigo filtrado.

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_check_subset_filter.

Consulte também

Conceitos

Otimizar o desempenho de filtro parametrizado com partições pré-computadas