sp_addarticle(Transact-SQL)

업데이트: 2006년 4월 14일

아티클을 만들어 게시에 추가합니다. 이 저장 프로시저는 게시 데이터베이스의 게시자에서 실행됩니다.

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

구문

sp_addarticle [ @publication = ] 'publication' 
        , [ @article = ] 'article' 
    [ , [ @source_table = ] 'source_table' ]
    [ , [ @destination_table = ] 'destination_table' ] 
    [ , [ @vertical_partition = ] 'vertical_partition' ] 
    [ , [ @type = ] 'type' ] 
    [ , [ @filter = ] 'filter' ] 
    [ , [ @sync_object= ] 'sync_object' ] 
    [ , [ @ins_cmd = ] 'ins_cmd' ] 
    [ , [ @del_cmd = ] 'del_cmd' ] 
    [ , [ @upd_cmd = ] 'upd_cmd' ] 
    [ , [ @creation_script = ] 'creation_script' ] 
    [ , [ @description = ] 'description' ] 
    [ , [ @pre_creation_cmd = ] 'pre_creation_cmd' ] 
    [ , [ @filter_clause = ] 'filter_clause' ] 
    [ , [ @schema_option = ] schema_option ] 
    [ , [ @destination_owner = ] 'destination_owner' ] 
    [ , [ @status = ] status ] 
    [ , [ @source_owner = ] 'source_owner' ] 
    [ , [ @sync_object_owner = ] 'sync_object_owner' ] 
    [ , [ @filter_owner = ] 'filter_owner' ] 
    [ , [ @source_object = ] 'source_object' ] 
    [ , [ @artid = ] article_ID  OUTPUT ] 
    [ , [ @auto_identity_range = ] 'auto_identity_range' ] 
    [ , [ @pub_identity_range = ] pub_identity_range ] 
    [ , [ @identity_range = ] identity_range ] 
    [ , [ @threshold = ] threshold ] 
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @use_default_datatypes = ] use_default_datatypes
    [ , [ @identityrangemanagementoption = ] identityrangemanagementoption ]
    [ , [ @publisher = ] 'publisher' ]
    [ , [ @fire_triggers_on_snapshot = ] 'fire_triggers_on_snapshot' ] 

