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

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.Is used to check a filter clause against any table to determine if the filter clause is valid for the 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.This stored procedure returns information about the supplied filter, including if the filter qualifies for use with precomputed partitions. Cette procédure stockée est exécutée au niveau du serveur de publication dans la base de données contenant la publication.This stored procedure is executed at the Publisher on the database containing the publication.

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

SyntaxeSyntax

  
sp_check_subset_filter [ @filtered_table = ] 'filtered_table'  
        , [ @subset_filterclause = ] 'subset_filterclause'  
    [ , [ @has_dynamic_filters = ] has_dynamic_filters OUTPUT ]  

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.

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

[ @has_dynamic_filters = ] has_dynamic_filtersIndique si la clause de filtre est un filtre de lignes paramétrable.[ @has_dynamic_filters = ] has_dynamic_filters Is if the filter clause is a parameterized row filter. has_dynamic_filters est de type bit, avec NULL comme valeur par défaut et est un paramètre de sortie.has_dynamic_filters is bit, with a default of NULL and is an output parameter. Retourne la valeur 1 lorsque la clause de filtre est un filtre de lignes paramétrable.Returns a value of 1 when the filter clause is a parameterized row filter.

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 l’utilisation de 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.Is if the publication qualifies for using precomputed partitions; where 1 means that precomputed 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 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.Is if the supplied filter clause includes at least one parameterized row filter; where 1 means that a parameterized row filter is used, and 0 means that such a function is not used.
dynamic_filters_function_listdynamic_filters_function_list nvarchar(500)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.List of the functions in the filter clause that dynamically filter 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_subset_filter est utilisé dans la réplication de fusion.sp_check_subset_filter is used in merge replication.

sp_check_subset_filter peut être exécuté sur n’importe quelle table, même si la table n’est pas publiée.sp_check_subset_filter can be executed against any table even if the table is not published. Cette procédure stockée peut être utilisée pour vérifier une clause de filtre avant de définir un article filtré.This stored procedure can be used to verify a filter clause before defining a filtered article.

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_subset_filter.Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_check_subset_filter.

Voir aussiSee Also

Optimiser les performances des filtres paramétrés avec des partitions précalculéesOptimize Parameterized Filter Performance with Precomputed Partitions