sp_check_dynamic_filters (Transact-SQL)
Displays information on parameterized row filter properties for a publication, in particular the functions used to generate a filtered data partition for a publication and whether the publication qualifies for using precomputed partitions. This stored procedure is executed at the Publisher on the publication database.
.gif "Topic link icon")
Transact-SQL Syntax Conventions
Syntax
sp_check_dynamic_filters [ @publication = ] 'publication'
Arguments
- [ @publication= ] 'publication'
Is the name of the publication. publication is sysname, with no default.
Return Code Values
0 (success) or 1 (failure)
Result Sets
| Column name | Data type | Description |
|---|---|---|
can_use_partition_groups |
bit |
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_filters |
bit |
Is if at least one parameterized row filter has been defined in the publication; where 1 means that one or more parameterized row filters exist, and 0 means that no dynamic filters exist. |
dynamic_filters_function_list |
nvarchar(500) |
List of functions used to filter articles in a publication, where each function is separated by a semi-colon. |
validate_subscriber_info |
nvarchar(500) |
List of functions used to filter articles in a publication, where each function is separated by a plus sign (+). |
uses_host_name |
bit |
If the HOST_NAME() function is used in parameterized row filters, where 1 means that this function is used for dynamic filtering. |
uses_suser_sname |
bit |
If the SUSER_SNAME() function is used in parameterized row filters, where 1 means that this function is used for dynamic filtering. |
Remarks
sp_check_dynamic_filters is used in merge replication.
If a publication has been defined to use precomputed partitions, sp_check_dynamic_filters checks for any violations of the restrictions of precomputed partitions. If any are found, an error is returned. For more information, see Optimizing Parameterized Filter Performance with Precomputed Partitions.
If a publication has been defined as having parameterized row filters, but no parameterized row filters are found, an error is returned.
Permissions
Only members of the sysadmin fixed server role or db_owner fixed database role can execute sp_check_dynamic_filters.
See Also
Reference
sp_check_join_filter (Transact-SQL)
sp_check_subset_filter (Transact-SQL)