인수

  • [ @publication = ] 'publication'
    아티클을 포함하는 게시의 이름입니다. 이 이름은 데이터베이스 내에서 고유해야 합니다. publicationsysname이며 기본값은 없습니다.
  • [ @article = ] 'article'
    아티클 이름입니다. 이 이름은 게시에서 고유해야 합니다. articlesysname이며 기본값은 없습니다.
  • [ @source\_table = ] 'source_table'
    이 매개 변수는 더 이상 사용되지 않으며 이전 버전 스크립트와의 호환성을 위해 지원됩니다. 대신 source_object를 사용하십시오. 이 매개 변수는 Oracle 게시자에 대해서는 지원되지 않습니다.
  • [ @destination\_table = ] 'destination_table'
    source_table 또는 저장 프로시저와 다른 경우 대상(구독) 테이블의 이름입니다. destination_tablesysname이며 기본값은 source_tabledestination_table과 동일함을 의미하는 NULL입니다.
  • [ @vertical\_partition = ] 'vertical_partition'
    테이블 아티클에 열 필터링을 사용하거나 사용하지 않도록 합니다. vertical_partition은 **nchar(5)**이며 기본값은 FALSE입니다.

    false는 열 필터링을 하지 않고 모든 열을 게시함을 나타냅니다.

    true로 설정하면 선언된 기본 키, 기본값이 없는 Null을 허용하는 열 및 고유 키 열을 제외한 모든 열을 지웁니다. 열은 sp_articlecolumn을 사용하여 추가합니다.

  • [ @type = ] 'type'
    아티클 유형입니다. typesysname이며 다음 값 중 하나일 수 있습니다.

    설명

    aggregate schema only

    스키마가 있는 집계 함수 전용입니다.

    func schema only

    스키마가 있는 함수 전용입니다.

    indexed view logbased

    로그 기반의 인덱싱된 뷰 아티클입니다. Oracle 게시자에 대해서는 지원되지 않습니다. 이 유형의 아티클은 기본 테이블을 별도로 게시할 필요가 없습니다.

    indexed view logbased manualboth

    수동 필터 및 수동 뷰가 있는 로그 기반의 인덱싱된 뷰 아티클입니다. 이 옵션을 사용하려면 sync_objectfilter 매개 변수를 모두 지정해야 합니다. 이 유형의 아티클은 기본 테이블을 별도로 게시할 필요가 없습니다. Oracle 게시자에 대해서는 지원되지 않습니다.

    indexed view logbased manualfilter

    수동 필터가 있는 로그 기반의 인덱싱된 뷰 아티클입니다. 이 옵션을 사용하려면 sync_objectfilter 매개 변수를 모두 지정해야 합니다. 이 유형의 아티클은 기본 테이블을 별도로 게시할 필요가 없습니다. Oracle 게시자에 대해서는 지원되지 않습니다.

    indexed view logbased manualview

    수동 뷰가 있는 로그 기반의 인덱싱된 뷰 아티클입니다. 이 옵션을 사용하려면 sync_object 매개 변수를 지정해야 합니다. 이 유형의 아티클은 기본 테이블을 별도로 게시할 필요가 없습니다. Oracle 게시자에 대해서는 지원되지 않습니다.

    indexed view schema only

    스키마가 있는 인덱싱된 뷰 전용입니다. 이 유형의 아티클은 기본 테이블도 게시해야 합니다.

    logbased(기본값)

    로그 기반 아티클입니다.

    logbased manualboth

    수동 필터 및 수동 뷰가 있는 로그 기반 아티클입니다. 이 옵션을 사용하려면 sync_objectfilter 매개 변수를 모두 지정해야 합니다. Oracle 게시자에 대해서는 지원되지 않습니다.

    logbased manualfilter

    수동 필터가 있는 로그 기반 아티클입니다. 이 옵션을 사용하려면 sync_objectfilter 매개 변수를 모두 지정해야 합니다. Oracle 게시자에 대해서는 지원되지 않습니다.

    logbased manualview

    수동 뷰가 있는 로그 기반 아티클입니다. 이 옵션을 사용하려면 sync_object 매개 변수를 지정해야 합니다. Oracle 게시자에 대해서는 지원되지 않습니다.

    proc exec

    아티클의 모든 구독자로 저장 프로시저의 실행을 복제합니다. Oracle 게시자에 대해서는 지원되지 않습니다.

    proc schema only

    스키마가 있는 프로시저 전용입니다. Oracle 게시자에 대해서는 지원되지 않습니다.

    serializable proc exec

    직렬화할 수 있는 트랜잭션 컨텍스트 내에서 실행된 경우에만 저장 프로시저의 실행을 복제합니다. Oracle 게시자에 대해서는 지원되지 않습니다.

    view schema only

    스키마가 있는 뷰 전용입니다. Oracle 게시자에 대해서는 지원되지 않습니다. 이 옵션을 사용할 때는 기본 테이블도 게시해야 합니다.

  • [ @filter = ] 'filter'
    FOR REPLICATION으로 생성되며 테이블을 행 필터링하는 데 사용되는 저장 프로시저입니다. filter는 **nvarchar(386)**이며 기본값은 NULL입니다. 뷰 및 필터 저장 프로시저를 만들려면 sp_articleviewsp_articlefilter를 반드시 수동으로 실행해야 합니다. NULL이 아닌 경우 저장 프로시저가 수동으로 생성되었다고 가정하여 필터 프로시저가 생성되지 않습니다.
  • [ @sync\_object = ] 'sync_object'
    이 아티클의 스냅숏을 표시하는 데 사용되는 데이터 파일을 생성하는 테이블 또는 뷰의 이름입니다. sync_object는 **nvarchar(386)**이며 기본값은 NULL입니다. NULL인 경우 sp_articleview가 호출되어 출력 파일을 생성하는 데 사용되는 뷰를 자동으로 만듭니다. 이런 작업은 sp_articlecolumn을 사용하여 열을 추가한 다음에 수행됩니다. NULL이 아닌 경우 뷰가 수동으로 생성된 것으로 가정하며 뷰가 생성되지 않습니다.
  • [ @ins\_cmd = ] 'ins_cmd'
    이 아티클에 대한 삽입을 복제할 때 사용하는 복제 명령 유형입니다. ins_cmd는 **nvarchar(255)**이며 다음 값 중 하나일 수 있습니다.

    설명

    NONE

    작업이 실행되지 않습니다.

    CALL sp_MSins_table(기본값)

    -또는-

    CALL custom_stored_procedure_name

    구독자에서 실행할 저장 프로시저를 호출합니다. 이 복제 방법을 사용하려면 schema_option을 사용하여 저장 프로시저를 자동으로 만들도록 지정하거나 아티클에 대한 각 구독자의 대상 데이터베이스에 지정한 저장 프로시저를 만듭니다. custom_stored_procedure는 사용자가 만든 저장 프로시저의 이름입니다. sp_MSins_table_table 부분에는 대상 테이블의 이름이 포함됩니다. destination_owner를 지정하면 destination_owner가 대상 테이블 이름 앞에 붙습니다. 예를 들어 구독자에서 Production 스키마가 소유하는 ProductCategory 테이블의 경우 매개 변수는 CALL sp_MSins_ProductionProductCategory가 됩니다. 피어 투 피어 복제 토폴로지에 있는 아티클의 경우 _table이 GUID 값과 함께 추가됩니다. 구독자 업데이트의 경우 custom_stored_procedure를 지정할 수 없습니다.

    SQL 또는 NULL

    INSERT 문을 복제합니다. INSERT 문에는 아티클에 게시된 모든 열에 대한 값이 제공됩니다. 삽입에서 다음 명령이 복제됩니다.

    INSERT INTO <table name> VALUES (c1value, c2value, c3value, ..., cnvalue)

    자세한 내용은 트랜잭션 아티클에 대한 변경 내용을 전파하는 방법 지정을 참조하십시오.

  • [ @del\_cmd =] 'del_cmd'
    이 아티클에 대한 삭제를 복제할 때 사용하는 복제 명령 유형입니다. del_cmd는 **nvarchar(255)**이며 다음 값 중 하나일 수 있습니다.

    설명

    NONE

    작업이 실행되지 않습니다.

    CALLsp_MSdel_table(기본값)

    -또는-

    CALL custom_stored_procedure_name

    구독자에서 실행할 저장 프로시저를 호출합니다. 이 복제 방법을 사용하려면 schema_option을 사용하여 저장 프로시저를 자동으로 만들도록 지정하거나 아티클에 대한 각 구독자의 대상 데이터베이스에 지정한 저장 프로시저를 만듭니다.custom_stored_procedure는 사용자가 만든 저장 프로시저의 이름입니다. sp_MSdel_table_table 부분에는 대상 테이블의 이름이 포함됩니다. destination_owner를 지정하면 destination_owner가 대상 테이블 이름 앞에 붙습니다. 예를 들어 구독자에서 Production 스키마가 소유하는 ProductCategory 테이블의 경우 매개 변수는 CALL sp_MSdel_ProductionProductCategory가 됩니다. 피어 투 피어 복제 토폴로지에 있는 아티클의 경우 _table이 GUID 값과 함께 추가됩니다. 구독자 업데이트의 경우 custom_stored_procedure를 지정할 수 없습니다.

    XCALL sp_MSdel_table

    -또는-

    XCALL custom_stored_procedure_name

    XCALL 스타일 매개 변수를 사용하는 저장 프로시저를 호출합니다. 이 복제 방법을 사용하려면 schema_option을 사용하여 저장 프로시저를 자동으로 만들도록 지정하거나 아티클에 대한 각 구독자의 대상 데이터베이스에 지정한 저장 프로시저를 만듭니다. 구독자 업데이트의 경우 사용자가 만든 저장 프로시저를 지정할 수 없습니다.

    SQL 또는 NULL

    DELETE 문을 복제합니다. DELETE 문에는 모든 기본 키 열 값이 제공됩니다. 삭제에서 다음 명령이 복제됩니다.

    DELETE FROM <table name> WHERE pkc1 = pkc1value AND pkc2 = pkc2value AND pkcn = pkcnvalue

    자세한 내용은 트랜잭션 아티클에 대한 변경 내용을 전파하는 방법 지정을 참조하십시오.

  • [ @upd\_cmd =] 'upd_cmd'
    이 아티클에 대한 업데이트를 복제할 때 사용하는 복제 명령 유형입니다. upd_cmd는 **nvarchar(255)**이며 다음 값 중 하나일 수 있습니다.

    설명

    NONE

    작업이 실행되지 않습니다.

    CALL sp_MSupd_table

    -또는-

    CALL custom_stored_procedure_name

    구독자에서 실행할 저장 프로시저를 호출합니다. 이 복제 방법을 사용하려면 schema_option을 사용하여 저장 프로시저를 자동으로 만들도록 지정하거나 아티클에 대한 각 구독자의 대상 데이터베이스에 지정한 저장 프로시저를 만듭니다.

    MCALL sp_MSupd_table

    -또는-

    MCALL custom_stored_procedure_name

    MCALL 스타일 매개 변수를 사용하는 저장 프로시저를 호출합니다. 이 복제 방법을 사용하려면 schema_option을 사용하여 저장 프로시저를 자동으로 만들도록 지정하거나 아티클에 대한 각 구독자의 대상 데이터베이스에 지정한 저장 프로시저를 만듭니다.custom_stored_procedure는 사용자가 만든 저장 프로시저의 이름입니다. sp_MSupd_table_table 부분에는 대상 테이블의 이름이 포함됩니다. destination_owner를 지정하면 destination_owner가 대상 테이블 이름 앞에 붙습니다. 예를 들어 구독자에서 Production 스키마가 소유하는 ProductCategory 테이블의 경우 매개 변수는 MCALL sp_MSupd_ProductionProductCategory가 됩니다. 피어 투 피어 복제 토폴로지에 있는 아티클의 경우 _table이 GUID 값과 함께 추가됩니다. 구독자 업데이트의 경우 사용자가 만든 저장 프로시저를 지정할 수 없습니다.

    SCALL sp_MSupd_table(기본값)

    -또는-

    SCALL custom_stored_procedure_name

    SCALL 스타일 매개 변수를 사용하는 저장 프로시저를 호출합니다. 이 복제 방법을 사용하려면 schema_option을 사용하여 저장 프로시저를 자동으로 만들도록 지정하거나 아티클에 대한 각 구독자의 대상 데이터베이스에 지정한 저장 프로시저를 만듭니다.custom_stored_procedure는 사용자가 만든 저장 프로시저의 이름입니다. sp_MSupd_table_table 부분에는 대상 테이블의 이름이 포함됩니다. destination_owner를 지정하면 destination_owner가 대상 테이블 이름 앞에 붙습니다. 예를 들어 구독자에서 Production 스키마가 소유하는 ProductCategory 테이블의 경우 매개 변수는 SCALL sp_MSupd_ProductionProductCategory가 됩니다. 피어 투 피어 복제 토폴로지에 있는 아티클의 경우 _table이 GUID 값과 함께 추가됩니다. 구독자 업데이트의 경우 사용자가 만든 저장 프로시저를 지정할 수 없습니다.

    XCALL sp_MSupd_table

    -또는-

    XCALL custom_stored_procedure_name

    XCALL 스타일 매개 변수를 사용하는 저장 프로시저를 호출합니다. 이 복제 방법을 사용하려면 schema_option을 사용하여 저장 프로시저를 자동으로 만들도록 지정하거나 아티클에 대한 각 구독자의 대상 데이터베이스에 지정한 저장 프로시저를 만듭니다. 구독자 업데이트의 경우 사용자가 만든 저장 프로시저를 지정할 수 없습니다.

    SQL 또는 NULL

    UPDATE 문을 복제합니다. UPDATE 문에는 모든 열 값 및 기본 키 열 값이 제공됩니다. 업데이트에서 다음 명령이 복제됩니다.

    UPDATE <table name> SET c1 = c1value, SET c2 = c2value, SET cn = cnvalue WHERE pkc1 = pkc1value AND pkc2 = pkc2value AND pkcn = pkcnvalue

    [!참고] CALL, MCALL, SCALL 및 XCALL 구문에서 구독자에 전파되는 데이터 양은 각각 다릅니다. CALL 구문은 삽입 및 삭제한 모든 열의 모든 값을 전달합니다. SCALL 구문은 영향을 받은 열 값만 전달합니다. XCALL 구문은 열의 이전 값과 함께 변경 여부에 관계없이 모든 열의 값을 전달합니다. 자세한 내용은 트랜잭션 아티클에 대한 변경 내용을 전파하는 방법 지정을 참조하십시오.

  • [ @creation\_script =] 'creation_script'
    구독 데이터베이스에 아티클을 만드는 데 사용하는 아티클 스키마 스크립트(옵션)의 경로 및 이름입니다. creation_script는 **nvarchar(255)**이며 기본값은 NULL입니다.
  • [ @description =] 'description'
    아티클의 설명 항목입니다. description은 **nvarchar(255)**이며 기본값은 NULL입니다.
  • [ @pre\_creation\_cmd =] 'pre_creation_cmd'
    이 아티클의 스냅숏을 적용할 때 구독자에서 동일한 이름의 기존 개체가 검색될 경우 시스템이 수행할 동작을 지정합니다. pre_creation_cmd는 **nvarchar(10)**이며 다음 값 중 하나일 수 있습니다.

    설명

    none

    명령을 사용하지 않습니다.

    delete

    스냅숏을 적용하기 전에 대상 테이블에서 데이터를 삭제합니다. 아티클이 행 필터링되면 필터 절에서 지정한 열에 있는 데이터만 삭제됩니다. 행 필터를 정의하면 Oracle 게시자에 대해서는 지원되지 않습니다.

    drop(기본값)

    대상 테이블을 삭제합니다.

    truncate

    대상 테이블을 자릅니다. ODBC 또는 OLE DB 구독자에는 유효하지 않습니다.

  • [ **@filter\_clause=**\] 'filter_clause'
    행 필터를 정의하는 제한(WHERE) 절입니다. 제약 조건 절을 입력할 때는 키워드인 WHERE를 생략합니다. filter_clausentext이며 기본값은 NULL입니다. 자세한 내용은 게시된 데이터 필터링을 참조하십시오.
  • [ @schema\_option =] schema_option
    지정된 아티클에 대한 스키마 생성 옵션의 비트 마스크입니다. schema_option은 **binary(8)**이며 다음 값 중 하나 이상의 |(비트 OR) 곱일 수 있습니다.

    [!참고] 이 값이 NULL인 경우 시스템은 다른 아티클 속성에 따라 이 아티클에 대해 유효한 스키마 옵션을 자동으로 생성합니다. 주의에 있는 기본 스키마 옵션 표에서는 아티클 유형과 복제 유형의 조합을 기반으로 하여 선택할 수 있는 값을 보여 줍니다.

  • [ @destination\_owner =] 'destination_owner'
    대상 개체 소유자의 이름입니다. destination_ownersysname이며 기본값은 NULL입니다. destination_owner를 지정하지 않은 경우 다음 규칙에 따라 자동으로 소유자가 지정됩니다.

    조건 대상 개체 소유자

    게시는 기본 모드 대량 복사를 사용하여 초기 스냅숏을 생성하며 이는 SQL Server 구독자만 지원합니다.

    기본값은 source_owner 값입니다.

    비-SQL Server(Non-SQL Server) 게시자에서 게시합니다.

    기본값은 대상 데이터베이스의 소유자입니다.

    게시는 문자 모드 대량 복사를 사용하여 초기 스냅숏을 생성하며 이는 비-SQL Server(Non-SQL Server) 구독자를 지원합니다.

    할당되지 않습니다.

    비-SQL Server(Non-SQL Server) 구독자를 지원하려면 destination_owner가 NULL이어야 합니다.

  • [ **@status=**\] status
    아티클이 활성 상태인지 여부와 변경 내용 전파 방법에 대한 추가 옵션을 지정합니다. statustinyint이며 다음 값 중 하나 이상의 |(비트 OR) 곱이 될 수 있습니다.

  • [ @source\_owner =] 'source_owner'
    원본 개체의 소유자입니다. source_ownersysname이며 기본값은 NULL입니다. Oracle 게시자에 대해서는 source_owner를 반드시 지정해야 합니다.
  • [ @sync\_object\_owner =] 'sync_object_owner'
    게시된 아티클을 정의하는 뷰의 소유자입니다. sync_object_ownersysname이며 기본값은 NULL입니다.
  • [ @filter\_owner =] 'filter_owner'
    필터의 소유자입니다. filter_ownersysname이며 기본값은 NULL입니다.
  • [ @source\_object =] 'source_object'
    게시할 데이터베이스 개체입니다. source_objectsysname이며 기본값은 NULL입니다. source_table이 NULL이면 source_object가 NULL이 될 수 없습니다.source_table 대신 source_object를 사용해야 합니다. 스냅숏 또는 트랜잭션 복제를 사용하여 게시할 수 있는 개체의 유형에 대한 자세한 내용은 데이터 및 데이터베이스 개체 게시를 참조하십시오.
  • [ @artid = ] article_ID OUTPUT
    새 아티클의 아티클 ID입니다. article_IDint이고 기본값은 NULL이며 OUTPUT 매개 변수입니다.
  • [ @auto\_identity\_range = ] 'auto_identity_range'
    게시를 생성할 때 자동 ID 범위 처리를 게시에 사용하거나 사용하지 않도록 합니다. auto_identity_range는 **nvarchar(5)**이며 다음 값 중 하나일 수 있습니다.

    설명

    true

    자동 ID 범위 처리를 사용합니다.

    false

    자동 ID 범위 처리를 사용하지 않습니다.

    NULL(기본값)

    ID 범위 처리는 identityrangemanagementoption에 의해 설정됩니다.

    [!참고] auto_identity_range는 더 이상 사용되지 않으며 이전 버전과의 호환성을 위해서만 제공됩니다. ID 범위 관리 옵션을 지정하려면 identityrangemanagementoption을 사용해야 합니다. 자세한 내용은 ID 열 복제를 참조하십시오.

  • [ @pub\_identity\_range = ] pub_identity_range
    identityrangemanagementoptionauto로 설정되어 있거나 auto_identity_rangetrue로 설정되어 있는 아티클의 경우 게시자에서 범위 크기를 제어합니다. pub_identity_rangebigint이며 기본값은 NULL입니다. Oracle 게시자에 대해서는 지원되지 않습니다.
  • [ @identity\_range = ] identity_range
    identityrangemanagementoptionauto로 설정되어 있거나 auto_identity_rangetrue로 설정되어 있는 아티클의 경우 구독자에서 범위 크기를 제어합니다. identity_rangebigint이며 기본값은 NULL입니다. auto_identity_rangetrue로 설정되어 있을 때 사용합니다. Oracle 게시자에 대해서는 지원되지 않습니다.
  • [ @threshold = ] threshold
    배포 에이전트가 새로운 ID 범위를 할당하는 시기를 지정하는 백분율 값입니다. threshold에 지정된 백분율 값이 사용되는 경우, 배포 에이전트가 새로운 ID 범위를 만듭니다. thresholdbigint이며 기본값은 NULL입니다. identityrangemanagementoptionauto로 설정되어 있거나 auto_identity_rangetrue로 설정되어 있는 경우 사용됩니다. Oracle 게시자에 대해서는 지원되지 않습니다.
  • [ @force\_invalidate\_snapshot = ] force_invalidate_snapshot
    이 저장 프로시저가 수행한 작업으로 인해 기존 스냅숏이 무효화될 수도 있습니다. force_invalidate_snapshotbit이며 기본값은 0입니다.

    0을 지정하면 아티클을 추가해도 스냅숏이 무효화되지 않습니다. 저장 프로시저가 새 스냅숏을 필요로 하는 변경을 발견하면 오류가 발생하며 변경이 수행되지 않습니다.

    1은 아티클을 추가할 경우 스냅숏이 무효화될 수 있음을 의미하며 새 스냅숏이 필요한 기존 구독이 있는 경우 오래되어 사용하지 않음으로 표시될 기존 스냅숏과 생성될 새 스냅숏에 대해 사용 권한을 부여합니다.

  • [ @use\_default\_datatypes = ] use_default_datatypes
    Oracle 게시자에서 아티클을 게시할 때 기본 열 데이터 형식 매핑의 사용 여부입니다. use_default_datatypes는 bit이며 기본값은 1입니다.

    1 = 기본 아티클 열 매핑이 사용됩니다. sp_getdefaultdatatypemapping을 실행하여 기본 데이터 형식 매핑을 표시할 수 있습니다.

    0 = 사용자 지정 아티클 열 매핑이 정의되어 sp_addarticle에서 sp_articleview를 호출하지 않습니다.

    use_default_datatypes0으로 설정된 경우 기본값에서 변경된 각 열 매핑에 대해 한 번씩 sp_changearticlecolumndatatype을 실행해야 합니다. 모든 사용자 지정 열 매핑이 정의된 다음 sp_articleview를 실행해야 합니다.

    [!참고] 이 매개 변수는 Oracle 게시자에 대해서만 사용해야 합니다. SQL Server 게시자에 대해 use_default_datatypes0으로 설정하면 오류가 발생합니다.

  • [ @identityrangemanagementoption = ] identityrangemanagementoption
    아티클에 대해 ID 범위 관리를 처리하는 방법을 지정합니다. identityrangemanagementoption은 **nvarchar(10)**이며 다음 값 중 하나일 수 있습니다.

    설명

    none

    복제에서 ID 범위 관리를 명시적으로 수행하지 않습니다. 이 옵션은 이전 버전 SQL Server와의 호환성을 위해서만 사용하는 것이 좋습니다. 피어 복제에 대해서는 허용되지 않습니다.

    manual

    ID 범위 처리를 수동으로 설정하려면 ID 열을 NOT FOR REPLICATION으로 표시합니다.

    auto

    ID 범위의 자동 관리를 지정합니다.

    NULL(기본값)

    auto_identity_rangetrue로 설정되어 있지 않으면 기본값은 none입니다. 피어 투 피어 토폴로지에서는 auto_identity_range가 무시되고 manual이 기본값이 됩니다.

    이전 버전과의 호환성을 위해 identityrangemanagementoption의 값이 NULL인 경우 auto_identity_range의 값이 확인됩니다. 그러나 identityrangemanagementoption의 값이 NULL이 아닌 경우 auto_identity_range의 값은 무시됩니다*.*

    자세한 내용은 ID 열 복제를 참조하십시오.

  • [ @publisher = ] 'publisher'
    비-SQL Server(Non-SQL Server) 게시자를 지정합니다. publishersysname이며 기본값은 NULL입니다.

    [!참고] 아티클을 SQL Server 게시자에 추가할 때는 publisher를 사용하면 안 됩니다.

  • [ @fire\_triggers\_on\_snapshot = ] 'fire_triggers_on_snapshot'
    초기 스냅숏이 적용될 때 복제된 사용자 트리거를 실행할지 여부입니다. fire_triggers_on_snapshot은 **nvarchar(5)**이며 기본값은 FALSE입니다. true는 스냅숏이 적용될 때 복제된 테이블의 사용자 트리거가 실행됨을 의미합니다. 트리거를 복제하려면 schema_option의 비트 마스크 값에 0x100이 포함되어야 합니다.

