sp_addarticle(Transact-SQL)

적용 대상:SQL ServerAzure SQL Managed Instance

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

Transact-SQL 구문 표기 규칙

구문

sp_addarticle
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    [ , [ @source_table = ] N'source_table' ]
    [ , [ @destination_table = ] N'destination_table' ]
    [ , [ @vertical_partition = ] N'vertical_partition' ]
    [ , [ @type = ] N'type' ]
    [ , [ @filter = ] N'filter' ]
    [ , [ @sync_object = ] N'sync_object' ]
    [ , [ @ins_cmd = ] N'ins_cmd' ]
    [ , [ @del_cmd = ] N'del_cmd' ]
    [ , [ @upd_cmd = ] N'upd_cmd' ]
    [ , [ @creation_script = ] N'creation_script' ]
    [ , [ @description = ] N'description' ]
    [ , [ @pre_creation_cmd = ] N'pre_creation_cmd' ]
    [ , [ @filter_clause = ] N'filter_clause' ]
    [ , [ @schema_option = ] schema_option ]
    [ , [ @destination_owner = ] N'destination_owner' ]
    [ , [ @status = ] status ]
    [ , [ @source_owner = ] N'source_owner' ]
    [ , [ @sync_object_owner = ] N'sync_object_owner' ]
    [ , [ @filter_owner = ] N'filter_owner' ]
    [ , [ @source_object = ] N'source_object' ]
    [ , [ @artid = ] artid OUTPUT ]
    [ , [ @auto_identity_range = ] N'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 = ] N'identityrangemanagementoption' ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @fire_triggers_on_snapshot = ] N'fire_triggers_on_snapshot' ]
[ ; ]

인수

[ @publication = ] N'publication'

아티클을 포함하는 게시의 이름입니다. 이 이름은 데이터베이스에서 고유해야 합니다. @publication 기본값이 없는 sysname입니다.

[ @article = ] N'article'

아티클의 이름입니다. 이름은 게시 내에서 고유해야 합니다. @article 기본값이 없는 sysname입니다.

[ @source_table = ] N'source_table'

이 매개 변수는 더 이상 사용되지 않습니다. 대신 @source_object 사용합니다. @source_table 기본값NULL인 nvarchar(386)입니다. @source_table Oracle 게시자에 대해서는 지원되지 않습니다.

[ @destination_table = ] N'destination_table'

대상(구독) 테이블의 이름(@source_table 또는 저장 프로시저와 다른 경우)입니다. @destination_table sysname이며 기본값은 .입니다NULL. 이 값으로 NULL설정하면 @source_table @destination_table 같습니다.

[ @vertical_partition = ] N'vertical_partition'

테이블 아티클에서 열 필터링을 사용하거나 사용하지 않도록 설정합니다. @vertical_partition 기본값false인 nchar(5)입니다.

• false 는 세로 필터링이 없음을 나타내고 모든 열을 게시합니다.

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

[ @type = ] N'type'

아티클의 형식입니다. @type 기본값NULL인 sysname이며 다음 값 중 하나일 수 있습니다.

[ @filter = ] N'filter'

테이블을 가로로 필터링하는 데 사용되는 저장 프로시저(FOR REPLICATION을 사용하여 생성됨)입니다. @filter 기본값NULL인 nvarchar(386)입니다. sp_articleview실행하고 수동으로 sp_articlefilter 뷰를 만들고 저장 프로시저를 필터링해야 합니다. 그렇지 않은 NULL경우 필터 프로시저가 만들어지지 않습니다(저장 프로시저가 수동으로 만들어진 것으로 가정).

[ @sync_object = ] N'sync_object'

이 문서의 스냅샷 나타내는 데 사용되는 데이터 파일을 생성하는 데 사용되는 테이블 또는 뷰의 이름입니다. @sync_object 기본값NULL인 nvarchar(386)입니다. 이면 NULL출력 파일을 생성하는 데 사용되는 뷰를 자동으로 만들기 위해 sp_articleview 호출됩니다. 이 문제는 sp_articlecolumn 있는 열을 추가한 후에 발생합니다. 그렇지 않은 NULL경우 뷰가 만들어지지 않습니다(보기가 수동으로 만들어진 것으로 가정).

[ @ins_cmd = ] N'ins_cmd'

이 문서의 삽입을 복제본(replica) 때 사용되는 복제본(replica)tion 명령 유형입니다. @ins_cmd nvarchar(255)이며 다음 값 중 하나일 수 있습니다.

자세한 내용은 트랜잭션 아티클을 참조 하세요. 변경 내용을 전파하는 방법을 지정합니다.

[ @del_cmd = ] N'del_cmd'

이 문서에 대한 삭제를 복제본(replica) 때 사용되는 복제본(replica)tion 명령 유형입니다. @del_cmd nvarchar(255)이며 다음 값 중 하나일 수 있습니다.

자세한 내용은 트랜잭션 아티클을 참조 하세요. 변경 내용을 전파하는 방법을 지정합니다.

[ @upd_cmd = ] N'upd_cmd'

이 문서의 업데이트를 복제본(replica) 때 사용되는 복제본(replica)tion 명령 유형입니다. @upd_cmd nvarchar(255)이며 다음 값 중 하나일 수 있습니다.

[ @creation_script = ] N'creation_script'

구독 데이터베이스에서 아티클을 만드는 데 사용되는 선택적 아티클 스키마 스크립트의 경로 및 이름입니다. @creation_script 기본값NULL인 nvarchar(255)입니다.

[ @description = ] N'description'

아티클에 대한 설명 항목입니다. @description 기본값NULL인 nvarchar(255)입니다.

[ @pre_creation_cmd = ] N'pre_creation_cmd'

해당 아티클에 대한 스냅샷을 적용할 때 구독자에서 같은 이름의 기존 개체가 검색될 경우 시스템이 할 일을 지정합니다. @pre_creation_cmd nvarchar(10)이며 다음 값 중 하나일 수 있습니다.

[ @filter_clause = ] N'filter_clause'

가로 필터를 정의하는 제한(WHERE) 절입니다. 제한 절을 입력할 때 키워드(keyword) WHERE를 생략합니다. @filter_clause 기본값NULL인 nvarchar(max)입니다. 자세한 내용은 게시된 데이터 필터링을 참조 하세요.

[ @schema_option = ] schema_option

지정된 아티클에 대한 스키마 생성 옵션의 비트 마스크입니다. @schema_option 기본값NULL인 varbinary(8)이며 | (비트 OR) 은 다음 값 중 하나 이상의 제품입니다.

¹ Oracle 게시자에 대해서는 지원되지 않습니다.

모든 @schema_option 값이 모든 유형의 복제본(replica) 및 아티클 형식에 유효하지는 않습니다. 주의 섹션의 유효한 스키마 옵션 테이블에는 아티클 형식과 복제본(replica)tion 형식의 조합에 따라 선택할 수 있는 유효한 스키마 옵션이 표시됩니다.

[ @destination_owner = ] N'destination_owner'

대상 개체의 소유자 이름입니다. @destination_owner sysname이며 기본값은 .입니다NULL. @destination_owner 지정되지 않은 경우 소유자는 다음 규칙에 따라 자동으로 지정됩니다.

SQL Server 이외 구독자를 지원하려면 @destination_owner .NULL

[ @status = ] 상태

아티클이 활성 상태인지와 변경 내용이 전파되는 방법에 대한 추가 옵션을 지정합니다. @상태tinyint이며 | 일 수 있습니다. (비트 OR) 이러한 값 중 하나 이상의 을 반환합니다.

예를 들어 매개 변수가 있는 문을 사용하는 활성 아티클의 값 17 은 이 열에 있습니다. 값 0 은 아티클이 비활성 상태이고 추가 속성이 정의되지 않음을 의미합니다.

[ @source_owner = ] N'source_owner'

원본 개체의 소유자입니다. @source_owner sysname이며 기본값은 .입니다NULL. Oracle 게시자에 대해 @source_owner 지정해야 합니다.

[ @sync_object_owner = ] N'sync_object_owner'

게시된 아티클을 정의하는 뷰의 소유자입니다. @sync_object_owner sysname이며 기본값은 .입니다NULL.

[ @filter_owner = ] N'filter_owner'

필터의 소유자입니다. @filter_owner sysname이며 기본값은 .입니다NULL.

[ @source_object = ] N'source_object'

게시할 데이터베이스 개체입니다. @source_object sysname이며 기본값은 .입니다NULL. @source_table NULL 경우 @source_object 수 NULL없습니다. @source_object @source_table 대신 사용해야 합니다. 스냅샷 또는 트랜잭션 복제본(replica)tion을 사용하여 게시할 수 있는 개체 유형에 대한 자세한 내용은 데이터 및 데이터베이스 개체 게시를 참조하세요.

[ @artid = ] artid OUTPUT

새 문서의 문서 ID입니다. @artid int 형식의 OUTPUT 매개 변수입니다.

[ @auto_identity_range = ] N'auto_identity_range'

게시를 만들 때 게시에서 자동 ID 범위 처리를 사용하거나 사용하지 않도록 설정합니다. @auto_identity_range nvarchar(5)이며 다음 값 중 하나일 수 있습니다.

[ @pub_identity_range = ] pub_identity_range

아티클이 자동 또는 @auto_identity_range true로 설정된 @identityrangemanagementoption 경우 Publisher에서 범위 크기를 제어합니다. @pub_identity_range 기본값NULL인 bigint입니다. @pub_identity_range Oracle 게시자에 대해서는 지원되지 않습니다.

[ @identity_range = ] identity_range

아티클이 자동 또는 @auto_identity_range true로 설정된 @identityrangemanagementoption 경우 구독자에서 범위 크기를 제어합니다. @identity_range 기본값NULL인 bigint입니다. @auto_identity_range true로 설정된 경우 사용됩니다. @identity_range Oracle 게시자에 대해 지원되지 않습니다.

[ @threshold = ] 임계값

배포 에이전트 새 ID 범위를 할당하는 시기를 제어하는 백분율 값입니다. @threshold 지정된 값의 백분율을 사용하면 배포 에이전트 새 ID 범위를 만듭니다. @threshold 기본값NULL인 int입니다. @identityrangemanagementoption 자동으로 설정되거나 @auto_identity_range true로 설정된 경우에 사용됩니다. @threshold Oracle 게시자에 대해서는 지원되지 않습니다.

[ @force_invalidate_snapshot = ] force_invalidate_스냅샷

이 저장 프로시저에서 수행한 작업이 기존 스냅샷 무효화할 수 있음을 인정합니다. @force_invalidate_스냅샷 비트이며 기본값은 .입니다0.

• 0는 아티클을 추가해도 스냅샷 유효하지 않습니다. 저장 프로시저에서 변경에 새 스냅샷 필요하다는 것을 감지하면 오류가 발생하고 변경되지 않습니다.

• 1는 아티클을 추가하면 스냅샷 유효하지 않을 수 있으며 새 스냅샷 필요한 구독이 있는 경우 기존 스냅샷 사용되지 않는 것으로 표시되고 새 스냅샷 생성될 수 있는 권한을 부여합니다.

[ @use_default_datatypes = ] use_default_datatypes

Oracle 게시자에서 아티클을 게시할 때 기본 열 데이터 형식 매핑이 사용되는지 여부입니다. @use_default_datatypes 비트이며 기본값은 .입니다1.

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

• 0 = 사용자 지정 아티클 열 매핑이 정의 되므로 sp_articleview 호출 sp_addarticle되지 않습니다.

@use_default_datatypes 설정0되면 기본값에서 변경되는 각 열 매핑에 대해 sp_changearticlecolumndatatype 한 번 실행해야 합니다. 모든 사용자 지정 열 매핑이 정의되면 sp_articleview 실행해야 합니다.

[ @identityrangemanagementoption = ] N'identityrangemanagementoption'

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

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

자세한 내용은 ID 열 복제를 참조하세요.

[ @publisher = ] N'publisher'

SQL Server 이외 게시자를 지정합니다. @publisher sysname이며 기본값은 .입니다NULL.

SQL Server 게시자에 아티클을 추가할 때는 @publisher 사용하면 안 됩니다.

[ @fire_triggers_on_snapshot = ] N'fire_triggers_on_스냅샷'

초기 스냅샷 적용될 때 복제본(replica)ted 사용자 트리거가 실행되는 경우 @fire_triggers_on_스냅샷 기본값false인 nvarchar(5)입니다. true는 스냅샷 적용될 때 복제본(replica)ted 테이블의 사용자 트리거가 실행됨을 의미합니다. 트리거를 복제본(replica) 위해 @schema_option 비트 마스크 값에 값0x100이 포함되어야 합니다.

반환 코드 값

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

설명

sp_addarticle는 스냅샷 복제본(replica)tion 또는 트랜잭션 복제본(replica)에 사용됩니다.

기본적으로 복제본(replica)tion은 열 데이터 형식이 복제본(replica) 지원되지 않는 경우 원본 테이블에 열을 게시하지 않습니다. 이러한 열을 게시해야 하는 경우 sp_articlecolumn 실행하여 열을 추가해야 합니다.

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

• 모든 로그 기반 아티클에 대해 매개 변수가 있는 문을 지정해야 합니다. @상태 값에 포함 16 해야 합니다.

• 대상 테이블의 이름과 소유자는 원본 테이블과 일치해야 합니다.

• 아티클을 가로 또는 세로로 필터링할 수 없습니다.

• 자동 ID 범위 관리는 지원되지 않습니다. @identityrangemanagementoption 수동 값을 지정해야 합니다.

• 테이블에 타임스탬프 열이 있는 경우 열을 타임스탬프로 복제본(replica) @schema_option 0x08 포함해야 합니다.

• 값은 SQL @ins_cmd, @upd_cmd 및 @del_cmd 지정할 수 없습니다.

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

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

@vertical_partition true로 설정된 경우 마지막sp_articlecolumn 추가된 후 sp_articleview 호출될 때까지 뷰 만들기를 연기합니다.sp_addarticle

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

SQL Server의 인스턴스가 아닌 구독자에게 복제본(replica) 때(다른 유형의 복제본(replica)tion) Transact-SQL 문만 , UPDATE및 DELETE 명령에 대해 INSERT지원됩니다.

로그 판독기 에이전트가 실행 중인 경우 피어 투 피어 게시에 아티클을 추가하면 로그 판독기 에이전트와 아티클을 추가하는 프로세스 간에 교착 상태가 발생할 수 있습니다. 이 문제를 방지하려면 피어 투 피어 게시에 아티클을 추가하기 전에 복제 모니터를 사용하여 아티클을 추가하는 노드에서 로그 판독기 에이전트를 중지합니다. 문서를 추가한 후 로그 판독기 에이전트를 다시 시작합니다.

@del_cmd 설정하거나 @ins_cmdNONENONE경우 제한된 업데이트가 발생할 때 명령 전파 UPDATE 가 해당 명령을 보내지 않아 영향을 받을 수도 있습니다. (제한된 업데이트는 구독자에서 쌍으로 DELETE/INSERT 복제본(replica) 게시자의 문 유형 UPDATE 입니다.)

기본 스키마 옵션

이 표에서는 사용자가 @schema_options 지정하지 않은 경우 복제본(replica)tion에서 설정한 기본값을 설명합니다. 여기서 이 값은 복제본(replica)tion 유형(위쪽에 표시됨)과 아티클 형식(첫 번째 열에 표시됨)에 따라 달라집니다.

유효한 스키마 옵션

이 표에서는 복제본(replica)tion 형식(위쪽에 표시됨)과 아티클 형식(첫 번째 열에 표시됨)을 기반으로 @schema_option 허용 가능한 값을 설명합니다.

예제

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

사용 권한

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

관련 콘텐츠

• 아티클 정의
• 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)
• 데이터 및 데이터베이스 개체 게시