매개 변수가 있는 필터로 병합 게시에 대한 스냅숏 만들기Create a Snapshot for a Merge Publication with Parameterized Filters

이 항목에서는 SQL Server 2017SQL Server 2017 , SQL Server Management StudioSQL Server Management Studio또는 RMO(복제 관리 개체)를 사용하여 Transact-SQLTransact-SQL에서 매개 변수가 있는 필터로 병합 게시에 대한 스냅숏을 만드는 방법에 대해 설명합니다.This topic describes how to create a snapshot for a merge publication with parameterized filters in SQL Server 2017SQL Server 2017 by using SQL Server Management StudioSQL Server Management Studio, Transact-SQLTransact-SQL, or Replication Management Objects (RMO).

항목 내용In This Topic

시작하기 전 주의 사항 Before You Begin

권장 사항 Recommendations

  • 매개 변수가 있는 필터를 사용하여 병합 게시에 대한 스냅숏을 만들 때는 게시된 데이터 및 구독에 대한 구독자 메타데이터를 모두 포함하는 표준(스키마) 스냅숏을 먼저 생성해야 합니다.When generating a snapshot for a merge publication using parameterized filters, you must first generate a standard (schema) snapshot that contains all of the published data and Subscriber metadata for the subscription. 자세한 내용은 초기 스냅숏 만들기 및 적용을 참조하세요.For more information, see Create and Apply the Initial Snapshot. 스키마 스냅숏을 만든 다음에는 게시된 데이터의 구독자별 파티션을 포함하는 스냅숏을 만들 수 있습니다.After you have created the schema snapshot, you can generate the snapshot that contains the Subscriber-specific partition of the published data.

  • 게시에 있는 여러 아티클에 대한 필터링 시 각 구독에 고유하면서도 겹치지 않는 파티션이 생성될 경우 메타데이터는 병합 에이전트가 실행될 때마다 정리됩니다.If the filtering for one or more articles in the publication yields non-overlapping partitions that are unique for each subscription, metadata is cleaned up whenever the Merge Agent runs. 따라서 분할된 스냅숏은 더 빨리 만료됩니다.This means that the partitioned snapshot expires more quickly. 이 옵션을 사용할 경우 구독자가 스냅숏 생성 및 배달을 시작하도록 허용하는 것을 고려해야 합니다.When using this option, you should consider allowing Subscribers to initiate snapshot generation and delivery. 필터링 옵션에 대한 자세한 내용은 매개 변수가 있는 필터를 사용하는 병합 게시의 스냅숏에서 "'partition options' 설정" 섹션을 참조하세요.For more information about filtering options, see the "Setting 'partition options'" section of Snapshots for Merge Publications with Parameterized Filters.

SQL Server Management Studio 사용 Using SQL Server Management Studio

게시 속성 - <게시> 대화 상자의 데이터 파티션 페이지에서 파티션에 대한 스냅숏을 생성합니다.Generate snapshots for partitions on the Data Partitions page of the Publication Properties - <Publication> dialog box. 이 대화 상자에 액세스하는 방법은 게시 속성 보기 및 수정을 참조하세요.For more information about accessing this dialog box, see View and Modify Publication Properties. 구독자가 스냅숏 생성 및 배달을 시작하고 스냅숏을 생성하도록 허용할 수 있습니다.You can allow Subscribers to initiate snapshot generation and delivery and/or generate snapshots.

하나 이상의 파티션에 대한 스냅숏을 생성하기 전에 다음을 수행해야 합니다.Before generating snapshots for one or more partitions, you must:

  1. 새 게시 마법사를 사용하여 병합 게시를 만들고 마법사의 필터 추가 페이지에서 매개 변수가 있는 행 필터를 하나 이상 지정합니다.Create a merge publication with the New Publication Wizard, and specify one or more parameterized row filters on the Add Filter page of the wizard. 자세한 내용은 병합 아티클에 대한 매개 변수가 있는 행 필터 정의 및 수정을 참조하세요.For more information, see Define and Modify a Parameterized Row Filter for a Merge Article.

  2. 게시에 대한 스키마 스냅숏을 생성합니다.Generate a schema snapshot for the publication. 기본적으로 스키마 스냅숏은 새 게시 마법사를 완료할 때 생성됩니다. SQL Server Management StudioSQL Server Management Studio에서 스키마 스냅숏을 생성할 수도 있습니다.By default, a schema snapshot is generated when you complete the New Publication Wizard; you can also generate a schema snapshot from SQL Server Management StudioSQL Server Management Studio.

스키마 스냅숏을 생성하려면To generate a schema snapshot

  1. Management StudioManagement Studio에서 게시자에 연결한 다음 해당 서버 노드를 확장합니다.Connect to the Publisher in Management StudioManagement Studio, and then expand the server node.

  2. 복제 폴더를 확장한 다음 게시 폴더를 확장합니다.Expand the Replication folder, and then expand the Publications folder.

  3. 스냅숏을 생성할 게시를 마우스 오른쪽 단추로 클릭한 다음 스냅숏 에이전트 상태 보기를 클릭합니다.Right-click the publication for which you want to create a snapshot, and then click View Snapshot Agent Status.

  4. 스냅숏 에이전트 상태 보기 - <게시> 대화 상자에서 시작을 클릭합니다.In the View Snapshot Agent Status - <Publication> dialog box, click Start.

    스냅숏 에이전트에서 스냅숏 생성을 마치면 "[100%] 17개 아티클의 스냅숏이 생성되었습니다"라는 메시지가 표시됩니다.When the Snapshot Agent finishes generating the snapshot, a message will be displayed, such as "[100%] A snapshot of 17 article(s) was generated."

구독자가 스냅숏 생성 및 배달을 시작하도록 허용하려면To allow Subscribers to initiate snapshot generation and delivery

  1. 게시 속성 - <게시> 대화 상자의 데이터 파티션 페이지에서 새 구독자가 동기화할 때 필요한 경우 자동으로 파티션 정의 및 스냅숏 생성을 선택합니다.On the Data Partitions page of the Publication Properties - <Publication> dialog box, select Automatically define a partition and generate a snapshot if needed when a new Subscriber tries to synchronize.

  2. 확인을 클릭합니다.Click OK.

스냅숏을 생성하고 새로 고치려면To generate and refresh snapshots

  1. 게시 속성 - <게시> 대화 상자의 데이터 파티션 페이지에서 추가를 클릭합니다.On the Data Partitions page of the Publication Properties - <Publication> dialog box, click Add.

  2. 스냅숏을 만들 파티션과 연결된 HOST_NAME() 및/또는 SUSER_SNAME() 값을 입력합니다.Enter a value for the HOST_NAME() and/or SUSER_SNAME() value associated with the partition for which you want to create a snapshot.

  3. 선택적으로 스냅숏을 새로 고칠 일정을 지정합니다.Optionally specify a schedule for refreshing snapshots:

    1. 이 파티션에 대한 스냅숏 에이전트의 실행 시간을 다음 시간으로 예약을 선택합니다.Select Schedule the Snapshot Agent for this partition to run at the following time(s)

    2. 기본으로 제공되는 스냅숏 새로 고침 일정을 그대로 적용하거나 변경 을 클릭하여 다른 일정을 지정합니다.Accept the default schedule for refreshing snapshots, or click Change to specify a different schedule.

  4. 확인을 클릭합니다. 그러면 게시 속성 - <게시> 대화 상자로 돌아갑니다.Click OK, which returns you to the Publication Properties - <Publication> dialog box.

  5. 속성 표에서 파티션을 선택한 다음 선택한 스냅숏 지금 생성을 클릭합니다.Select the partition in the property grid, and then click Generate the selected snapshots now.

  6. 확인을 클릭합니다.Click OK.

