sp_check_join_filter (Transact-SQL)

Article
04/26/2023

S’applique à :SQL Server Azure SQL Managed Instance

S'utilise pour vérifier un filtre de jointure entre deux tables pour déterminer si la clause du filtre est valide. Cette procédure stockée renvoie également des informations sur le filtre de jointure fourni, y compris s'il est possible de l'utiliser avec des partitions précalculées pour la table donnée. Cette procédure stockée est exécutée sur la base de données du serveur de publication. Pour plus d’informations, consultez Optimiser les performances des filtres paramétrés avec des partitions précalculées.

Conventions de la syntaxe Transact-SQL

Syntaxe

  
sp_check_join_filter [ @filtered_table = ] 'filtered_table'  
        , [@join_table = ] 'join_table'  
        , [ @join_filterclause = ] 'join_filterclause'

Arguments

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

[ @join_table = ] 'join_table' Nom d’une table jointe à filtered_table. join_table est nvarchar(400), sans valeur par défaut.

[ @join_filterclause = ] 'join_filterclause' La clause de filtre de jointure est-elle testée. join_filterclause est nvarchar(1000), sans valeur par défaut.

Jeux de résultats

Nom de la colonne	Type de données	Description
can_use_partition_groups	bit	Est si la publication est éligible pour les partitions précalculées ; où 1 signifie que les partitions précalculées peuvent être utilisées, et 0 signifie qu’elles ne peuvent pas être utilisées.
has_dynamic_filters	bit	Est si la clause de filtre fournie inclut au moins une fonction de filtrage paramétrable ; où 1 signifie qu’une fonction de filtrage paramétrable est utilisée, et 0 signifie qu’une telle fonction n’est pas utilisée.
dynamic_filters_function_list	nvarchar(500)	Liste des fonctions de la clause du filtre qui définissent un filtrage paramétré pour un article. 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ù 1 signifie que cette fonction est présente.
uses_suser_sname	bit	Si la fonction SUSER_SNAME() est utilisée dans la clause filter, où 1 signifie que cette fonction est présente.

Codet de retour

0 (réussite) ou 1 (échec)

Notes

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

sp_check_join_filter peuvent être exécutés sur toutes les tables associées, même si elles ne sont pas publiées. Cette procédure stockée peut être utilisée pour vérifier une clause de filtre de jointure avant de définir un filtre de jointure entre deux articles.

Autorisations

Seuls les membres du rôle serveur fixe sysadmin ou db_owner rôle de base de données fixe peuvent exécuter sp_check_join_filter.

Voir aussi

Procédures stockées de réplication (Transact-SQL)