반환 코드 값

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

주의

sp_addarticle은 스냅숏 복제 또는 트랜잭션 복제에 사용됩니다.

기본적으로 복제는 열 데이터 형식이 복제에서 지원되지 않으면 원본 테이블의 어떤 열도 게시하지 않습니다. 이러한 열을 게시해야 하는 경우 sp_articlecolumn을 실행하여 해당 열을 추가해야 합니다. 자세한 내용은 모든 유형의 복제에 대한 고려 사항을 참조하십시오.

피어 투 피어 트랜잭션 복제를 지원하는 게시에 아티클을 추가하는 경우 다음 제한이 적용됩니다.

  • 모든 logbased 아티클에 대해 매개 변수가 있는 문을 지정해야 하며 status 값으로 16을 지정해야 합니다.
  • 대상 테이블의 이름 및 소유자는 원본 테이블과 일치해야 합니다.
  • 아티클을 행 또는 열 필터링할 수 없습니다.
  • 자동 ID 범위 관리는 지원되지 않습니다. identityrangemanagementoption 값을 manual로 지정해야 합니다.
  • 테이블에 timestamp 열이 있는 경우 이 열을 timestamp로 복제하려면 schema_option에 0x08을 포함시켜야 합니다.
  • ins_cmd, upd_cmddel_cmd 값으로 SQL을 지정할 수 없습니다.