Transact-SQL 사용 Using Transact-SQL

저장 프로시저 및 스냅숏 에이전트를 사용하여 다음을 수행할 수 있습니다.Using stored procedures and the Snapshot Agent, you can perform the following:

  • 구독자가 처음 동기화될 때 스냅숏 생성 및 적용을 요청하도록 허용합니다.Allow Subscribers to request snapshot generation and application the first time they synchronize.

  • 각 파티션에 대한 스냅숏을 미리 생성합니다.Pre-generate snapshots for each partition.

  • 각 구독자에 대한 스냅숏을 수동으로 생성합니다.Manually generate a snapshot for each Subscriber.

    중요

    가능한 경우 런타임 시 사용자에게 보안 자격 증명을 입력하라는 메시지가 표시됩니다.When possible, prompt users to enter security credentials at runtime. 자격 증명을 스크립트 파일에 저장해야 하는 경우에는 파일에 무단으로 액세스하지 못하도록 보안을 설정해야 합니다.If you must store credentials in a script file, you must secure the file to prevent unauthorized access.

구독자가 스냅숏 생성 및 배달을 시작하도록 허용하는 게시를 만들려면To create a publication that allows Subscribers to initiate snapshot generation and delivery

  1. 게시 데이터베이스의 게시자에서 sp_addmergepublication(Transact-SQL)을 실행합니다.At the Publisher on the publication database, execute sp_addmergepublication (Transact-SQL). 다음 매개 변수를 지정합니다.Specify the following parameters:

    • @publication에 대한 게시의 이름The name of the publication for @publication.

    • @allow_subscriber_initiated_snapshottrue 값을 지정합니다. 이렇게 하면 구독자가 스냅숏 프로세스를 시작할 수 있습니다.A value of true for @allow_subscriber_initiated_snapshot, which enables Subscribers to initiate the snapshot process.

    • (옵션) @max_concurrent_dynamic_snapshots을 참조하세요.(Optional) The number of dynamic snapshot processes that can run concurrently for @max_concurrent_dynamic_snapshots. 최대 수의 프로세스가 실행 중인 상태에서 구독자가 스냅숏 생성을 시도하면 이 프로세스는 큐에 배치됩니다.If the maximum number of processes is running and a Subscriber attempts to generate a snapshot, the process is placed in a queue. 기본적으로 동시 프로세스의 수에는 제한이 없습니다.By default there is no limit to the number of concurrent processes.

  2. 게시자에서 sp_addpublication_snapshot(Transact-SQL)을 실행합니다.At the Publisher, execute sp_addpublication_snapshot (Transact-SQL). @publication에 1단계에서 사용된 게시 이름을, @job_login@password복제 스냅숏 에이전트를 실행하는 데 사용되는 MicrosoftMicrosoft Windows 자격 증명을 지정합니다.Specify the publication name used in step 1 for @publication and the MicrosoftMicrosoft Windows credentials under which the Replication Snapshot Agent runs for @job_login and @password. 게시자에 연결할 때 에이전트가 SQL ServerSQL Server 인증을 사용하면 @publisher_security_mode @allow_subscriber_initiated_snapshot @publisher_security_mode 에 1단계에 사용된 게시 이름, MicrosoftMicrosoft SQL ServerSQL Server@publisher_login@publisher_password을 참조하세요.If the agent will use SQL ServerSQL Server Authentication when connecting to the Publisher, you must also specify a value of 0 for @publisher_security_mode and the MicrosoftMicrosoft SQL ServerSQL Server login information for @publisher_login and @publisher_password. 이렇게 하면 게시에 대해 스냅숏 에이전트 작업이 만들어집니다.This creates a Snapshot Agent job for the publication. 초기 스냅숏을 생성하고 스냅숏 에이전트에 대한 사용자 지정 일정을 정의하는 방법은 초기 스냅숏 만들기 및 적용를 참조하세요.For more information about generating an initial snapshot and defining a custom schedule for the Snapshot Agent, see Create and Apply the Initial Snapshot.

    중요

    게시자를 원격 배포자로 구성할 경우 job_loginjob_password를 비롯한 모든 매개 변수에 제공된 값이 일반 텍스트로 배포자에게 전송됩니다.When configuring a Publisher with a remote Distributor, the values supplied for all parameters, including job_login and job_password, are sent to the Distributor as plain text. 이 저장 프로시저를 실행하기 전에 게시자와 해당 원격 배포자 간 연결을 암호화해야 합니다.You should encrypt the connection between the Publisher and its remote Distributor before executing this stored procedure. 자세한 내용은 데이터베이스 엔진에 암호화 연결 사용(SQL Server 구성 관리자)을 참조하세요.For more information, see Enable Encrypted Connections to the Database Engine (SQL Server Configuration Manager).

  3. sp_addmergearticle(Transact-SQL)을 실행하여 게시에 아티클을 추가합니다.Execute sp_addmergearticle (Transact-SQL) to add articles to the publication. 이 저장 프로시저는 게시의 각 아티클에 대해 한 번씩만 실행해야 합니다.This stored procedure must be executed once for each article in the publication. 매개 변수가 있는 필터를 사용할 경우 @subset_filterclause 매개 변수를 사용하여 하나 이상의 아티클에 대해 매개 변수가 있는 행 필터를 지정해야 합니다.When using parameterized filters, you must specify a parameterized row filter for one or more articles using the @subset_filterclause parameter. 자세한 내용은 병합 아티클에 대한 매개 변수가 있는 행 필터 정의 및 수정을 참조하세요.For more information, see Define and Modify a Parameterized Row Filter for a Merge Article.

  4. 다른 아티클이 매개 변수가 있는 행 필터에 따라 필터링되면 sp_addmergefilter(Transact-SQL)를 실행하여 아티클 간의 조인 또는 논리 레코드 관계를 정의합니다.If other articles will be filtered based on the parameterized row filter, execute sp_addmergefilter (Transact-SQL) to define the join or logical record relationships between articles. 이 저장 프로시저는 정의되는 각 관계에 대해 한 번씩만 실행해야 합니다.This stored procedure must be executed once for each relationship being defined. 자세한 내용은 병합 아티클 사이에서 조인 필터 정의 및 수정을 참조하세요.For more information, see Define and Modify a Join Filter Between Merge Articles.

  5. 병합 에이전트가 구독자를 초기화하기 위해 스냅숏을 요청하면 구독의 파티션을 요청하기 위한 스냅숏이 자동으로 생성됩니다.When the Merge Agent requests the snapshot to initialize the Subscriber, the snapshot for the requesting subscription's partition is automatically generated.

