Partilhar via

sp_check_subset_filter (Transact-SQL)

  • Artigo

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure

Verifica uma cláusula de filtro em qualquer tabela para determinar se a cláusula de filtro é 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 de sintaxe de Transact-SQL

Sintaxe

sp_check_subset_filter
    [ @filtered_table = ] N'filtered_table'
    , [ @subset_filterclause = ] N'subset_filterclause'
    [ , [ @has_dynamic_filters = ] has_dynamic_filters OUTPUT ]
    [ , [ @dynamic_filters_function_list = ] N'dynamic_filters_function_list' OUTPUT ]
[ ; ]

Argumentos

@filtered_table [ = ] N'filtered_table'

O nome de uma tabela filtrada. @filtered_table é nvarchar(400), sem padrão.

@subset_filterclause [ = ] N'subset_filterclause'

A cláusula de filtro que está sendo testada. @subset_filterclause é nvarchar(1000), sem padrão.

@has_dynamic_filters [ = ] has_dynamic_filters SAÍDA

Especifica se a cláusula de filtro é um filtro de linha com parâmetros. @has_dynamic_filters é um parâmetro OUTPUT do tipo bit. Retorna um valor de quando a cláusula de filtro é um filtro de 1 linha parametrizado.

Conjunto 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; where 1 significa que partições pré-computadas podem ser usadas e 0 significa que elas não podem ser usadas.
has_dynamic_filters bit É se a cláusula de filtro fornecida incluir pelo menos um filtro de linha parametrizado; onde 1 significa que um filtro de linha parametrizado é usado e 0 significa que essa 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.

@dynamic_filters_function_list [ = ] SAÍDA N'dynamic_filters_function_list'

Identificado apenas para fins informativos. Não há suporte. A compatibilidade futura não está garantida.

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Comentários

sp_check_subset_filter é usado na replicação de mesclagem.

sp_check_subset_filter pode ser executado em qualquer tabela, mesmo que a tabela não seja 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 db_owner função de banco de dados fixa podem executar sp_check_subset_filter.

Conteúdo relacionado