sys.sp_cdc_generate_wrapper_function (Transact-SQL)

Gäller för:SQL Server

Genererar skript för att skapa wrapper-funktioner för de change data capture-frågefunktioner som finns tillgängliga i SQL Server. API:et som stöds i de genererade wrappers möjliggör specificering av frågeintervallet som ett datumtidsintervall. Denna specifikation gör funktionen lämplig för användning i många lagerapplikationer, inklusive applikationer utvecklade av Integration Services-paketdesigners som använder data capture-teknik för förändring för att bestämma inkrementell belastning.

För mer information om funktionerna som genereras av sys.sp_cdc_generate_wrapper_function, se sys.fn_all_changes_<capture_instance> och sys.fn_net_changes_<capture_instance>.

Transact-SQL syntaxkonventioner

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'

Capture-instansen som skript genereras för @capture_instance är sysname och har ett standardvärde på NULL. Om ett värde utelämnas eller uttryckligen sätts till NULL, genereras wrapper-skript för alla capture-instanser.

[ @closed_high_end_point = ] closed_high_end_point

Flaggbiten som anger om förändringar med en committ-tid lika med den höga ändpunkten inkluderas i extraktionsintervallet av den genererade proceduren. @closed_high_end_point är bit och har ett standardvärde på 1, vilket indikerar att ändpunkten bör inkluderas. Ett värde på 0 indikerar att alla committ-tider är strikt kortare än den höga ändpunkten.

[ @column_list = ] N'column_list'

En lista över fångade kolumner som ingår i resultatuppsättningen och som returneras av wrapper-funktionen. @column_list är nvarchar(max) och har ett standardvärde på NULL. När NULL anges inkluderas alla fångade kolumner.

[ @update_flag_list = ] N'update_flag_list'

En lista över inkluderade kolumner där en uppdateringsflagga ingår i resultatuppsättningen som returneras av wrapper-funktionen. @update_flag_list är nvarchar(max) och har ett standardvärde på NULL. När NULL anges ingår inga uppdateringsflaggor.

Returnera kodvärden

0 (lyckades) eller 1 (fel).

Resultatuppsättning

Kolumnnamn Kolumntyp Beskrivning
function_name Nvarchar(145) Namnet på den genererade funktionen.
create_script nvarchar(max) Skriptet som skapar capture-instance wrapper-funktionen.

Remarks

Skriptet som skapar funktionen för att wrappa all-changes-frågan för en capture-instans genereras alltid. Om capture-instansen stöder net-change-frågor genereras även skriptet för att generera en wrapper för denna fråga.

Examples

Följande exempel visar hur du kan använda sys.sp_cdc_generate_wrapper_function dem för att skapa wrappers för alla funktioner för förändringsdatainsamling.

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;