게시를 만들고 스냅숏을 미리 생성하거나 자동으로 새로 고치려면To create a publication and pre-generate or automatically refresh snapshots

  1. sp_addmergepublication(Transact-SQL)을 실행하여 게시를 만듭니다.Execute sp_addmergepublication (Transact-SQL) to create the publication. 자세한 내용은 게시 만들기를 참조하세요.For more information, see Create a Publication.

  2. 게시자에서 sp_addpublication_snapshot(Transact-SQL)을 실행합니다.At the Publisher, execute sp_addpublication_snapshot (Transact-SQL). @publication에 1단계에서 사용된 게시 이름을, @job_login@password에 스냅숏 에이전트를 실행하는 데 사용되는 Windows 자격 증명을 지정합니다.Specify the publication name used in step 1 for @publication and the Windows credentials under which the Snapshot Agent runs for @job_login and @password. 게시자에 연결할 때 에이전트가 SQL ServerSQL Server 인증을 사용하면 @publisher_security_mode @allow_subscriber_initiated_snapshot @publisher_security_mode 에 1단계에 사용된 게시 이름, SQL ServerSQL Server@publisher_login@publisher_password을 참조하세요.If the agent will use SQL ServerSQL Server Authentication when connecting to the Publisher, you must also specify a value of 0 for @publisher_security_mode and the SQL ServerSQL Server login information for @publisher_login and @publisher_password. 이렇게 하면 게시에 대해 스냅숏 에이전트 작업이 만들어집니다.This creates a Snapshot Agent job for the publication. 초기 스냅숏을 생성하고 스냅숏 에이전트에 대한 사용자 지정 일정을 정의하는 방법은 초기 스냅숏 만들기 및 적용를 참조하세요.For more information about generating an initial snapshot and defining a custom schedule for the Snapshot Agent, see Create and Apply the Initial Snapshot.

    중요

    게시자를 원격 배포자로 구성할 경우 job_loginjob_password를 비롯한 모든 매개 변수에 제공된 값이 일반 텍스트로 배포자에게 전송됩니다.When configuring a Publisher with a remote Distributor, the values supplied for all parameters, including job_login and job_password, are sent to the Distributor as plain text. 이 저장 프로시저를 실행하기 전에 게시자와 해당 원격 배포자 간 연결을 암호화해야 합니다.You should encrypt the connection between the Publisher and its remote Distributor before executing this stored procedure. 자세한 내용은 데이터베이스 엔진에 암호화 연결 사용(SQL Server 구성 관리자)을 참조하세요.For more information, see Enable Encrypted Connections to the Database Engine (SQL Server Configuration Manager).

  3. sp_addmergearticle(Transact-SQL)을 실행하여 게시에 아티클을 추가합니다.Execute sp_addmergearticle (Transact-SQL) to add articles to the publication. 이 저장 프로시저는 게시의 각 아티클에 대해 한 번씩만 실행해야 합니다.This stored procedure must be executed once for each article in the publication. 매개 변수가 있는 필터를 사용할 경우 @subset_filterclause 매개 변수를 사용하여 하나 이상의 아티클에 대해 매개 변수가 있는 행 필터를 지정해야 합니다.When using parameterized filters, you must specify a parameterized row filter for one article using the @subset_filterclause parameter. 자세한 내용은 병합 아티클에 대한 매개 변수가 있는 행 필터 정의 및 수정을 참조하세요.For more information, see Define and Modify a Parameterized Row Filter for a Merge Article.

  4. 다른 아티클이 매개 변수가 있는 행 필터에 따라 필터링되면 sp_addmergefilter(Transact-SQL)를 실행하여 아티클 간의 조인 또는 논리 레코드 관계를 정의합니다.If other articles will be filtered based on the parameterized row filter, execute sp_addmergefilter (Transact-SQL) to define the join or logical record relationships between articles. 이 저장 프로시저는 정의되는 각 관계에 대해 한 번씩만 실행해야 합니다.This stored procedure must be executed once for each relationship being defined. 자세한 내용은 병합 아티클 사이에서 조인 필터 정의 및 수정을 참조하세요.For more information, see Define and Modify a Join Filter Between Merge Articles.

  5. 게시 데이터베이스의 게시자에서 1단계의 @publication 값을 지정하여 sp_helpmergepublication(Transact-SQL)을 실행합니다.At the Publisher on the publication database, execute sp_helpmergepublication (Transact-SQL), specifying the value of @publication from step 1. 결과 집합에서 snapshot_jobid 값을 확인합니다.Note the value of the snapshot_jobid in the result set.

  6. 5단계에서 얻은 snapshot_jobid 의 값을 uniqueidentifier로 변환합니다.Convert the value of the snapshot_jobid obtained in step 5 to uniqueidentifier.

  7. msdb 데이터베이스의 게시자에서 @job_id에 6단계에서 얻은 변환된 값을 지정하고 sp_start_job(Transact-SQL)을 실행합니다.At the Publisher on the msdb database, execute sp_start_job (Transact-SQL), specifying the converted value obtained in step 6 for @job_id.

  8. 게시 데이터베이스의 게시자에서 sp_addmergepartition(Transact-SQL)을 실행합니다.At the Publisher on the publication database, execute sp_addmergepartition (Transact-SQL). @publication에 1단계의 게시 이름을, @suser_sname(SUSER_SNAME(Transact-SQL)이 필터 절에 사용된 경우) 또는 @host_name(HOST_NAME(Transact-SQL)이 필터 절에 사용된 경우)에 파티션을 정의하는 데 사용되는 값을 지정합니다.Specify the name of the publication from step 1 for @publication and the value used to define the partition for @suser_sname if SUSER_SNAME (Transact-SQL) is used in the filter clause or for @host_name if HOST_NAME (Transact-SQL) is used in the filter clause.

  9. 게시 데이터베이스의 게시자에서 sp_adddynamicsnapshot_job(Transact-SQL)을 실행합니다.At the publisher on the publication database, execute sp_adddynamicsnapshot_job (Transact-SQL). @publication에 1단계의 게시 이름을 지정하고 8단계의 @suser_sname 또는 @host_name 값, 그리고 작업 일정을 지정합니다.Specify the name of the publication from step 1 for @publication, the value of @suser_sname or @host_name from step 8, and a schedule for the job. 이렇게 하면 지정된 파티션에 대해 매개 변수가 있는 스냅숏을 생성하는 작업이 만들어집니다.This creates the job that generates the parameterized snapshot for the specified partition. 자세한 내용은 Specify Synchronization Schedules을 참조하세요.For more information, see Specify Synchronization Schedules.

    참고

    이 작업은 2단계에서 정의한 초기 스냅숏 작업과 동일한 Windows 계정을 사용하여 실행됩니다.This job runs using the same Windows account as the initial snapshot job defined in step 2. 매개 변수가 있는 스냅숏 작업과 관련 데이터 파티션을 제거하려면 sp_dropdynamicsnapshot_job(Transact-SQL)을 실행합니다.To remove the parameterized snapshot job and its related data partition, execute sp_dropdynamicsnapshot_job (Transact-SQL).

  10. 게시 데이터베이스의 게시자에서 1단계의 @publication 값과 8단계의 @suser_sname 또는 @host_name 값을 지정하여 sp_helpmergepartition(Transact-SQL)을 실행합니다.At the Publisher on the publication database, execute sp_helpmergepartition (Transact-SQL), specifying the value of @publication from step 1 and the value of @suser_sname or @host_name from step 8. 결과 집합에서 dynamic_snapshot_jobid 값을 확인합니다.Note the value of the dynamic_snapshot_jobid in the result set.

  11. msdb 데이터베이스의 배포자에서 @job_id에 9단계에서 얻은 값을 지정하여 sp_start_job(Transact-SQL)을 실행합니다.At the Distributor on the msdb database, execute sp_start_job (Transact-SQL), specifying the value obtained in step 9 for @job_id. 이렇게 하면 파티션에 대한 매개 변수가 있는 스냅숏 작업이 시작됩니다.This starts the parameterized snapshot job for the partition.

  12. 8-11단계를 반복하여 각 구독에 대해 분할된 스냅숏을 생성합니다.Repeat steps 8-11 to generate a partitioned snapshot for each subscription.

