sys.sp_cdc_generate_wrapper_function (Transact-SQL)

Şunlar için geçerlidir: SQL Server

SQL Server'da mevcut olan değişim veri yakalama sorgu fonksiyonları için wrapper fonksiyonları oluşturmak üzere betikler oluşturur. Oluşturulan wrapper'larda desteklenen API, sorgu aralığını tarih-zaman aralığı olarak belirtmeyi mümkün kılar. Bu spesifikasyon, fonksiyonu, Integration Services paket tasarımcıları tarafından geliştirilen ve artan yükü belirlemek için değişim veri yakalama teknolojisi kullanan uygulamalar da dahil olmak üzere birçok depolama uygulamasında kullanılmak için uygundur.

Tarafından sys.sp_cdc_generate_wrapper_functionüretilen fonksiyonlar hakkında daha fazla bilgi için bkz. sys.fn_all_changes_<capture_instance> ve sys.fn_net_changes_<capture_instance>.

Transact-SQL söz dizimi kuralları

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_instance için betiklerin oluşturulduğu yakalama örneği sysname'dir ve varsayılan değeri 'NULLdir. Bir değer atlanırsa veya açıkça , NULLolarak ayarlanırsa, tüm yakalama örnekleri için wrapper betikleri üretilir.

[ @closed_high_end_point = ] closed_high_end_point

Yüksek uç noktaya eşit commit süresine sahip değişikliklerin, oluşturulan prosedür tarafından çıkarma aralığına dahil edilip edilmediğini gösteren bayrak biti. @closed_high_end_pointbittir ve varsayılan değeri 1, bu da uç noktanın dahil edilmesi gerektiğini gösterir. Değeri, 0 tüm commit sürelerinin kesinlikle yüksek uç noktadan daha az olduğunu gösterir.

[ @column_list = ] N'column_list'

Sonuç kümesine dahil edilen ve wrapper fonksiyonu tarafından döndürülen yakalanan sütunların listesi. @column_listnvarchar(max) ve varsayılan değeri .NULL Belirtildiğinde NULL , ele geçirilen tüm sütunlar dahil edilir.

[ @update_flag_list = ] N'update_flag_list'

Wrapper fonksiyonu tarafından döndürülen sonuç kümesine güncelleme bayrağı dahil edilen sütunların listesi. @update_flag_listnvarchar(max) ve varsayılan değeri .NULL Belirtildiğinde NULL , güncelleme bayrakları dahil edilmez.

Dönüş kodu değerleri

0 (başarı) veya 1 (başarısızlık).

Sonuç kümesi

Sütun adı Sütun türü Description
function_name nvarchar(145) Oluşturulan fonksiyonun adı.
create_script nvarchar(max) Capture-instance wrapper fonksiyonunu oluşturan betik.

Açıklamalar

Bir yakalama örneği için tüm değişiklikler sorgusunu saran fonksiyonu oluşturan betik her zaman oluşturulur. Yakalama örneği net değişiklikler sorgularını destekliyorsa, bu sorgu için bir wrapper oluşturacak betik de oluşturulur.

Örnekler

Aşağıdaki örnek, tüm değişiklik veri yakalama fonksiyonları için wrapperlar oluşturmak için nasıl kullanabileceğinizi sys.sp_cdc_generate_wrapper_function göstermektedir.

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;