병합 아티클에 대한 매개 변수가 있는 행 필터 정의 및 수정
적용 대상:SQL Server
이 항목에서는 SQL Server Management Studio 또는 Transact-SQL을 사용하여 SQL Server에서 매개 변수가 있는 행 필터를 정의하고 수정하는 방법을 설명합니다.
테이블 아티클을 만들 때 매개 변수가 있는 행 필터를 사용할 수 있습니다. 이러한 필터는 WHERE 절을 사용하여 게시할 적절한 데이터를 선택합니다. 정적 행 필터와는 달리 해당 절에 리터럴 값을 지정하는 대신 SUSER_SNAME 및 HOST_NAME시스템 함수를 하나 또는 둘 모두 지정합니다. 자세한 내용은 매개 변수가 있는 행 필터를 참조하십시오.
항목 내용
시작하기 전 주의 사항:
다음을 사용하여 매개 변수가 있는 행 필터를 정의하고 수정하려면
시작하기 전에
제한 사항
- 게시에 대한 구독이 초기화된 후 매개 변수가 있는 행 필터를 추가, 수정 또는 삭제하는 경우 새 스냅샷 생성하고 변경한 후 모든 구독을 다시 초기화해야 합니다. 속성 변경 요구 사항에 대한 자세한 내용은 게시 및 아티클 속성 변경을 참조 하세요.
권장 사항
- 성능상의 이유로 다음과 같이
LEFT([MyColumn]) = SUSER_SNAME()
매개 변수가 있는 행 필터 절의 열 이름에 함수를 적용하지 않는 것이 좋습니다. 필터 절에서 HOST_NAME 사용하고 HOST_NAME 값을 재정의하는 경우 CONVERT를 사용하여 데이터 형식을 변환해야 할 수 있습니다. 이를 위한 최선의 구현 방법은 Parameterized Row Filters항목의 "HOST_NAME() 값 재정의" 섹션을 참조하십시오.
SQL Server Management Studio 사용
새 게시 마법사의 테이블 행 필터 페이지 또는 게시 속성 - <게시> 대화 상자의 행 필터 페이지에서 매개 변수가 있는 행 필터를 정의, 수정 및 삭제합니다. 마법사 사용 및 대화 상자 액세스에 대한 자세한 내용은 게시 만들기 및 게시 속성 보기 및 수정을 참조하세요.
매개 변수가 있는 행 필터를 정의하려면
새 게시 마법사의 테이블 행 필터 페이지 또는 게시 속성 ->< 게시의 행 필터 페이지에서 추가를 클릭한 다음 필터 추가를 클릭합니다.
필터 추가 대화 상자의 드롭다운 목록 상자에서 필터링할 테이블을 선택합니다.
필터 문 텍스트 상자에 필터 문을 만듭니다. 텍스트 영역에 직접 입력할 수 있으며 열 목록 상자에서 열을 끌어서 놓을 수도 있습니다.
필터 문 텍스트 영역에는 다음 형식의 기본 텍스트가 포함됩니다.
SELECT <published_columns> FROM [tableowner].[tablename] WHERE
기본 텍스트는 변경할 수 없습니다. 표준 SQL 구문을 사용하여 WHERE 키워드(keyword) 뒤의 필터 절을 입력합니다. 매개 변수가 있는 필터에는 시스템 함수 HOST_NAME() 및/또는 SUSER_SNAME()에 대한 호출 또는 이러한 함수 중 하나 또는 둘 다를 참조하는 사용자 정의 함수가 포함됩니다. 다음은 매개 변수가 있는 행 필터에 대한 전체 필터 절의 예입니다.
SELECT <published_columns> FROM [HumanResources].[Employee] WHERE LoginID = SUSER_SNAME()
WHERE 절은 두 부분으로 된 명명을 사용해야 합니다. 3부로 구성된 명명 및 4부로 구성된 명명은 지원되지 않습니다.
구독자 간에 데이터를 공유하는 방법과 일치하는 옵션을 선택합니다.
이 테이블의 행은 여러 구독으로 이동합니다.
이 테이블의 행은 하나의 구독으로만 이동합니다.
이 테이블에서 행을 선택하면 하나의 구독으로만 이동됩니다. 병합 복제본(replica)tion은 더 적은 메타데이터를 저장하고 처리하여 성능을 최적화할 수 있습니다. 그러나 한 행이 둘 이상의 구독자로 복제될 수 없도록 데이터가 분할되어야 합니다. 자세한 내용은 매개 변수가 있는 행 필터 항목 의 "파티션 옵션 설정" 섹션을 참조하세요.
확인을 선택합니다.
게시 속성 - <게시> 대화 상자에 있는 경우 [확인]을 클릭하여 대화 상자를 저장하고 닫습니다.
매개 변수가 있는 행 필터를 수정하려면
새 게시 마법사의 테이블 행 필터 페이지 또는 게시 속성 - <게시>의 행 필터 페이지에서 필터링된 테이블 창에서 필터를 선택한 다음 편집을 클릭합니다.
필터 편집 대화 상자에서 필터를 수정합니다.
확인을 선택합니다.
매개 변수가 있는 행 필터를 삭제하려면
- 새 게시 마법사의 테이블 행 필터 페이지 또는 게시 속성 - <게시>의 행 필터 페이지에서 필터링된 테이블 창에서 필터를 선택한 다음 삭제를 클릭합니다.
Transact-SQL 사용
복제 저장 프로시저를 사용하여 매개 변수가 있는 행 필터를 프로그래밍 방식으로 만들거나 수정할 수 있습니다.
병합 게시의 아티클에 대한 매개 변수가 있는 행 필터를 정의하려면
게시 데이터베이스의 게시자에서 sp_addmergearticle(Transact-SQL)를 실행합니다. @publication, @article 아티클의 이름, @source_object 대해 게시되는 테이블, @subset_filterclause 매개 변수가 있는 필터를 정의하는 WHERE 절(포함
WHERE
안 함) 및 매개 변수가 있는 행 필터에서 발생하는 분할 유형을 설명하는 @partition_options 다음 값 중 하나를 지정합니다.0 - 아티클에 대한 필터링은 정적이거나 각 파티션에 대한 고유한 데이터 하위 집합("겹치는" 파티션)을 생성하지 않습니다.
1 - 결과 파티션이 겹치며 구독자에 변경된 내용이 있어도 행이 속한 파티션이 변경되지 않습니다.
2 - 아티클에 대한 필터링은 오버랩되지 않는 파티션을 생성하지만 여러 구독자는 동일한 파티션을 받을 수 있습니다.
3 - 아티클에 대한 필터링은 각 구독에 대해 고유한 매핑되지 않는 파티션을 생성합니다.
병합 게시에서 아티클에 대한 매개 변수가 있는 행 필터를 변경하려면
게시 데이터베이스의 게시자에서 sp_changemergearticle을 실행합니다. @publication, @article, @property subset_filterclause값, @value 매개 변수가 있는 필터를 정의하는 식(포함
WHERE
안 함), @force_invalidate_스냅샷 및 @force_reinit_subscription 모두에 대해 1 값을 지정합니다.이 변경으로 인해 다른 분할 동작이 발생하는 경우 sp_changemergearticle 다시 실행합니다. @publication, @article, @property partition_options 값 및 @value 가장 적합한 분할 옵션을 지정합니다. 이 옵션은 다음 중 하나일 수 있습니다.
0 - 아티클에 대한 필터링은 정적이거나 각 파티션에 대한 고유한 데이터 하위 집합("겹치는" 파티션)을 생성하지 않습니다.
1 - 결과 파티션이 겹치며 구독자에 변경된 내용이 있어도 행이 속한 파티션이 변경되지 않습니다.
2 - 아티클에 대한 필터링은 오버랩되지 않는 파티션을 생성하지만 여러 구독자는 동일한 파티션을 받을 수 있습니다.
3 - 아티클에 대한 필터링은 각 구독에 대해 고유한 매핑되지 않는 파티션을 생성합니다.
예제(Transact-SQL)
다음 예에서는 병합 게시의 아티클 그룹을 정의합니다. 이 병합 게시에서는 Employee
LoginID 열을 기준으로 매개 변수가 있는 행 필터를 사용하여 자체 필터링되는 테이블에 대해 일련의 조인 필터로 아티클이 필터링됩니다. 동기화하는 동안 HOST_NAME 함수에서 반환된 값이 재정의됩니다. 자세한 내용은 매개 변수가 있는 행 필터 항목 에서 HOST_NAME() 값 재정의를 참조하세요.
-- To avoid storing the login and password in the script file, the value
-- is passed into SQLCMD as a scripting variable. For information about
-- how to use scripting variables on the command line and in SQL Server
-- Management Studio, see the "Executing Replication Scripts" section in
-- the topic "Programming Replication Using System Stored Procedures".
--Add a new merge publication.
DECLARE @publicationdb AS sysname;
DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @filter AS sysname;
DECLARE @schema_hr AS sysname;
DECLARE @schema_sales AS sysname;
SET @publicationdb = N'AdventureWorks2022';
SET @publication = N'AdvWorksSalesPersonMerge';
SET @table1 = N'Employee';
SET @table2 = N'SalesPerson';
SET @filter = N'SalesPerson_Employee';
SET @schema_hr = N'HumanResources';
SET @schema_sales = N'Sales';
USE [AdventureWorks2022];
-- Enable AdventureWorks2022 for merge replication.
EXEC sp_replicationdboption
@dbname = @publicationdb,
@optname = N'merge publish',
@value = N'true';
-- Create new merge publication with Subscriber requested snapshot
-- and using the default agent schedule.
EXEC sp_addmergepublication
@publication = @publication,
@description = N'Merge publication of AdventureWorks2022.',
@allow_subscriber_initiated_snapshot = N'true',
@publication_compatibility_level = N'90RTM';
-- Create a new snapshot job for the publication, using the default schedule.
-- Pass credentials at runtime using sqlcmd scripting variables.
EXEC sp_addpublication_snapshot
@publication = @publication,
@job_login = $(login),
@job_password = $(password);
-- Add an article for the Employee table,
-- which is horizontally partitioned using
-- a parameterized row filter.
EXEC sp_addmergearticle
@publication = @publication,
@article = @table1,
@source_owner = @schema_hr,
@source_object = @table1,
@type = N'table',
@description = 'contains employee information',
@subset_filterclause = N'[LoginID] = HOST_NAME()';
-- Add an article for the SalesPerson table,
-- which is partitioned based on a join filter.
EXEC sp_addmergearticle
@publication = @publication,
@article = @table2,
@source_owner = @schema_sales,
@source_object = @table2,
@type = N'table',
@description = 'contains salesperson information';
-- Add a join filter between the two articles.
EXEC sp_addmergefilter
@publication = @publication,
@article = @table1,
@filtername = @filter,
@join_articlename = @table2,
@join_filterclause = N'[Employee].[BusinessEntityID] = [SalesPerson].[SalesPersonID]',
@join_unique_key = 1,
@filter_type = 1;
GO
-- Start the agent job to generate the full snapshot for the publication.
-- The filtered data snapshot is generated automatically the first time
-- the subscription is synchronized.
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesPersonMerge';
EXEC sp_startpublication_snapshot
@publication = @publication;
GO
참고 항목
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기