게시를 만들고 각 파티션에 대한 스냅숏을 수동으로 만들려면To create a publication and manually create snapshots for each partition

  1. sp_addmergepublication(Transact-SQL)을 실행하여 게시를 만듭니다.Execute sp_addmergepublication (Transact-SQL) to create the publication. 자세한 내용은 게시 만들기를 참조하세요.For more information, see Create a Publication.

  2. 게시자에서 sp_addpublication_snapshot(Transact-SQL)을 실행합니다.At the Publisher, execute sp_addpublication_snapshot (Transact-SQL). @publication에 1단계에서 사용된 게시 이름을, @job_login@password에 스냅숏 에이전트를 실행하는 데 사용되는 Windows 자격 증명을 지정합니다.Specify the publication name used in step 1 for @publication and the Windows credentials under which the Snapshot Agent runs for @job_login and @password. 게시자에 연결할 때 에이전트가 SQL ServerSQL Server 인증을 사용하면 @publisher_security_mode @allow_subscriber_initiated_snapshot @publisher_security_mode 에 1단계에 사용된 게시 이름, SQL ServerSQL Server@publisher_login@publisher_password을 참조하세요.If the agent will use SQL ServerSQL Server Authentication when connecting to the Publisher, you must also specify a value of 0 for @publisher_security_mode and the SQL ServerSQL Server login information for @publisher_login and @publisher_password. 이렇게 하면 게시에 대해 스냅숏 에이전트 작업이 만들어집니다.This creates a Snapshot Agent job for the publication. 초기 스냅숏을 생성하고 스냅숏 에이전트에 대한 사용자 지정 일정을 정의하는 방법은 초기 스냅숏 만들기 및 적용를 참조하세요.For more information about generating an initial snapshot and defining a custom schedule for the Snapshot Agent, see Create and Apply the Initial Snapshot.

    중요

    게시자를 원격 배포자로 구성할 경우 job_loginjob_password를 비롯한 모든 매개 변수에 제공된 값이 일반 텍스트로 배포자에게 전송됩니다.When configuring a Publisher with a remote Distributor, the values supplied for all parameters, including job_login and job_password, are sent to the Distributor as plain text. 이 저장 프로시저를 실행하기 전에 게시자와 해당 원격 배포자 간 연결을 암호화해야 합니다.You should encrypt the connection between the Publisher and its remote Distributor before executing this stored procedure. 자세한 내용은 데이터베이스 엔진에 암호화 연결 사용(SQL Server 구성 관리자)을 참조하세요.For more information, see Enable Encrypted Connections to the Database Engine (SQL Server Configuration Manager).

  3. sp_addmergearticle(Transact-SQL)을 실행하여 게시에 아티클을 추가합니다.Execute sp_addmergearticle (Transact-SQL) to add articles to the publication. 이 저장 프로시저는 게시의 각 아티클에 대해 한 번씩만 실행해야 합니다.This stored procedure must be executed once for each article in the publication. 매개 변수가 있는 필터를 사용할 경우 @subset_filterclause 매개 변수를 사용하여 하나 이상의 아티클에 대해 매개 변수가 있는 행 필터를 지정해야 합니다.When using parameterized filters, you must specify a parameterized row filter for at least one article using the @subset_filterclause parameter. 자세한 내용은 병합 아티클에 대한 매개 변수가 있는 행 필터 정의 및 수정을 참조하세요.For more information, see Define and Modify a Parameterized Row Filter for a Merge Article.

  4. 다른 아티클이 매개 변수가 있는 행 필터에 따라 필터링되면 sp_addmergefilter(Transact-SQL)를 실행하여 아티클 간의 조인 또는 논리 레코드 관계를 정의합니다.If other articles will be filtered based on the parameterized row filter, execute sp_addmergefilter (Transact-SQL) to define the join or logical record relationships between articles. 이 저장 프로시저는 정의되는 각 관계에 대해 한 번씩만 실행해야 합니다.This stored procedure must be executed once for each relationship being defined. 자세한 내용은 병합 아티클 사이에서 조인 필터 정의 및 수정을 참조하세요.For more information, see Define and Modify a Join Filter Between Merge Articles.

  5. 스냅숏 작업을 시작하거나 명령 프롬프트에서 복제 스냅숏 에이전트를 실행하여 표준 스냅숏 스키마 및 그 밖의 파일을 생성합니다.Start the snapshot job or run the Replication Snapshot Agent from the command prompt to generate the standard snapshot schema and other files. 자세한 내용은 초기 스냅숏 만들기 및 적용을 참조하세요.For more information, see Create and Apply the Initial Snapshot.

  6. 명령 프롬프트에서 -DynamicSnapshotLocation 에 분할된 스냅숏의 위치를 지정하고 파티션을 정의하는 다음 속성을 하나 또는 모두 지정하고 복제 스냅숏 에이전트를 다시 실행하여 대량 복사(.bcp) 파일을 생성합니다.Run the Replication Snapshot Agent again from the command prompt to generate bulk copy (.bcp) files, specifying the location of the partitioned snapshot for -DynamicSnapshotLocation and one or both of the following properties that defines the partition:

  7. 6단계를 반복하여 각 구독에 대해 분할된 스냅숏을 생성합니다.Repeat step 6 to generate a partitioned snapshot for each subscription.

  8. 다음 속성을 지정하고 각 구독에 대해 병합 에이전트를 실행하여 구독자에서 초기 분할된 스냅숏을 적용합니다.Run the Merge Agent for each subscription to apply the initial partitioned snapshot at the Subscribers, specifying the following properties:

    • -Hostname - HOST_NAME의 실제 값이 재정의되는 경우 파티션을 정의하는 데 사용되는 값-Hostname - the value used to define the partition if the actual value of HOST_NAME is being overridden.

    • -DynamicSnapshotLocation - 이 파티션에 대한 동적 스냅숏의 위치-DynamicSnapshotLocation - the location of the dynamic snapshot for this partition.

참고

복제 에이전트를 프로그래밍하는 방법에 대한 자세한 내용은 복제 에이전트 실행 파일 개념을 참조하세요.For more information about programming replication agents, see Replication Agent Executables Concepts.

예(Transact-SQL) Examples (Transact-SQL)

이 예에서는 매개 변수가 있는 필터를 사용하여 구독자가 스냅숏 생성 프로세스를 시작하는 병합 게시를 만듭니다.This example creates a merge publication with parameterized filters where Subscribers initiate the snapshot generation process. @job_login@job_password 값은 스크립팅 변수를 사용하여 전달됩니다.Values for @job_login and @job_password are passed in using scripting variables.

-- 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'AdventureWorks2012';
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 [AdventureWorks2012];

-- Enable AdventureWorks2012 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 AdventureWorks2012.', 
  @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

이 예에서는 매개 변수가 있는 필터를 사용하여 각 구독자가 sp_addmergepartition 을 실행하여 파티션을 정의하고 sp_adddynamicsnapshot_job 을 실행하여 필터링된 스냅숏 작업을 만들고 분할 정보를 전달하는 게시를 만듭니다.This example creates a publication using a parameterized filter where each Subscriber has its partition defined by executing sp_addmergepartition and the filtered snapshot job created by executing sp_adddynamicsnapshot_job passing the partitioning information. @job_login@job_password 값은 스크립팅 변수를 사용하여 전달됩니다.Values for @job_login and @job_password are passed in using scripting variables.

-- 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'AdventureWorks2012';
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 [AdventureWorks2012];

-- Enable AdventureWorks2012 for merge replication.
EXEC sp_replicationdboption
  @dbname = @publicationdb,
  @optname = N'merge publish',
  @value = N'true';  

-- Create new merge publication.  
EXEC sp_addmergepublication 
  @publication = @publication, 
  @description = N'Merge publication of AdventureWorks2012.', 
  @allow_subscriber_initiated_snapshot = N'false';

-- 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 customer 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 snapshot agent job.
DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesPersonMerge';

EXEC sp_startpublication_snapshot 
  @publication = @publication;
GO

PRINT '*** Waiting for the initial snapshot.';
GO

-- Create a temporary table to store the filtered data snapshot 
-- job information.
CREATE TABLE #temp (id int,
	job_name sysname,
	job_id uniqueidentifier,
	dynamic_filter_login sysname NULL,
	dynamic_filter_hostname sysname NULL,
	dynamic_snapshot_location nvarchar(255),
	frequency_type int, 
	frequency_interval int, 
	frequency_subday_type int,
	frequency_subday_interval int, 
	frequency_relative_interval int, 
	frequency_recurrence_factor int, 
	active_start_date int, 
	active_end_date int, 
	active_start_time int, 
	active_end_time int
)