자세한 내용은 피어 투 피어 트랜잭션 복제를 참조하십시오.

개체를 게시하면 해당 정의가 구독자로 복사됩니다. 하나 이상의 다른 개체에 종속된 데이터베이스 개체를 게시하는 경우 참조되는 개체를 모두 게시해야 합니다. 예를 들어 테이블에 종속된 뷰를 게시하는 경우 테이블도 게시해야 합니다.

vertical_partitiontrue로 설정된 경우 sp_addarticle은 마지막 sp_articlecolumn이 추가된 후에 sp_articleview가 호출될 때까지 뷰 생성을 연기합니다.

게시가 구독의 즉시 업데이트를 허용하고 게시된 테이블에 uniqueidentifier 열이 없는 경우 sp_addarticle은 자동으로 테이블에 uniqueidentifier 열을 추가합니다.

변환 가능한 구독을 지원하는 아티클에서는 ins_cmd, del_cmdupd_cmd에 지정된 값이 무시됩니다.

기본 스키마 옵션

이 표에서는 사용자가 schema_options를 지정하지 않은 경우 복제에서 설정되는 기본값을 설명합니다. 이 값은 복제 유형(오른쪽 두 열에 표시됨) 및 아티클 유형(첫번째 열에 표시됨)에 따릅니다.

