sp_check_join_filter (Transact-SQL)sp_check_join_filter (Transact-SQL)

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure SQL Data Warehouse nonParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse noParallel Data Warehouse

S'utilise pour vérifier un filtre de jointure entre deux tables pour déterminer si la clause du filtre est valide.Is used to verify a join filter between two tables to determine if the join filter clause is valid. 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.This stored procedure also returns information about the supplied join filter, including if it can be used with precomputed partitions for the given table. Cette procédure stockée est exécutée sur la base de données du serveur de publication.This stored procedure is executed at the Publisher on the publication. Pour plus d’informations, consultez Optimiser les performances des filtres paramétrés avec des partitions précalculées.For more information, see Optimize Parameterized Filter Performance with Precomputed Partitions.

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

ArgumentsArguments

[ @filtered_table = ] 'filtered_table'Nom d’une table filtrée.[ @filtered_table = ] 'filtered_table' Is the name of a filtered table. filtered_table est de type nvarchar (400) , sans valeur par défaut.filtered_table is nvarchar(400), with no default.

[ @join_table = ] 'join_table'Nom d’une table jointe à filtered_table.[ @join_table = ] 'join_table' Is the name of a table being joined to filtered_table. join_table est de type nvarchar (400) , sans valeur par défaut.join_table is nvarchar(400), with no default.

[ @join_filterclause = ] 'join_filterclause'Clause de filtre de jointure en cours de test.[ @join_filterclause = ] 'join_filterclause' Is the join filter clause being tested. join_filterclause est de type nvarchar (1000) , sans valeur par défaut.join_filterclause is nvarchar(1000), with no default.

Jeux de résultatsResult Sets

Nom de la colonneColumn name Type de donnéesData type DescriptionDescription
can_use_partition_groupscan_use_partition_groups bitbit Indique si la publication est qualifiée pour les partitions précalculées; où 1 signifie que les partitions precomupted peuvent être utilisées, et 0 signifie qu’elles ne peuvent pas être utilisées.Is if the publication qualifies for precomputed partitions; where 1 means that precomupted partitions can be used, and 0 means that they cannot be used.
has_dynamic_filtershas_dynamic_filters bitbit Indique si la clause de filtre fournie comprend au moins une fonction de filtrage paramétrée; 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.Is if the supplied filter clause includes at least one parameterized filtering function; where 1 means that a parameterized filtering function is used, and 0 means that such a function is not used.
dynamic_filters_function_listdynamic_filters_function_list nvarchar(500)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.List of the functions in the filter clause that define a parameterized filter for an article, where each function is separated by a semi-colon.
uses_host_nameuses_host_name bitbit Si la fonction HOST_NAME () est utilisée dans la clause de filtre, où 1 indique que cette fonction est présente.If the HOST_NAME() function is used in the filter clause, where 1 means that this function is present.
uses_suser_snameuses_suser_sname bitbit Si la fonction SUSER_SNAME () est utilisée dans la clause de filtre, où 1 indique que cette fonction est présente.If the SUSER_SNAME() function is used in the filter clause, where 1 means that this function is present.

Valeurs des codes de retourReturn Code Values

0 (succès) ou 1 (échec)0 (success) or 1 (failure)

NotesRemarks

sp_check_join_filter est utilisé dans la réplication de fusion.sp_check_join_filter is used in merge replication.

sp_check_join_filter peut être exécuté sur toutes les tables associées, même si elles ne sont pas publiées.sp_check_join_filter can be executed against any related tables even if they are not published. 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.This stored procedure can be used to verify a join filter clause before defining a join filter between two articles.

AutorisationsPermissions

Seuls les membres du rôle serveur fixe sysadmin ou du rôle de base de données fixe db_owner peuvent exécuter sp_check_join_filter.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_check_join_filter.

Voir aussiSee Also

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