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.
.gif "Icône Lien de rubrique")
Conventions 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