아티클 유형 복제 유형  

 

트랜잭션

스냅숏

aggregate schema only

0x01

0x01

func schema only

0x01

0x01

indexed view schema only

0x01

0x01

indexed view logbased

0x30F3

0x3071

indexed view logbase manualboth

0x30F3

0x3071

indexed view logbased manualfilter

0x30F3

0x3071

indexed view logbased manualview

0x30F3

0x3071

logbased

0x30F3

0x3071

logbased manualfilter

0x30F3

0x3071

logbased manualview

0x30F3

0x3071

proc exec

0x01

0x01

proc schema only

0x01

0x01

serialized proc exec

0x01

0x01

view schema only

0x01

0x01

[!참고] 게시에 지연 업데이트가 가능한 경우 schema_option 값으로 0x80이 테이블에 표시된 기본값에 추가됩니다. 비-SQL Server(Non-SQL Server) 게시에 대한 schema_option 기본값은 0x050D3입니다.

유효한 스키마 옵션

이 표에서는 복제 유형(오른쪽 두 행에 표시됨)과 아티클 유형(첫 번째 열에 표시됨)에 기반하여 schema_option의 사용 가능한 값을 설명합니다.

아티클 유형 복제 유형  

 

트랜잭션

스냅숏

logbased

모든 옵션

