Partager via


sp_check_subset_filter (Transact-SQL)

Est utilisée pour vérifier une clause de filtre en fonction d'une table, afin de déterminer si cette clause est valide pour la table. Cette procédure stockée renvoie des informations sur le filtre fourni, y compris si le filtre peut être utilisé avec des partitions précalculées. Cette procédure stockée est exécutée au niveau du serveur de publication dans la base de données contenant la publication.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

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

Arguments

  • [ @filtered_table= ] 'filtered_table'
    Nom d'une table filtrée. filtered_table est de type nvarchar(400), sans valeur par défaut.
  • [ @subset_filterclause = ] 'subset_filterclause'
    Clause de filtre testée. subset_filterclause est de type nvarchar(1000), sans valeur par défaut.
  • [ @has_dynamic_filters= ] has_dynamic_filters
    Indique si la clause de filtre correspond à un filtrage des lignes paramétrable. has_dynamic_filters est de type bit, avec NULL comme valeur par défaut, et est un paramètre de sortie. Renvoie la valeur 1 lorsque la clause de filtre correspond à un filtrage des lignes paramétrable.

Jeux de résultats

Nom de colonne Type de données Description

can_use_partition_groups

bit

Si la publication peut utiliser des partitions précalculées, où la valeur 1 signifie que les partitions précalculées peuvent être utilisées et la valeur 0, qu'elles ne peuvent pas.

has_dynamic_filters

bit

Si la clause de filtre fournie inclut au moins un filtrage des lignes paramétrable, où la valeur 1 signifie qu'un tel filtrage est utilisé et la valeur 0, qu'il n'est pas utilisé.

dynamic_filters_function_list

nvarchar(500)

Listes des fonctions de la clause de filtre qui filtrent dynamiquement un article, où chaque fonction est séparée par un point-virgule.

uses_host_name

bit

Si la fonction HOST_NAME() est utilisée dans la clause de filtre, où la valeur 1 signifie que cette fonction est présente.

uses_suser_sname

bit

Si la fonction SUSER_SNAME() est utilisée dans la clause de filtre, où la valeur 1 signifie que cette fonction est présente.

Notes

sp_check_subset_filter est utilisé dans la réplication de fusion.

sp_check_subset_filter peut être exécuté sur n'importe quelle table, même non publiée. Cette procédure stockée peut être utilisée pour vérifier une clause de filtre avant de définir un article filtré.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin ou du rôle de base de données fixe db_owner sont habilités à exécuter sp_check_subset_filter.

Valeurs des codes renvoyés

0 (succès) ou 1 (échec)

Voir aussi

Autres ressources

Optimisation des performances des filtres paramétrés avec des partitions précalculées

Aide et Informations

Assistance sur SQL Server 2005