sys.sp_cdc_generate_wrapper_function (Transact-SQL)

platí pro:SQL Server

Generuje skripty pro vytváření obalových funkcí pro dotazovací funkce pro zachycení změn dat, které jsou dostupné v SQL Server. API podporované ve generovaných obalech umožňuje specifikovat interval dotazu jako interval datového času. Tato specifikace činí tuto funkci vhodnou pro použití v mnoha skladovacích aplikacích, včetně těch vyvinutých návrháři balíčků Integration Services, kteří využívají technologii zachycování změn dat k určení přírůstkové zátěže.

Pro více informací o funkcích generovaných , sys.sp_cdc_generate_wrapper_functionviz sys.fn_all_changes_<capture_instance> a sys.fn_net_changes_<capture_instance>.

Transact-SQL konvence syntaxe

Syntax

sys.sp_cdc_generate_wrapper_function
    [ [ @capture_instance = ] N'capture_instance' ]
    [ , [ @closed_high_end_point = ] closed_high_end_point ]
    [ , [ @column_list = ] N'column_list' ]
    [ , [ @update_flag_list = ] N'update_flag_list' ]
[ ; ]

Arguments

[ @capture_instance = ] N'capture_instance'

Instance zachycení, pro kterou jsou skripty generovány pro @capture_instance , je sysname a má výchozí hodnotu NULL. Pokud je hodnota vynechána nebo explicitně nastavena na , NULLjsou generovány skripty obalu pro všechny instance zachycení.

[ @closed_high_end_point = ] closed_high_end_point

Příznakový bit, který určuje, zda jsou změny s časem uložení rovným vysokému koncovému bodu zahrnuty do extrakčního intervalu generovaným postupem. @closed_high_end_point je bit a má výchozí hodnotu 1, což naznačuje, že by měl být zahrnut tento koncový bod. Hodnota označuje 0 , že všechny doby potvrzení jsou přísně kratší než nejvyšší konečný bod.

[ @column_list = ] N'column_list'

Seznam zachycených sloupců zahrnutých ve výsledné množině, který vrací funkce obalovače. @column_list je nvarchar(max) a má výchozí hodnotu NULL. Když NULL je specifikováno, jsou zahrnuty všechny zachycené sloupce.

[ @update_flag_list = ] N'update_flag_list'

Seznam zahrnutých sloupců, pro které je v množině výsledků vrácené funkcí wrapper zahrnuta aktualizační příznak. @update_flag_list je nvarchar(max) a má výchozí hodnotu NULL. Když NULL je to specifikováno, nejsou zahrnuty žádné aktualizační příznaky.

Hodnoty návratového kódu

0 (úspěch) nebo 1 (selhání).

Sada výsledků

Název sloupce Typ sloupce Description
function_name nvarchar(145) Název generované funkce.
create_script nvarchar(max) Skript, který vytváří funkci wrapperu zachycení instance.

Remarks

Skript, který vytváří funkci pro zabalení dotazu all-changes pro zachycení instance, je vždy generován. Pokud instance zachycení podporuje dotazy net-changes, je také vytvořen skript pro generování obalu pro tento dotaz.

Examples

Následující příklad ukazuje, jak můžete použít sys.sp_cdc_generate_wrapper_function k vytvoření obalů pro všechny funkce zachycování změn dat.

DECLARE @wrapper_functions TABLE (
    function_name SYSNAME,
    create_script NVARCHAR (MAX));

INSERT INTO @wrapper_functions
EXECUTE sys.sp_cdc_generate_wrapper_function;

DECLARE @create_script AS NVARCHAR (MAX);

DECLARE #hfunctions CURSOR LOCAL FAST_FORWARD
    FOR SELECT create_script
        FROM @wrapper_functions;

OPEN #hfunctions;

FETCH #hfunctions INTO @create_script;

WHILE (@@fetch_status <> -1)
    BEGIN
        EXECUTE sp_executesql @create_script;
        FETCH #hfunctions INTO @create_script;
    END

CLOSE #hfunctions;

DEALLOCATE #hfunctions;