0x02를 제외한 모든 옵션

logbased manualfilter

모든 옵션

0x02를 제외한 모든 옵션

logbased manualview

모든 옵션

0x02를 제외한 모든 옵션

indexed view logbased

모든 옵션

0x02를 제외한 모든 옵션

indexed view logbased manualfilter

모든 옵션

0x02를 제외한 모든 옵션

indexed view logbased manualview

모든 옵션

0x02를 제외한 모든 옵션

indexed view logbase manualboth

모든 옵션

0x02를 제외한 모든 옵션

proc exec

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x400000000x80000000

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x400000000x80000000

serialized proc exec

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x400000000x80000000

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x400000000x80000000

proc schema only

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x400000000x80000000

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x400000000x80000000

view schema only

0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x400000000x80000000

0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x400000000x80000000

func schema only

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x400000000x80000000

0x01, 0x20, 0x2000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x10000000, 0x20000000, 0x400000000x80000000

indexed view schema only

0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x400000000x80000000

0x01, 0x010, 0x020, 0x040, 0x0100, 0x2000, 0x40000, 0x100000, 0x200000, 0x400000, 0x800000, 0x2000000, 0x8000000, 0x400000000x80000000

[!참고] 지연 업데이트 게시의 경우 0x80000x80schema_option 값은 반드시 사용할 수 있어야 합니다. 비-SQL Server(Non-SQL Server) 게시에 대해 지원되는 schema_option 값은 0x01, 0x02, 0x10, 0x40, 0x80, 0x1000, 0x40000X8000입니다.

