Partage via

sp_check_subset_filter (Transact-SQL)

  • Article

S’applique à : SQL Server Azure SQL Managed Instance

Vérifie une clause de filtre sur une table pour déterminer si la clause de filtre 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.

Conventions de la syntaxe Transact-SQL

Syntaxe

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 ]
[ ; ]

Arguments

[ @filtered_table = ] N’filtered_table'

Nom d’une table filtrée. @filtered_table est nvarchar(400), sans valeur par défaut.

[ @subset_filterclause = ] N’subset_filterclause'

Clause de filtre testée. @subset_filterclause est nvarchar(1000), sans valeur par défaut.

[ @has_dynamic_filters = ] sortie has_dynamic_filters

Spécifie si la clause de filtre est un filtre de lignes paramétrable. @has_dynamic_filters est un paramètre OUTPUT de type bit. Retourne une valeur de lorsque la clause de filtre est un filtre de 1 lignes paramétrable.

Jeu de résultats

Nom de la colonne Type de données Description
can_use_partition_groups bit Est-ce que si la publication se qualifie pour l’utilisation de partitions précomputées ; où 1 signifie que les partitions précomputées peuvent être utilisées et 0 qu’elles ne peuvent pas être utilisées.
has_dynamic_filters bit Est-ce que si la clause de filtre fournie inclut au moins un filtre de lignes paramétrable ; où 1 signifie qu’un filtre de lignes paramétrable est utilisé, et 0 signifie qu’une telle fonction n’est pas utilisée.
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, cela 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, cela 1 signifie que cette fonction est présente.

[ @dynamic_filters_function_list = ] SORTIE N’dynamic_filters_function_list'

Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Notes

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

sp_check_subset_filter peut être exécuté sur une table même si la table n’est pas 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 db_owner rôle de base de données fixe peuvent s’exécuter sp_check_subset_filter.

Contenu connexe