sp_articlefilter(Transact-SQL)

아티클
05/07/2013

테이블 아티클을 기준으로 게시할 데이터를 필터링합니다. 이 저장 프로시저는 게시 데이터베이스의 게시자에서 실행됩니다.

구문

sp_articlefilter [ @publication = ] 'publication' 
        , [ @article = ] 'article'
    [ , [ @filter_name = ] 'filter_name' ]
    [ , [ @filter_clause = ] 'filter_clause' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
    [ , [ @publisher = ] 'publisher' ]

인수

[ @publication=] 'publication'
아티클을 포함하는 게시의 이름입니다. publication는 sysname이며 기본값은 없습니다.
[ @article=] 'article'
아티클의 이름입니다. article는 sysname이며 기본값은 없습니다.
[ @filter_name=] 'filter_name'
filter_name에서 만들 필터 저장 프로시저의 이름입니다. filter_name은 **nvarchar(386)**이며 기본값은 NULL입니다. 고유한 아티클 필터의 이름을 지정해야 합니다.
[ @filter_clause=] 'filter_clause'
행 필터를 정의하는 제한(WHERE) 절입니다. 제약 조건 절을 입력할 때는 키워드인 WHERE를 생략합니다. filter_clause는 ntext이며 기본값은 NULL입니다.
[ @force_invalidate_snapshot = ] force_invalidate_snapshot
이 저장 프로시저가 수행한 동작으로 인해 기존 스냅숏이 무효화될 수도 있습니다. force_invalidate_snapshot은 bit이며 기본값은 0입니다.

0은 아티클에 대한 변경으로 인해 스냅숏이 무효화되지 않도록 지정합니다. 저장 프로시저가 새 스냅숏을 필요로 하는 변경을 감지하면 오류가 발생하며 변경이 수행되지 않습니다.

1은 아티클의 변경이 스냅숏을 무효화함을 의미하며 기존 구독에서 새 스냅숏을 필요로 하는 경우 기존 스냅숏을 오래되어 사용하지 않음으로 표시하고 새 스냅숏을 생성할 권한을 부여합니다.
[ @force_reinit_subscription = ] force_reinit_subscription
이 저장 프로시저가 수행한 동작으로 인해 기존 구독을 다시 초기화해야 할 수도 있습니다. force_reinit_subscription은 bit이며 기본값은 0입니다.

0은 아티클에 대한 변경으로 인해 구독이 다시 초기화되지 않도록 지정합니다. 저장 프로시저가 구독을 다시 초기화할 필요가 있는 변경을 감지하면 오류가 발생하며 변경이 수행되지 않습니다.

1은 아티클에 대한 변경으로 인해 기존 구독이 다시 초기화되도록 지정하며 구독을 다시 초기화할 수 있는 권한을 부여합니다.
[ @publisher= ] 'publisher'
Microsoft SQL Server 이외의 게시자를 지정합니다. publisher는 sysname이며 기본값은 NULL입니다.

[!참고]

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

반환 코드 값

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

주의

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

기존 구독이 있는 아티클에 대해 sp_articlefilter를 실행하려면 해당 구독을 다시 초기화해야 합니다.

sp_articlefilter는 필터를 만들고 sysarticles(Transact-SQL) 테이블에 있는 filter 열에 필터 저장 프로시저의 ID를 삽입하며 filter_clause 열에 제약 조건 절의 텍스트를 삽입합니다.

행 필터링으로 아티클을 만들려면 filter 매개 변수 없이 sp_addarticle(Transact-SQL)을 실행합니다. filter_clause를 포함한 모든 매개 변수를 제공하여 sp_articlefilter를 실행하고, 동일한 filter_clause를 포함한 모든 매개 변수를 제공하여 sp_articleview(Transact-SQL)를 실행합니다. 필터가 이미 있으며 sysarticles의 type이 1(로그 기반 아티클)이면 이전 필터가 삭제되고 새 필터가 작성됩니다.

filter_name 및 filter_clause를 제공하지 않은 경우에는 이전 필터가 삭제되고 필터 ID가 0으로 설정됩니다.

예

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