sp_check_join_filter (Transact-SQL)

Gilt für: SQL Server Azure SQL Managed Instance

Wird dazu verwendet, einen Joinfilter zwischen zwei Tabellen zu überprüfen, um festzustellen, ob die Joinfilterklausel gültig ist. Diese gespeicherte Prozedur gibt außerdem Informationen zum angegebenen Joinfilter zurück, u. a. mit dem Hinweis, ob der Filter für die angegebene Tabelle zusammen mit vorausberechneten Partitionen verwendet werden kann. Diese gespeicherte Prozedur wird auf dem Verleger für die Veröffentlichung ausgeführt. Weitere Informationen finden Sie unter Optimieren Parametrisierter Filter-Leistung mit Vorausberechneten Partitionen .

Transact-SQL-Syntaxkonventionen

Syntax

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

Argumente

[ @filtered_table = ] 'filtered_table' Ist der Name einer gefilterten Tabelle. filtered_table ist nvarchar(400), ohne Standard.

[ @join_table = ] 'join_table' Ist der Name einer Tabelle, die mit filtered_table verknüpft wird. join_table ist nvarchar(400), ohne Standard.

[ @join_filterclause = ] 'join_filterclause' Wird die Verknüpfungsfilterklausel getestet. join_filterclause ist nvarchar(1000), ohne Standard.

Resultsets

Spaltenname	Datentyp	Beschreibung
can_use_partition_groups	bit	Ist, wenn die Publikation für vorkompilierte Partitionen qualifiziert ist; wobei 1 bedeutet, 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 eine parametrisierte Filterfunktion enthält; wobei 1 bedeutet, dass eine parametrisierte Filterfunktion 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 parametrisierten Filter für einen Artikel definieren. Dabei sind die einzelnen Funktionen durch ein Semikolon voneinander getrennt.
uses_host_name	bit	Wenn die funktion HOST_NAME() in der Filterklausel verwendet wird, wobei 1 bedeutet, dass diese Funktion vorhanden ist.
uses_suser_sname	bit	Wenn die funktion SUSER_SNAME() in der Filterklausel verwendet wird, wobei 1 bedeutet, dass diese Funktion vorhanden ist.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_check_join_filter wird in der Seriendruckreplikation verwendet.

sp_check_join_filter können für alle verknüpften Tabellen ausgeführt werden, auch wenn sie nicht veröffentlicht werden. Mit dieser gespeicherten Prozedur kann eine Joinfilterklausel überprüft werden, bevor ein Joinfilter zwischen zwei Artikeln definiert wird.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin oder db_owner feste Datenbankrolle können sp_check_join_filter ausgeführt werden.

Weitere Informationen

Gespeicherte Replikationsprozeduren (Transact-SQL)