사용 권한

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

DECLARE @publication    AS sysname;
DECLARE @table AS sysname;
DECLARE @filterclause AS nvarchar(500);
DECLARE @filtername AS nvarchar(386);
DECLARE @schemaowner AS sysname;
SET @publication = N'AdvWorksProductTran'; 
SET @table = N'Product';
SET @filterclause = N'[DiscontinuedDate] IS NULL'; 
SET @filtername = N'filter_out_discontinued';
SET @schemaowner = N'Production';

-- Add a horizontally and vertically filtered article for the Product table.
-- Manually set @schema_option to ensure that the Production schema 
-- is generated at the Subscriber (0x8000000).
EXEC sp_addarticle 
    @publication = @publication, 
    @article = @table, 
    @source_object = @table,
    @source_owner = @schemaowner, 
    @schema_option = 0x80030F3,
    @vertical_partition = N'true', 
    @type = N'logbased',
    @filter_clause = @filterclause;

-- (Optional) Manually call the stored procedure to create the 
-- horizontal filtering stored procedure. Since the type is 
-- 'logbased', this stored procedures is executed automatically.
EXEC sp_articlefilter 
    @publication = @publication, 
    @article = @table, 
    @filter_clause = @filterclause, 
    @filter_name = @filtername;

-- Add all columns to the article.
EXEC sp_articlecolumn 
    @publication = @publication, 
    @article = @table;

