sp_check_join_filter (Transact-SQL)

Wird dazu verwendet, einen Verknüpfungsfilter zwischen zwei Tabellen zu überprüfen, um festzustellen, ob die Verknüpfungsfilterklausel gültig ist. Diese gespeicherte Prozedur gibt außerdem Informationen zum angegebenen Verknüpfungsfilter 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 der Leistung parametrisierter Filter mithilfe vorausberechneter Partitionen.

Themenlink (Symbol)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'
    Der Name einer gefilterten Tabelle. filtered_table ist vom Datentyp nvarchar(400) und hat keinen Standardwert.

  • [ @join_table= ] 'join_table'
    Der Name einer mit filtered_table verknüpften Tabelle. join_table ist vom Datentyp nvarchar(400) und hat keinen Standardwert.

  • [ @join_filterclause = ] 'join_filterclause'
    Die getestete Verknüpfungsfilterklausel. join_filterclause ist vom Datentyp nvarchar(1000) und hat keinen Standardwert.

Resultsets

Spaltenname

Datentyp

Beschreibung

can_use_partition_groups

bit

Ist vorhanden, wenn die Veröffentlichung die Berechtigung für vorausberechnete Partitionen besitzt. Dabei bedeutet 1, dass vorausberechnete Partitionen verwendet werden können. 0 bedeutet, dass sie nicht verwendet werden können.

has_dynamic_filters

bit

Ist vorhanden, wenn die angegebene Filterklausel mindestens eine parametrisierte Filterfunktion enthält. Dabei bedeutet 1, dass eine parametrisierte Filterfunktion verwendet wird. 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

Ist angegeben, wenn die HOST_NAME()-Funktion in der Filterklausel verwendet wird. Dabei bedeutet 1, dass diese Funktion vorhanden ist.

uses_suser_sname

bit

Ist angegeben, wenn die SUSER_SNAME()-Funktion in der Filterklausel verwendet wird. Dabei bedeutet 1, dass diese Funktion vorhanden ist.

Rückgabecodewerte

0 (Erfolg) oder 1 (Fehler)

Hinweise

sp_check_join_filter wird für die Mergereplikation verwendet.

sp_check_join_filter kann für alle verknüpften Tabellen ausgeführt werden, selbst wenn sie nicht veröffentlicht sind. Mit dieser gespeicherten Prozedur kann eine Verknüpfungsfilterklausel überprüft werden, bevor ein Verknüpfungsfilter zwischen zwei Artikeln definiert wird.

Berechtigungen

Nur Mitglieder der festen Serverrolle sysadmin oder der festen Datenbankrolle db_owner können sp_check_join_filter ausführen.