-- Create each snapshot for a partition 
-- The initial snapshot must already be generated.
DECLARE @publication AS sysname;
DECLARE @jobname AS sysname
DECLARE @hostname AS sysname
SET @publication = N'AdvWorksSalesPersonMerge';
SET @hostname = N'adventure-works\Fernando';

WHILE NOT EXISTS(SELECT * FROM sysmergepublications 
    WHERE [name] = @publication 
    AND snapshot_ready = 1)
BEGIN
    WAITFOR DELAY '00:00:05'
END

-- Create a data partition by overriding HOST_NAME().
EXEC sp_addmergepartition 
  @publication = @publication,
  @host_name = @hostname;

-- Create the filtered data snapshot job, and use the returned 
-- information to start the job.
EXEC sp_adddynamicsnapshot_job 
  @publication = @publication,
  @host_name = @hostname;

INSERT INTO #temp (id, job_name, job_id, dynamic_filter_login,
	dynamic_filter_hostname, dynamic_snapshot_location,
	frequency_type,	frequency_interval, frequency_subday_type,
	frequency_subday_interval, frequency_relative_interval, 
	frequency_recurrence_factor, active_start_date,	active_end_date, 
	active_start_time,active_end_time)
EXEC sp_helpdynamicsnapshot_job;

SELECT @jobname = (SELECT DISTINCT job_name FROM #temp WHERE dynamic_filter_hostname = @hostname);

EXEC msdb..sp_start_job @job_name = @jobname;
DROP TABLE #temp;
GO

이 예에서는 매개 변수가 있는 필터를 사용하여 각 구독자가 분할 정보를 제공함으로써 데이터 파티션과 필터링된 스냅숏 작업을 만들어야 하는 게시를 만듭니다.This example creates a publication using a parameterized filter where each Subscriber must have its data partition and filtered snapshot job created by supplying the partitioning information. 구독자는 복제 에이전트를 수동으로 실행할 때 구독자가 명령줄 매개 변수를 사용하여 분할 정보를 제공합니다.A Subscriber supplies partitioning information using command-line parameters when manually running the replication agents. 이 예에서는 이 게시에 대한 구독도 만들어졌다고 가정합니다.This example assumes that a subscription to the publication has also been created.

-- 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'AdventureWorks2012';
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 [AdventureWorks2012];

-- Enable AdventureWorks2012 for merge replication.
EXEC sp_replicationdboption
  @dbname = @publicationdb,
  @optname = N'merge publish',
  @value = N'true';  

-- Create new merge publication.  
EXEC sp_addmergepublication 
  @publication = @publication, 
  @description = N'Merge publication of AdventureWorks2012.', 
  @allow_subscriber_initiated_snapshot = N'false';

-- 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 customer 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

REM Line breaks are added to improve readability.   
REM In a batch file, commands must be made in a single line.  
REM Run the Snapshot agent from the command line to generate the standard snapshot   
REM schema and other files.   
SET DistPub=%computername%  
SET PubDB=AdventureWorks2012   
SET PubName=AdvWorksSalesPersonMerge  

"C:\Program Files\Microsoft SQL Server\120\COM\SNAPSHOT.EXE" -Publication %PubName%    
-Publisher %DistPub% -Distributor  %DistPub%  -PublisherDB %PubDB%  -ReplicationType 2    
-OutputVerboseLevel 1  -DistributorSecurityMode 1  

PAUSE  

REM Run the Snapshot agent from the command line, this time to generate   
REM the bulk copy (.bcp) data for each Subscriber partition.    
SET DistPub=%computername%  
SET PubDB=AdventureWorks2012   
SET PubName=AdvWorksSalesPersonMerge  
SET SnapshotDir=\\%DistPub%\repldata\unc\fernando  

MD %SnapshotDir%  

"C:\Program Files\Microsoft SQL Server\120\COM\SNAPSHOT.EXE" -Publication %PubName%    
-Publisher %DistPub%  -Distributor  %DistPub%  -PublisherDB %PubDB%  -ReplicationType 2    
-OutputVerboseLevel 1  -DistributorSecurityMode 1  -DynamicFilterHostName "adventure-works\Fernando"    
-DynamicSnapshotLocation %SnapshotDir%  

PAUSE  

REM Run the Merge Agent for each subscription to apply the partitioned   
REM snapshot for each Subscriber.    
SET Publisher = %computername%  
SET Subscriber = %computername%  
SET PubDB = AdventureWorks2012   
SET SubDB = AdventureWorks2012Replica   
SET PubName = AdvWorksSalesPersonMerge   
SET SnapshotDir=\\%DistPub%\repldata\unc\fernando  

"C:\Program Files\Microsoft SQL Server\120\COM\REPLMERG.EXE" -Publisher  %Publisher%    
-Subscriber  %Subscriber%  -Distributor %Publisher%  -PublisherDB %PubDB%    
-SubscriberDB %SubDB% -Publication %PubName%  -PublisherSecurityMode 1  -OutputVerboseLevel 3    
-Output -SubscriberSecurityMode 1  -SubscriptionType 3 -DistributorSecurityMode 1    
-Hostname "adventure-works\Fernando"  -DynamicSnapshotLocation %SnapshotDir%  

PAUSE  

RMO(복제 관리 개체) 사용 Using Replication Management Objects (RMO)

다음과 같이 RMO(복제 관리 개체)를 사용하여 프로그래밍 방식으로 분할된 스냅숏을 만들 수 있습니다.You can use Replication Management Objects (RMO) to generate partitioned snapshots programmatically in the following ways:

  • 구독자가 처음 동기화될 때 스냅숏 생성 및 적용을 요청하도록 허용합니다.Allow Subscribers to request snapshot generation and application the first time they synchronize.

  • 각 파티션에 대한 스냅숏을 미리 생성합니다.Pre-generate snapshots for each partition.

  • 스냅숏 에이전트를 실행하여 각 구독자에 대한 스냅숏을 수동으로 생성합니다.Manually generate a snapshot for each Subscriber by running the Snapshot Agent.

참고

병합 아티클을 만들 때 F:Microsoft.SqlServer.Replication.PartitionOptions.NonOverlappingSingleSubscription에 P:Microsoft.SqlServer.Replication.MergeArticle.PartitionOption 값을 지정하여 아티클을 필터링함으로써 구독별로 고유한 겹치지 않는 파티션을 생성하면 병합 에이전트를 실행할 때마다 메타데이터가 정리됩니다.When filtering for an article yields non-overlapping partitions that are unique for each subscription (by specifying a value of F:Microsoft.SqlServer.Replication.PartitionOptions.NonOverlappingSingleSubscription for P:Microsoft.SqlServer.Replication.MergeArticle.PartitionOption when creating a merge article), metadata is cleaned up whenever the Merge Agent runs. 따라서 분할된 스냅숏은 더 빨리 만료됩니다.This means that the partitioned snapshot expires more quickly. 이 옵션을 사용할 경우 구독자가 스냅숏 생성을 요청하도록 허용하는 것을 고려해야 합니다.When you use this option, you should consider allowing Subscribers to request snapshot generation. 자세한 내용은 매개 변수가 있는 행 필터항목의 "적절한 필터링 옵션 사용" 섹션을 참조하세요.For more information, see the section Using the Appropriate Filtering Options in the topic Parameterized Row Filters.

중요

가능한 경우 런타임 시 사용자에게 보안 자격 증명을 입력하라는 메시지가 표시됩니다.When possible, prompt users to enter security credentials at runtime. 자격 증명을 저장해야 하는 경우 Windows .NET Framework에서 제공하는 암호화 서비스 MicrosoftMicrosoft 를 사용합니다.If you must store credentials, use the cryptographic services provided by the MicrosoftMicrosoft Windows .NET Framework.

구독자가 스냅숏 생성 및 배달을 시작하도록 허용하는 게시를 만들려면To create a publication that allows Subscribers to initiate snapshot generation and delivery

  1. ServerConnection 클래스를 사용하여 게시자 연결을 만듭니다.Create a connection to the Publisher by using the ServerConnection class.

  2. 게시 데이터베이스에 대한 ReplicationDatabase 클래스의 인스턴스를 만들고 ConnectionContext 속성을 1단계의 ServerConnection 인스턴스로 설정한 다음 LoadProperties 메서드를 호출합니다.Create an instance of the ReplicationDatabase class for the publication database, set the ConnectionContext property to the instance of ServerConnection from step 1, and call the LoadProperties method. LoadProperties에서 false가 반환되면 데이터베이스가 있는지 확인합니다.If LoadProperties returns false, confirm that the database exists.

  3. EnabledMergePublishing 속성이 false이면 true로 설정한 후 CommitPropertyChanges를 호출합니다.If EnabledMergePublishing property is false, set it to true and call CommitPropertyChanges.

  4. MergePublication 클래스의 인스턴스를 만들고 이 개체에 대해 다음 속성을 설정합니다:Create an instance of the MergePublication class, and set the following properties for this object:

  5. Create 메서드를 호출하여 게시를 만듭니다.Call the Create method to create the publication.

    중요

    원격 배포자로 게시자를 구성할 경우 SnapshotGenerationAgentProcessSecurity를 포함하여 모든 속성에 제공된 값이 일반 텍스트로 배포자에게 보내집니다.When configuring a Publisher with a remote Distributor, the values supplied for all properties, including SnapshotGenerationAgentProcessSecurity, are sent to the Distributor as plain text. Create 메서드를 호출하기 전에 게시자와 해당 원격 배포자 간 연결을 암호화해야 합니다.You should encrypt the connection between the Publisher and its remote Distributor before calling the Create method. 자세한 내용은 데이터베이스 엔진에 암호화 연결 사용(SQL Server 구성 관리자)을 참조하세요.For more information, see Enable Encrypted Connections to the Database Engine (SQL Server Configuration Manager).

  6. MergeArticle 속성을 사용하여 게시에 아티클을 추가합니다.Use the MergeArticle property to add articles to the publication. 매개 변수가 있는 필터를 정의하는 하나 이상의 아티클에 대해 FilterClause 속성을 지정합니다.Specify the FilterClause property for at least one article that defines the parameterized filter. (선택 사항) 아티클 간 조인 필터를 정의하는 MergeJoinFilter 개체를 만듭니다.(Optional) Create MergeJoinFilter objects that define join filters between articles. 자세한 내용은 아티클을 정의을 참조하세요.For more information, see Define an Article.

  7. SnapshotAgentExists 값이 false이면 CreateSnapshotAgent를 호출하여 이 게시에 대한 초기 스냅숏 에이전트 작업을 만듭니다.If the value of SnapshotAgentExists is false, call CreateSnapshotAgent to create the initial Snapshot Agent job for this publication.

  8. 4단계에서 만든 MergePublication 개체의 StartSnapshotGenerationAgentJob 메서드를 호출합니다.Call the StartSnapshotGenerationAgentJob method of the MergePublication object created in step 4. 그러면 초기 스냅숏을 생성하는 에이전트 작업이 시작됩니다.This starts the agent job that generates the initial snapshot. 초기 스냅숏을 생성하고 스냅숏 에이전트에 대한 사용자 지정 일정을 정의하는 방법은 초기 스냅숏 만들기 및 적용를 참조하세요.For more information about generating an initial snapshot and defining a custom schedule for the Snapshot Agent, see Create and Apply the Initial Snapshot.

  9. (선택 사항) SnapshotAvailable 속성이 true 값인지 검사하여 초기 스냅숏을 사용할 준비가 되었는지 확인합니다.(Optional) Check for a value of true for the SnapshotAvailable property to determine when the initial snapshot is ready for use.

  10. 구독자가 병합 에이전트에 처음으로 연결하는 경우에는 분할된 스냅숏이 자동으로 생성됩니다.When the Merge Agent for a Subscriber connects for the first time, a partitioned snapshot is generated automatically.

게시를 만들고 스냅숏을 미리 생성하거나 자동으로 새로 고치려면To create a publication and pregenerate or automatically refresh snapshots

  1. MergePublication 클래스의 인스턴스를 사용하여 병합 게시를 정의합니다.Use an instance of the MergePublication class to define a merge publication. 자세한 내용은 게시 만들기를 참조하세요.For more information, see Create a Publication.

  2. MergeArticle 속성을 사용하여 게시에 아티클을 추가합니다.Use the MergeArticle property to add articles to the publication. 매개 변수가 있는 필터를 정의하는 하나 이상의 아티클에 대해 FilterClause 속성을 지정하고 아티클 간 조인 필터를 정의하는 MergeJoinFilter 개체를 만듭니다.Specify the FilterClause property for at least one article that defines the parameterized filter, and create any MergeJoinFilter objects that define join filters between articles. 자세한 내용은 아티클을 정의을 참조하세요.For more information, see Define an Article.

  3. SnapshotAgentExists 값이 false이면 CreateSnapshotAgent를 호출하여 이 게시에 대한 스냅숏 에이전트 작업을 만듭니다.If the value of SnapshotAgentExists is false, call CreateSnapshotAgent to create the snapshot agent job for this publication.

  4. 1단계에서 만든 MergePublication 개체의 StartSnapshotGenerationAgentJob 메서드를 호출합니다.Call the StartSnapshotGenerationAgentJob method of the MergePublication object created in step 1. 그러면 초기 스냅숏을 생성하는 에이전트 작업이 시작됩니다.This method starts the agent job that generates the initial snapshot. 초기 스냅숏을 생성하고 스냅숏 에이전트에 대한 사용자 지정 일정을 정의하는 방법은 초기 스냅숏 만들기 및 적용를 참조하십시오.For more information on generating an initial snapshot and defining a custom schedule for the Snapshot Agent, see Create and Apply the Initial Snapshot.

  5. SnapshotAvailable 속성이 true 값인지 검사하여 초기 스냅숏을 사용할 준비가 되었는지 확인합니다.Check for a value of true for the SnapshotAvailable property to determine when the initial snapshot is ready for use.

  6. MergePartition 클래스의 인스턴스를 만들고 다음 두 속성 중 하나 또는 모두를 사용하여 구독자에 대한 매개 변수가 있는 필터링 조건을 설정합니다.Create an instance of the MergePartition class, and set the parameterized filtering criteria for the Subscriber by using one or both of the following properties:

  7. MergeDynamicSnapshotJob 클래스의 인스턴스를 만들고 6단계와 동일한 속성을 설정합니다.Create an instance of the MergeDynamicSnapshotJob class, and set the same property as in step 6.

  8. ReplicationAgentSchedule 클래스를 사용하여 구독자 파티션에 대한 필터링된 스냅숏을 생성할 일정을 정의합니다.Use the ReplicationAgentSchedule class to define a schedule for generating the filtered snapshot for the Subscriber partition.

  9. 1단계의 MergePublication 인스턴스를 사용하여 AddMergePartition을 호출합니다.Using the instance of MergePublication from step 1, call AddMergePartition. 6단계에서 만든 MergePartition 개체를 전달합니다.Pass the MergePartition object from step 6.

  10. 1단계의 MergePublication 인스턴스를 사용하여 AddMergeDynamicSnapshotJob 메서드를 호출합니다.Using the instance of MergePublication from step 1, call the AddMergeDynamicSnapshotJob method. 7단계에서 만든 MergeDynamicSnapshotJob 개체 및 8단계에서 만든 ReplicationAgentSchedule 개체를 전달합니다.Pass the MergeDynamicSnapshotJob object from step 7 and the ReplicationAgentSchedule object from step 8.

  11. EnumMergeDynamicSnapshotJobs를 호출하고 반환된 배열의 새로 추가된 분할된 스냅숏 작업에서 MergeDynamicSnapshotJob 개체를 찾습니다.Call EnumMergeDynamicSnapshotJobs, and locate the MergeDynamicSnapshotJob object for the newly added partitioned snapshot job in the returned array.

  12. 작업의 Name 속성을 가져옵니다.Get the Name property for the job.

  13. ServerConnection 클래스를 사용하여 배포자 연결을 만듭니다.Create a connection to the Distributor by using the ServerConnection class.

  14. 13단계의 ServerConnection 개체를 전달하여 SMO(SQL Server 관리 개체) Server 클래스의 인스턴스를 만듭니다.Create an instance of the SQL Server Management Objects (SMO) Server class, passing the ServerConnection object from step 13.

  15. 14단계에서 만든 Job 개체의 JobServer 속성 및 12단계에서 가져온 작업 이름을 전달하여 Server 클래스의 인스턴스를 만듭니다.Create an instance of the Job class, passing the JobServer property of the Server object from step 14 and the job name from step 12.

  16. Start 메서드를 호출하여 분할된 스냅숏 작업을 시작합니다.Call the Start method to start the partitioned snapshot job.

  17. 구독자별로 6단계에서 16단계까지 반복합니다.Repeat steps 6-16 for each Subscriber.

게시를 만들고 각 파티션에 대한 스냅숏을 수동으로 만들려면To create a publication and manually create snapshots for each partition

  1. MergePublication 클래스의 인스턴스를 사용하여 병합 게시를 정의합니다.Use an instance of the MergePublication class to define a merge publication. 자세한 내용은 게시 만들기를 참조하세요.For more information, see Create a Publication.

  2. MergeArticle 속성을 사용하여 게시에 아티클을 추가합니다. 매개 변수가 있는 필터를 정의하는 하나 이상의 아티클에 대해 FilterClause 속성을 지정하고 아티클 간 조인 필터를 정의하는 MergeJoinFilter 개체를 만듭니다.Use the MergeArticle property to add articles to the publication Specify the FilterClause property for at least one article that defines the parameterized filter, and create any MergeJoinFilter objects that define join filters between articles. 자세한 내용은 아티클을 정의을 참조하세요.For more information, see Define an Article.

  3. 초기 스냅숏을 만듭니다.Generate the initial snapshot. 자세한 내용은 초기 스냅숏 만들기 및 적용을 참조하세요.For more information, see Create and Apply the Initial Snapshot.

  4. Microsoft.SqlServer.Replication.SnapshotGenerationAgent 클래스의 인스턴스를 만들고 다음 필수 속성을 설정합니다.Create an instance of the Microsoft.SqlServer.Replication.SnapshotGenerationAgent class, and set the following required properties:

  5. MergeMicrosoft.SqlServer.Replication.SnapshotGenerationAgent.ReplicationType* 값을 설정합니다.Set a value of Merge for Microsoft.SqlServer.Replication.SnapshotGenerationAgent.ReplicationType*.

  6. 다음 속성 중 하나 이상을 설정하여 분할 매개 변수를 정의합니다.Set one or more of the following properties to define the partitioning parameters:

  7. Microsoft.SqlServer.Replication.SnapshotGenerationAgent.GenerateSnapshot* 메서드를 호출합니다.Call the Microsoft.SqlServer.Replication.SnapshotGenerationAgent.GenerateSnapshot* method.

  8. 구독자별로 4단계에서 7단계까지 반복합니다.Repeat steps 4-7 for each Subscriber.

예(RMO) Examples (RMO)

이 예제에서는 구독자에게 스냅숏 생성 요청을 허용하는 병합 게시를 만듭니다.This example creates a merge publication that allows Subscribers to requested snapshot generation.

// Set the Publisher, publication database, and publication names.
string publisherName = publisherInstance;
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2012";

ReplicationDatabase publicationDb;
MergePublication publication;

// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);

try
{
	// Connect to the Publisher.
	conn.Connect();

	// Enable the database for merge publication.				
	publicationDb = new ReplicationDatabase(publicationDbName, conn);
	if (publicationDb.LoadProperties())
	{
		if (!publicationDb.EnabledMergePublishing)
		{
			publicationDb.EnabledMergePublishing = true;
		}
	}
	else
	{
		// Do something here if the database does not exist. 
		throw new ApplicationException(String.Format(
			"The {0} database does not exist on {1}.",
			publicationDb, publisherName));
	}

	// Set the required properties for the merge publication.
	publication = new MergePublication();
	publication.ConnectionContext = conn;
	publication.Name = publicationName;
	publication.DatabaseName = publicationDbName;

             // Enable precomputed partitions.
             publication.PartitionGroupsOption = PartitionGroupsOption.True;

	// Specify the Windows account under which the Snapshot Agent job runs.
	// This account will be used for the local connection to the 
	// Distributor and all agent connections that use Windows Authentication.
	publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin;
	publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword;

	// Explicitly set the security mode for the Publisher connection
	// Windows Authentication (the default).
	publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = true;

	// Enable Subscribers to request snapshot generation and filtering.
	publication.Attributes |= PublicationAttributes.AllowSubscriberInitiatedSnapshot;
             publication.Attributes |= PublicationAttributes.DynamicFilters;

             // Enable pull and push subscriptions.
             publication.Attributes |= PublicationAttributes.AllowPull;
             publication.Attributes |= PublicationAttributes.AllowPush;

	if (!publication.IsExistingObject)
	{
		// Create the merge publication.
		publication.Create();
		
		// Create a Snapshot Agent job for the publication.
		publication.CreateSnapshotAgent();
	}
	else
	{
		throw new ApplicationException(String.Format(
			"The {0} publication already exists.", publicationName));
	}
}

catch (Exception ex)
{
	// Implement custom application error handling here.
	throw new ApplicationException(String.Format(
		"The publication {0} could not be created.", publicationName), ex);
}
finally
{
	conn.Disconnect();
}
' Set the Publisher, publication database, and publication names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2012"

Dim publicationDb As ReplicationDatabase
Dim publication As MergePublication

' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Enable the database for merge publication.				
    publicationDb = New ReplicationDatabase(publicationDbName, conn)
    If publicationDb.LoadProperties() Then
        If Not publicationDb.EnabledMergePublishing Then
            publicationDb.EnabledMergePublishing = True
        End If
    Else
        ' Do something here if the database does not exist. 
        Throw New ApplicationException(String.Format( _
         "The {0} database does not exist on {1}.", _
         publicationDb, publisherName))
    End If

    ' Set the required properties for the merge publication.
    publication = New MergePublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    ' Enable precomputed partitions.
    publication.PartitionGroupsOption = PartitionGroupsOption.True

    ' Specify the Windows account under which the Snapshot Agent job runs.
    ' This account will be used for the local connection to the 
    ' Distributor and all agent connections that use Windows Authentication.
    publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin
    publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword

    ' Explicitly set the security mode for the Publisher connection
    ' Windows Authentication (the default).
    publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = True

    ' Enable Subscribers to request snapshot generation and filtering.
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.AllowSubscriberInitiatedSnapshot
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.DynamicFilters

    ' Enable pull and push subscriptions
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.AllowPull
    publication.Attributes = publication.Attributes Or _
        PublicationAttributes.AllowPush

    If Not publication.IsExistingObject Then
        ' Create the merge publication.
        publication.Create()

        ' Create a Snapshot Agent job for the publication.
        publication.CreateSnapshotAgent()
    Else
        Throw New ApplicationException(String.Format( _
            "The {0} publication already exists.", publicationName))
    End If
Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
        "The publication {0} could not be created.", publicationName), ex)