-- Remove the DaysToManufacture column from the article
EXEC sp_articlecolumn 
    @publication = @publication, 
    @article = @table, 
    @column = N'DaysToManufacture', 
    @operation = N'drop';

-- (Optional) Manually call the stored procedure to create the 
-- vertical filtering view. Since the type is 'logbased', 
-- this stored procedures is executed automatically.
EXEC sp_articleview 
    @publication = @publication, 
    @article = @table,
    @filter_clause = @filterclause;
GO

참고 항목

참조

sp_articlecolumn(Transact-SQL)
sp_articlefilter(Transact-SQL)
sp_articleview(Transact-SQL)
sp_changearticle(Transact-SQL)
sp_droparticle(Transact-SQL)
sp_helparticle(Transact-SQL)
sp_helparticlecolumns(Transact-SQL)
복제 저장 프로시저(Transact-SQL)

관련 자료

How to: Define an Article (Replication Transact-SQL Programming)
데이터 및 데이터베이스 개체 게시

도움말 및 정보

SQL Server 2005 지원 받기

변경 내역

릴리스 내역

2006년 4월 14일

변경된 내용
  • schema_option 매개 변수의 0x20000000 값에 대한 설명을 업데이트했습니다.

2005년 12월 5일

새로운 내용
  • schema_option 매개 변수에 대해 0x20 옵션을 설정할 때의 제한 사항을 추가했습니다.
변경된 내용
  • type 매개 변수에 지원되는 옵션에 대한 자세한 설명을 추가했습니다.
  • creation_script 매개 변수의 크기를 수정했습니다.