sp_check_subset_filter (Transact-SQL)
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
.