Finally
    conn.Disconnect()
End Try

이 예제에서는 매개 변수가 있는 행 필터를 사용하여 병합 게시에 대한 구독자 파티션 및 필터링된 스냅숏을 수동으로 만듭니다.This example manually creates the Subscriber partition and the filtered snapshot for a merge publication with parameterized row filters.

// Define the server, database, and publication names
string publisherName = publisherInstance;
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2012";
string distributorName = publisherInstance;

MergePublication publication;
MergePartition partition;
MergeDynamicSnapshotJob snapshotAgentJob;
ReplicationAgentSchedule schedule;

// Create a connection to the Publisher.
ServerConnection publisherConn = new ServerConnection(publisherName);

// Create a connection to the Distributor to start the Snapshot Agent.
ServerConnection distributorConn = new ServerConnection(distributorName);

try
{
	// Connect to the Publisher.
	publisherConn.Connect();

	// Set the required properties for the publication.
	publication = new MergePublication();
	publication.ConnectionContext = publisherConn;
	publication.Name = publicationName;
	publication.DatabaseName = publicationDbName;


	// If we can't get the properties for this merge publication, 
	// then throw an application exception.
	if (publication.LoadProperties() || publication.SnapshotAvailable)
	{
		// Set a weekly schedule for the filtered data snapshot.
		schedule = new ReplicationAgentSchedule();
		schedule.FrequencyType = ScheduleFrequencyType.Weekly;
		schedule.FrequencyRecurrenceFactor = 1;
		schedule.FrequencyInterval = Convert.ToInt32(0x001);

		// Set the value of Hostname that defines the data partition. 
		partition = new MergePartition();
		partition.DynamicFilterHostName = hostname;
		snapshotAgentJob = new MergeDynamicSnapshotJob();
		snapshotAgentJob.DynamicFilterHostName = hostname;

		// Create the partition for the publication with the defined schedule.
		publication.AddMergePartition(partition);
		publication.AddMergeDynamicSnapshotJob(snapshotAgentJob, schedule);
	}
	else
	{
		throw new ApplicationException(String.Format(
			"Settings could not be retrieved for the publication, " +
			" or the initial snapshot has not been generated. " +
			"Ensure that the publication {0} exists on {1} and " +
			"that the Snapshot Agent has run successfully.",
			publicationName, publisherName));
	}
}
catch (Exception ex)
{
	// Do error handling here.
	throw new ApplicationException(string.Format(
		"The partition for '{0}' in the {1} publication could not be created.",
		hostname, publicationName), ex);
}
finally
{
	publisherConn.Disconnect();
	if (distributorConn.IsOpen) distributorConn.Disconnect();
}
' Define the server, database, and publication names
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2012"
Dim distributorName As String = publisherInstance

