sp_check_subset_filter (Transact-SQL)
Gilt für: SQL Server
Azure SQL Managed Instance
Überprüft eine Filterklausel anhand einer beliebigen Tabelle, um festzustellen, ob die Filterklausel für die Tabelle gültig ist. Diese gespeicherte Prozedur gibt Informationen zum bereitgestellten Filter zurück, einschließlich der Angabe, ob der Filter mit vorausberechneten Partitionen verwendet werden kann. Diese gespeicherte Prozedur wird auf dem Verleger für die Datenbank ausgeführt, die die Veröffentlichung enthält.
Transact-SQL-Syntaxkonventionen
Syntax
sp_check_subset_filter
[ @filtered_table = ] N'filtered_table'
, [ @subset_filterclause = ] N'subset_filterclause'
[ , [ @has_dynamic_filters = ] has_dynamic_filters OUTPUT ]
[ , [ @dynamic_filters_function_list = ] N'dynamic_filters_function_list' OUTPUT ]
[ ; ]
Argumente
[ @filtered_table = ] N'filtered_table'
Der Name einer gefilterten Tabelle. @filtered_table ist nvarchar(400), ohne Standard.
[ @subset_filterclause = ] N'subset_filterclause'
Die zu testende Filterklausel. @subset_filterclause ist nvarchar(1000), ohne Standard.
[ @has_dynamic_filters = ] has_dynamic_filters OUTPUT
Gibt an, ob es sich bei der Filterklausel um einen parametrisierten Zeilenfilter handelt. @has_dynamic_filters ist ein OUTPUT-Parameter vom Typ Bit. Gibt einen Wert zurück 1
, wenn die Filterklausel ein parametrisierter Zeilenfilter ist.
Resultset
Spaltenname | Datentyp | Beschreibung |
---|---|---|
can_use_partition_groups |
bit | Ist, wenn die Publikation für die Verwendung von vorkompilierten Partitionen qualifiziert ist; dabei 1 bedeutet dies, dass vorkompilierte Partitionen verwendet werden können und 0 bedeutet, dass sie nicht verwendet werden können. |
has_dynamic_filters |
bit | Ist, wenn die angegebene Filterklausel mindestens einen parametrisierten Zeilenfilter enthält; wobei 1 bedeutet, dass ein parametrisierter Zeilenfilter verwendet wird und 0 bedeutet, dass eine solche Funktion nicht verwendet wird. |
dynamic_filters_function_list |
nvarchar(500) | Liste der Funktionen in der Filterklausel, die einen Artikel dynamisch filtern, wobei die Funktionen durch Semikolon voneinander getrennt sind. |
uses_host_name |
bit | Wenn die HOST_NAME-Funktion in der Filterklausel verwendet wird, bedeutet 1 dies, dass diese Funktion vorhanden ist. |
uses_suser_sname |
bit | Wenn die SUSER_SNAME-Funktion in der Filterklausel verwendet wird, bedeutet 1 dies, dass diese Funktion vorhanden ist. |
[ @dynamic_filters_function_list = ] Ausgabe von N'dynamic_filters_function_list'
Nur für Informationszwecke identifiziert. Wird nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt.
Rückgabecodewerte
0
(erfolgreich) oder 1
Fehler.
Hinweise
sp_check_subset_filter
wird in der Seriendruckreplikation verwendet.
sp_check_subset_filter
kann für jede Tabelle ausgeführt werden, auch wenn die Tabelle nicht veröffentlicht wird. Mit dieser gespeicherten Prozedur kann eine Filterklausel vor dem Definieren eines gefilterten Artikels überprüft werden.
Berechtigungen
Nur Mitglieder der festen Serverrolle sysadmin oder db_owner feste Datenbankrolle können ausgeführt werden sp_check_subset_filter
.
Zugehöriger Inhalt
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter:Einreichen und Feedback anzeigen für