sp_register_custom_scripting(Transact-SQL)

복제를 사용하면 트랜잭션 복제에서 사용되는 하나 이상의 기본 프로시저를 사용자 정의 사용자 지정 저장 프로시저로 바꿀 수 있습니다. 이러한 저장 프로시저는 복제된 테이블에서 스키마 변경이 발생하면 다시 생성됩니다. sp_register_custom_scripting은 스키마 변경이 발생할 때 실행되는 저장 프로시저 또는 Transact-SQL 스크립트 파일을 등록하여 새 사용자 정의 사용자 지정 저장 프로시저에 대한 정의를 스크립팅합니다. 새 사용자 정의 사용자 지정 저장 프로시저는 테이블에 대한 새 스키마를 반영해야 합니다. sp_register_custom_scripting은 게시 데이터베이스에 있는 게시자에서 실행되며 등록된 스크립트 파일 또는 저장 프로시저는 스키마 변경이 발생할 때 구독자에서 실행됩니다.

항목 링크 아이콘 Transact-SQL 구문 표기 규칙

구문

sp_register_custom_scripting [ @type  = ] 'type'
    [ @value = ] 'value' 
    [ , [ @publication = ] 'publication' ]
    [ , [ @article = ] 'article' ]

인수

  • [ **@type** = ] 'type'
    등록되는 사용자 지정 저장 프로시저 또는 스크립트의 유형입니다. type은 **varchar(16)**이며 기본값은 없고 다음 값 중 하나일 수 있습니다.

    설명

    insert

    INSERT 문이 복제될 때 실행되는 등록된 사용자 지정 저장 프로시저입니다.

    update

    UPDATE 문이 복제될 때 실행되는 등록된 사용자 지정 저장 프로시저입니다.

    delete

    DELETE 문이 복제될 때 실행되는 등록된 사용자 지정 저장 프로시저입니다.

    custom_script

    DDL(데이터 정의 언어) 트리거의 끝에 실행되는 스크립트입니다.

  • [ **@value**= ] 'value'
    등록되는 저장 프로시저의 이름 또는 Transact-SQL 스크립트 파일의 이름과 정규화된 경로입니다. value는 **nvarchar(1024)**이며 기본값은 없습니다.

    [!참고]

    value 매개 변수에 NULL을 지정하면 이전에 등록된 스크립트를 등록 취소합니다. 이는 sp_unregister_custom_scripting을 실행하는 것과 같습니다.

    type 값이 custom_script인 경우 Transact-SQL 스크립트 파일의 이름과 전체 경로가 필요합니다. 그렇지 않은 경우 value는 등록된 저장 프로시저의 이름이어야 합니다.

  • [ **@publication**= ] 'publication'
    사용자 지정 저장 프로시저 또는 스크립트가 등록되는 게시의 이름입니다. publication은 sysname이며 기본값은 NULL입니다.

  • [ **@article**= ] 'article'
    사용자 지정 저장 프로시저 또는 스크립트가 등록되는 아티클의 이름입니다. article은 sysname이며 기본값은 NULL입니다.

반환 코드 값

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

주의

sp_register_custom_scripting은 스냅숏 및 트랜잭션 복제에 사용됩니다.

이 저장 프로시저는 복제된 테이블에서 스키마 변경이 발생하기 전에 실행해야 합니다. 이 저장 프로시저 사용 방법에 대한 자세한 내용은 스키마 변경 내용을 반영하기 위해 사용자 지정 트랜잭션 프로시저 다시 생성을 참조하십시오.

사용 권한

sysadmin 고정 서버 역할, db_owner 고정 데이터베이스 역할 또는 db_ddladmin 고정 데이터베이스 역할의 멤버만 sp_register_custom_scripting을 실행할 수 있습니다.

참고 항목

참조

sp_unregister_custom_scripting(Transact-SQL)