sys.sp_cdc_generate_wrapper_function(Transact-SQL)

SQL Server에서 사용할 수 있는 변경 데이터 캡처 쿼리 함수에 대한 래퍼 함수를 만드는 스크립트를 생성합니다. 생성된 래퍼에서 지원되는 API를 사용하면 쿼리 간격을 날짜/시간 간격으로 지정할 수 있습니다. 이렇게 하면 변경 데이터 캡처 기술을 사용하여 증분 로드를 결정하는 Integration Services 패키지 디자이너가 개발하는 웨어하우징 응용 프로그램을 비롯한 많은 웨어하우징 응용 프로그램에서 함수 사용이 용이해집니다.

Transact-SQL 구문 표기 규칙

구문

sys.sp_cdc_generate_wrapper_function
    [ [ @capture_instance sysname = ] 'capture_instance'
    [ , [ @closed_high_end_point = ] closed_high_end_pt
    [ , [ @column_list = ] 'column_list'

    [ , [ @update_flag_list = ] 'update_flag_list'

인수

• [ @capture\_instance = ] 'capture_instance'
  스크립트를 생성할 캡처 인스턴스입니다. capture_instance는 sysname이며 기본값은 NULL입니다. 값이 생략되거나 NULL로 명시적으로 설정된 경우 모든 캡처 인스턴스에 대해 래퍼 스크립트가 생성됩니다.

• [ @closed\_high\_end\_point = ] high_end_pt_flag
  생성된 프로시저가 커밋 시간이 상위 끝점과 같은 변경 내용을 추출 간격에 포함할지 여부를 나타내는 플래그 비트입니다. high_end_pt_flag는 bit이며 기본값은 끝점을 포함해야 함을 나타내는 1입니다. 값 0은 모든 커밋 시간이 상위 끝점보다 낮아야 함을 나타냅니다.

• [ @column\_list = ] 'column_list'
  래퍼 함수가 반환하는 결과 집합에 포함할 캡처된 열 목록입니다. column_list는 nvarchar(max)이며 기본값은 NULL입니다. NULL을 지정하면 캡처된 모든 열이 포함됩니다.

• [ @update\_flag\_list = ] 'update_flag_list'
  래퍼 함수가 반환하는 결과 집합에 업데이트 플래그가 포함되는 포함 열 목록입니다. update_flag_list는 nvarchar(max)이며 기본값은 NULL입니다. NULL을 지정하면 업데이트 플래그가 포함되지 않습니다.

반환 코드 값

0(성공) 또는 1(실패)

결과 집합

열 이름	열 유형	설명
function_name	nvarchar(145)	생성된 함수의 이름입니다.
create_script	nvarchar(max)	캡처 인스턴스 래퍼 함수를 만드는 스크립트입니다.

주의

캡처 인스턴스에 대한 모든 변경 쿼리를 래핑하는 함수를 만드는 스크립트는 항상 생성됩니다. 캡처 인스턴스가 순 변경 쿼리를 지원하는 경우 이 쿼리에 대한 래퍼를 생성하는 스크립트도 생성됩니다.

예

다음 예에서는 sys.sp_cdc_generate_wrapper_function을 사용하여 모든 변경 데이터 캡처 함수에 대한 래퍼를 만드는 방법을 보여 줍니다.

DECLARE @wrapper_functions TABLE (
    function_name sysname,
    create_script nvarchar(max));

INSERT INTO @wrapper_functions
EXEC sys.sp_cdc_generate_wrapper_function;

DECLARE @create_script 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
    EXEC sp_executesql @create_script
    FETCH #hfunctions INTO @create_script
END;

CLOSE #hfunctions;
DEALLOCATE #hfunctions;

참고 항목

참조

변경 데이터 캡처 저장 프로시저(Transact-SQL)

개념

변경 데이터 캡처를 사용하여 증분 로드 개선