Dim publication As MergePublication
Dim partition As MergePartition
Dim snapshotAgentJob As MergeDynamicSnapshotJob
Dim schedule As ReplicationAgentSchedule

' Create a connection to the Publisher.
Dim publisherConn As ServerConnection = New ServerConnection(publisherName)

' Create a connection to the Distributor to start the Snapshot Agent.
Dim distributorConn As ServerConnection = New ServerConnection(distributorName)

Try
    ' Connect to the Publisher.
    publisherConn.Connect()

    ' Set the required properties for the publication.
    publication = New MergePublication()
    publication.ConnectionContext = publisherConn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName


    ' If we can't get the properties for this merge publication, 
    ' then throw an application exception.
    If (publication.LoadProperties() Or publication.SnapshotAvailable) Then
        ' Set a weekly schedule for the filtered data snapshot.
        schedule = New ReplicationAgentSchedule()
        schedule.FrequencyType = ScheduleFrequencyType.Weekly
        schedule.FrequencyRecurrenceFactor = 1
        schedule.FrequencyInterval = Convert.ToInt32("0x001", 16)

        ' Set the value of Hostname that defines the data partition. 
        partition = New MergePartition()
        partition.DynamicFilterHostName = hostname
        snapshotAgentJob = New MergeDynamicSnapshotJob()
        snapshotAgentJob.DynamicFilterHostName = hostname

        ' Create the partition for the publication with the defined schedule.
        publication.AddMergePartition(partition)
        publication.AddMergeDynamicSnapshotJob(snapshotAgentJob, schedule)
    Else
        Throw New ApplicationException(String.Format( _
         "Settings could not be retrieved for the publication, " + _
         " or the initial snapshot has not been generated. " + _
         "Ensure that the publication {0} exists on {1} and " + _
         "that the Snapshot Agent has run successfully.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Do error handling here.
    Throw New ApplicationException(String.Format( _
     "The partition for '{0}' in the {1} publication could not be created.", _
     hostname, publicationName), ex)
Finally
    publisherConn.Disconnect()
    If distributorConn.IsOpen Then
        distributorConn.Disconnect()
    End If
End Try

이 예제에서는 매개 변수가 있는 행 필터를 사용하여 병합 게시에 구독자에 대한 필터링된 데이터 스냅숏을 수동으로 만듭니다.This example manually starts the Snapshot Agent to generate the filtered data snapshot for a Subscriber to a merge publication with parameterized row filters.

// Set the Publisher, publication database, and publication names.
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2012";
string publisherName = publisherInstance;
string distributorName = publisherInstance;

SnapshotGenerationAgent agent;

try
{
	// Set the required properties for Snapshot Agent.
	agent = new SnapshotGenerationAgent();
	agent.Distributor = distributorName;
	agent.DistributorSecurityMode = SecurityMode.Integrated;
	agent.Publisher = publisherName;
	agent.PublisherSecurityMode = SecurityMode.Integrated;
	agent.Publication = publicationName;
	agent.PublisherDatabase = publicationDbName;
	agent.ReplicationType = ReplicationType.Merge;

	// Specify the partition information to generate a 
	// filtered snapshot based on Hostname.
	agent.DynamicFilterHostName = hostname;

	// Start the agent synchronously.
	agent.GenerateSnapshot();
}
catch (Exception ex)
{
	// Implement custom application error handling here.
	throw new ApplicationException(String.Format(
		"A snapshot could not be generated for the {0} publication."
		, publicationName), ex);
}
' Set the Publisher, publication database, and publication names.
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2012"
Dim publisherName As String = publisherInstance
Dim distributorName As String = publisherInstance

Dim agent As SnapshotGenerationAgent

Try
    ' Set the required properties for Snapshot Agent.
    agent = New SnapshotGenerationAgent()
    agent.Distributor = distributorName
    agent.DistributorSecurityMode = SecurityMode.Integrated
    agent.Publisher = publisherName
    agent.PublisherSecurityMode = SecurityMode.Integrated
    agent.Publication = publicationName
    agent.PublisherDatabase = publicationDbName
    agent.ReplicationType = ReplicationType.Merge

    ' Specify the partition information to generate a 
    ' filtered snapshot based on Hostname.
    agent.DynamicFilterHostName = hostname

    ' Start the agent synchronously.
    agent.GenerateSnapshot()
Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
     "A snapshot could not be generated for the {0} publication." _
     , publicationName), ex)
End Try

참고 항목See Also

매개 변수가 있는 행 필터 Parameterized Row Filters
복제 시스템 저장 프로시저 개념 Replication System Stored Procedures Concepts
매개 변수가 있는 필터를 사용하는 병합 게시의 스냅숏 Snapshots for Merge Publications with Parameterized Filters
Replication Security Best Practices Replication Security Best Practices