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.

Ícone de vínculo de tópicoConvenções de 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 da tabela filtrada. filtered_table é nvarchar(400), sem padrão.

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

  • [ @has_dynamic_filters= ] has_dynamic_filters
    Se a cláusula do filtro for um filtro de linha com parâmetros. has_dynamic_filters é bit, com um padrão 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 qualificar 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.