sp_articlecolumn(Transact-SQL)

  • 아티클

적용 대상:SQL Server

게시된 테이블의 데이터를 열 필터링하기 위해 아티클에 포함된 열을 지정하는 데 사용합니다. 이 저장 프로시저는 게시 데이터베이스의 게시자에서 실행됩니다.

Transact-SQL 구문 표기 규칙

구문

sp_articlecolumn
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    [ , [ @column = ] N'column' ]
    [ , [ @operation = ] N'operation' ]
    [ , [ @refresh_synctran_procs = ] refresh_synctran_procs ]
    [ , [ @ignore_distributor = ] ignore_distributor ]
    [ , [ @change_active = ] change_active ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @publisher = ] N'publisher' ]
    [ , [ @internal = ] internal ]
[ ; ]

인수

[ @publication = ] N'publication'

이 문서를 포함하는 게시의 이름입니다. @publication 기본값이 없는 sysname입니다.

[ @article = ] N'article'

아티클의 이름입니다. @article 기본값이 없는 sysname입니다.

[ @column = ] N'column'

추가하거나 삭제할 열의 이름입니다. @column sysname이며 기본값은 .입니다NULL. 이 경우 NULL모든 열이 게시됩니다.

[ @operation = ] N'operation'

아티클에 열을 추가하거나 삭제할지 여부를 지정합니다. @operation 기본값add인 nvarchar(5)입니다.

  • add는 복제본(replica) 열을 표시합니다.
  • drop 열의 표시를 해제합니다.

[ @refresh_synctran_procs = ] refresh_synctran_procs

즉시 업데이트 구독을 지원하는 저장 프로시저가 복제본(replica) 열 수와 일치하도록 다시 생성되는지 여부를 지정합니다. @refresh_synctran_procs 비트이며 기본값은 .입니다1. 이 경우 1저장 프로시저가 다시 생성됩니다.

[ @ignore_distributor = ] ignore_distributor

이 저장 프로시저가 배포자에 연결되지 않고 실행되는지 여부를 표시합니다. @ignore_distributor 비트이며 기본값은 .입니다0.

  • 이 경우 0데이터베이스를 게시할 수 있도록 설정해야 하며 아티클 캐시를 새로 고쳐 아티클에서 복제본(replica) 새 열을 반영해야 합니다.
  • 게시되지 않은 데이터베이스에 있는 아티클에 대해 아티클 열을 삭제할 수 있는 경우 1복구 상황에서만 사용해야 합니다.

[ @change_active = ] change_active

구독이 있는 게시의 열을 수정할 수 있습니다. @change_active 기본값0인 int입니다.

  • 이면 0열이 수정되지 않습니다.
  • 이 경우 1구독이 있는 활성 아티클에서 열을 추가하거나 삭제할 수 있습니다.

[ @force_invalidate_snapshot = ] force_invalidate_스냅샷

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

  • 0는 아티클을 변경해도 스냅샷 유효하지 않도록 지정합니다. 저장 프로시저에서 변경에 새 스냅샷 필요하다는 것을 감지하면 오류가 발생하고 변경되지 않습니다.
  • 1는 아티클을 변경하면 스냅샷 유효하지 않을 수 있으며, 새 스냅샷 필요한 기존 구독이 있는 경우 기존 스냅샷 사용되지 않는 것으로 표시되고 새 스냅샷 생성될 수 있는 권한을 부여합니다.

[ @force_reinit_subscription = ] force_reinit_subscription

이 저장 프로시저에서 수행한 작업에 기존 구독을 다시 초기화해야 할 수 있음을 인정합니다. @force_reinit_subscription 비트이며 기본값은 .입니다0.

  • 0 는 아티클을 변경해도 구독이 다시 초기화되지 않도록 지정합니다. 저장 프로시저에서 변경 내용이 구독을 다시 초기화해야 한다는 것을 감지하면 오류가 발생하고 변경되지 않습니다.
  • 1 는 아티클을 변경하면 기존 구독이 다시 초기화되고 구독 다시 초기화가 발생할 수 있는 권한을 부여하도록 지정합니다.

[ @publisher = ] N'publisher'

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

@publisher SQL Server 게시자에 사용하면 안 됩니다.

[ @internal = ] internal

정보를 제공하기 위해서만 확인됩니다. 지원 안 됨 향후 호환성은 보장되지 않습니다.

반환 코드 값

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

설명

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

을 사용하여 sp_articlecolumn구독되지 않은 아티클만 필터링할 수 있습니다.

예제

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_articlecolumn수 있습니다.

관련 콘텐츠