게시 만들기Create a Publication

이 항목에서는 SQL Server 2017SQL Server 2017 , SQL Server Management StudioSQL Server Management Studio또는 RMO(복제 관리 개체)를 사용하여 Transact-SQLTransact-SQL에서 게시를 만드는 방법에 대해 설명합니다.This topic describes how to create a publication 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

제한 사항 Limitations and Restrictions

  • 게시 및 아티클 이름에는 %, *, [, ], |, :, ", ? 등의 문자를 포함할 수 없습니다.Publication and article names cannot include any of the following characters: % , * , [ , ] , | , : , " , ? , ' , \ , / , < , >., ' , \ , / , < , >. 이러한 문자를 포함하는 데이터베이스 개체를 복제하려면 마법사의 아티클 페이지에서 사용할 수 있는 아티클 속성 - <아티클> 대화 상자에서 개체 이름과 다른 아티클 이름을 지정해야 합니다.If objects in the database include any of these characters and you want to replicate them, you must specify an article name that is different from the object name in the Article Properties - <Article> dialog box, which is available from the Articles page in the wizard.

보안 Security

가능한 경우 런타임 시 사용자에게 보안 자격 증명을 입력하라는 메시지가 표시됩니다.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.

SQL Server Management Studio 사용 Using SQL Server Management Studio

새 게시 마법사를 사용하여 게시를 만들고 아티클을 정의할 수 있습니다.Create publications and define articles with the New Publication Wizard. 게시를 만든 후 게시 속성 - <게시> 대화 상자에서 게시 속성을 보고 수정합니다.After a publication is created, view and modify publication properties in the Publication Properties - <Publication> dialog box. Oracle 데이터베이스에서 게시를 만드는 방법에 대한 자세한 내용은 Oracle 데이터베이스에서 게시 만들기를 참조하세요.For information about creating a publication from an Oracle database, see Create a Publication from an Oracle Database.

게시를 만들고 아티클을 정의하려면To create a publication and define articles

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

  2. 복제 폴더를 확장한 다음 로컬 게시 폴더를 마우스 오른쪽 단추로 클릭합니다.Expand the Replication folder, and then right-click the Local Publications folder.

  3. 새 게시를 클릭합니다.Click New Publication.

  4. 새 게시 마법사의 페이지에 따라 다음을 수행하세요.Follow the pages in the New Publication Wizard to:

    • 서버에 배포가 구성되어 있지 않은 경우 배포자를 지정합니다.Specify a Distributor if distribution has not been configured on the server. 배포 구성에 대한 자세한 내용은 게시 및 배포 구성을 참조하세요.For more information about configuring distribution, see Configure Publishing and Distribution.

      배포자 페이지에서 게시자 서버가 자신의 고유 배포자(로컬 배포자) 역할을 하는 것으로 지정했지만 서버가 배포자로 구성되어 있지 않은 경우 새 게시 마법사가 서버를 구성합니다.If you specify on the Distributor page that the Publisher server will act as its own Distributor (a local Distributor), and the server is not configured as a Distributor, the New Publication Wizard will configure the server. 스냅숏 폴더 페이지에서 배포자에 대해 기본 스냅숏 폴더를 지정하게 됩니다.You will specify a default snapshot folder for the Distributor on the Snapshot Folder page. 스냅숏 폴더는 공유하도록 지정된 디렉터리일 뿐이며 이 폴더에 읽기/쓰기 작업을 수행하려면 에이전트에게 충분한 액세스 권한이 있어야 합니다.The snapshot folder is simply a directory that you have designated as a share; agents that read from and write to this folder must have sufficient permissions to access it. 폴더의 적절한 보안 유지 방법에 대한 자세한 내용은 스냅숏 폴더 보안 설정을 참조하세요.For more information about securing the folder appropriately, see Secure the Snapshot Folder.

      다른 서버가 배포자의 역할을 하도록 지정한 경우 게시자에서 배포자로 연결할 때 사용할 암호를 관리 암호 페이지에 입력해야 합니다.If you specify that another server should act as the Distributor, you must enter a password on the Administrative Password page for connections made from the Publisher to the Distributor. 이 암호는 원격 배포자에서 게시자를 설정할 때 지정한 암호와 일치해야 합니다.This password must match the password specified when the Publisher was enabled at the remote Distributor.

      자세한 내용은 Configure Distribution를 참조하세요.For more information, see Configure Distribution.

    • 게시 데이터베이스를 선택합니다.Choose a publication database.

    • 보고서 유형을 선택합니다.Select a publication type. 자세한 내용은 복제 유형을 참조하세요.For more information, see Types of Replication.

    • 게시할 데이터와 데이터베이스 개체를 지정합니다. 필요에 따라 테이블 아티클에서 열을 필터링하고 아티클 속성을 설정합니다.Specify data and database objects to publish; optionally filter columns from table articles, and set article properties.

    • 필요에 따라 테이블 아티클에서 행을 필터링합니다.Optionally filter rows from table articles. 자세한 내용은 게시된 데이터 필터링을 참조하세요.For more information, see Filter Published Data.

    • 스냅숏 에이전트 일정을 설정합니다.Set the Snapshot Agent schedule.

    • 다음 복제 에이전트를 실행 및 연결하는 자격 증명을 지정합니다.Specify the credentials under which the following replication agents run and make connections:

      모든 게시에 대한 - 스냅숏 에이전트- Snapshot Agent for all publications.

      모든 트랜잭션 게시에 대한 - 로그 판독기 에이전트- Log Reader Agent for all transactional publications.

      - 구독 업데이트를 허용하는 트랜잭션 게시에 대한 큐 판독기 에이전트- Queue Reader Agent for transactional publications that allow updating subscriptions.

      자세한 내용은 Replication Agent Security ModelReplication Security Best Practices를 참조하세요.For more information, see Replication Agent Security Model and Replication Security Best Practices.

    • 필요에 따라 게시를 스크립팅합니다.Optionally script the publication. 자세한 내용은 Scripting Replication을 참조하세요.For more information, see Scripting Replication.

    • 게시의 이름을 지정합니다.Specify a name for the publication.

Transact-SQL 사용 Using Transact-SQL

복제 저장 프로시저를 사용하여 프로그래밍 방식으로 게시를 만들 수 있습니다.Publications can be created programmatically using replication stored procedures. 사용되는 저장 프로시저는 만들려는 게시의 유형에 따라 달라집니다.The stored procedures that are used will depend on the type of publication being created.

스냅숏 또는 트랜잭션 게시를 만들려면To create a snapshot or transactional publication

  1. 게시 데이터베이스의 게시자에서 sp_replicationdboption(Transact-SQL)을 실행하여 스냅숏 또는 트랜잭션 복제를 사용하여 현재 데이터베이스를 게시할 수 있도록 설정합니다.At the Publisher on the publication database, execute sp_replicationdboption (Transact-SQL) to enable publication of the current database using snapshot or transactional replication.

  2. 트랜잭션 게시의 경우 게시 데이터베이스에 대한 로그 판독기 에이전트 작업이 존재하는지 여부를 확인합니다.For a transactional publication, determine whether a Log Reader Agent job exists for the publication database. 스냅숏 게시의 경우에는 이 단계가 필요하지 않습니다.(This step is not required for snapshot publications.)

    • 게시 데이터베이스에 대한 로그 판독기 에이전트 작업이 존재하면 3단계를 실행합니다.If a Log Reader Agent job exists for the publication database, proceed to step 3.

    • 게시된 데이터베이스에 대해 로그 판독기 에이전트 작업이 존재하는지 확실하지 않으면 게시 데이터베이스의 게시자에서 sp_helplogreader_agent(Transact-SQL)를 실행합니다.If you are unsure whether a Log Reader Agent job exists for a published database, execute sp_helplogreader_agent (Transact-SQL) at the Publisher on the publication database.

    • 결과 집합이 비어 있으면 로그 판독기 에이전트 작업을 만듭니다.If the result set is empty, create a Log Reader Agent job. 게시자에서 sp_addlogreader_agent(Transact-SQL)를 실행합니다.At the Publisher, execute sp_addlogreader_agent (Transact-SQL). @job_name@password에 에이전트가 실행되는 MicrosoftMicrosoft Windows 자격 증명을 지정합니다.Specify the MicrosoftMicrosoft Windows credentials under which the agent runs for @job_name and @password. 게시자에 연결할 때 에이전트가 SQL Server 인증을 사용하면 @publisher_security_mode 에 값 @publisher_security_mode 을 지정하고 MicrosoftMicrosoft SQL ServerSQL Server@publisher_login @password @publisher_password에서 트랜잭션 게시에 대해 구독 업데이트를 설정하는 방법에 대해 설명합니다.If the agent will use SQL 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. 3단계로 진행합니다.Proceed to step 3.

  3. 게시자에서 sp_addpublication(Transact-SQL)을 실행합니다.At the Publisher, execute sp_addpublication (Transact-SQL). @publication에 게시 이름을 지정하고 @repl_freq 매개 변수에 snapshot 값(스냅숏 게시의 경우) 또는 continuous 값(트랜잭션 게시의 경우)을 지정합니다.Specify a publication name for @publication, and, for the @repl_freq parameter, specify a value of snapshot for a snapshot publication or a value of continuous for a transactional publication. 다른 게시 옵션을 지정합니다.Specify any other publication options. 이렇게 하면 게시가 정의됩니다.This defines the publication.

    참고

    게시 이름은 다음과 같은 문자를 포함할 수 없습니다:Publication names cannot include the following characters:

    % * [ ] | : " ?% * [ ] | : " ? \ / < >\ / < >

  4. 게시자에서 sp_addpublication_snapshot(Transact-SQL)을 실행합니다.At the Publisher, execute sp_addpublication_snapshot (Transact-SQL). @publication에 3단계에서 사용된 게시 이름을, @snapshot_job_name@password에 스냅숏 에이전트를 실행하는 데 사용되는 Windows 자격 증명을 지정합니다.Specify the publication name used in step 3 for @publication and the Windows credentials under which the Snapshot Agent runs for @snapshot_job_name and @password. 게시자에 연결할 때 에이전트가 SQL Server 인증을 사용하면 @publisher_security_mode 에 값 @publisher_security_mode 을 지정하고 SQL ServerSQL Server@publisher_login @password @publisher_password에서 트랜잭션 게시에 대해 구독 업데이트를 설정하는 방법에 대해 설명합니다.If the agent will use SQL 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.

    중요

    게시자를 원격 배포자로 구성할 경우 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).

  5. 아티클을 게시에 추가합니다.Add articles to the publication. 자세한 내용은 Define an Article을 참조하세요.For more information, see Define an Article.

  6. 스냅숏 에이전트 작업을 시작하여 이 게시에 대한 초기 스냅숏을 생성합니다.Start the Snapshot Agent job to generate the initial snapshot for this publication. 자세한 내용은 Create and Apply the Initial Snapshot을 참조하세요.For more information, see Create and Apply the Initial Snapshot.

병합 게시를 만들려면To create a merge publication

  1. 게시자에서 sp_replicationdboption(Transact-SQL)을 실행하여 병합 복제를 통해 현재 데이터베이스를 게시할 수 있도록 설정합니다.At the Publisher, execute sp_replicationdboption (Transact-SQL) to enable publication of the current database using merge replication.

  2. 게시 데이터베이스의 게시자에서 sp_addmergepublication(Transact-SQL)을 실행합니다.At the Publisher on the publication database, execute sp_addmergepublication (Transact-SQL). @publication에 게시 이름을 지정하고 기타 게시 옵션을 지정합니다.Specify a name for the publication for @publication and any other publication options. 이렇게 하면 게시가 정의됩니다.This defines the publication.

    참고

    게시 이름은 다음과 같은 문자를 포함할 수 없습니다:Publication names cannot include the following characters:

    % * [ ] | : " ?% * [ ] | : " ? \ / < >\ / < >

  3. 게시자에서 sp_addpublication_snapshot(Transact-SQL)을 실행합니다.At the Publisher, execute sp_addpublication_snapshot (Transact-SQL). @publication에 2단계에서 사용된 게시 이름을, @snapshot_job_name@password에 스냅숏 에이전트를 실행하는 데 사용되는 Windows 자격 증명을 지정합니다.Specify the publication name used in step 2 for @publication and the Windows credentials under which the Snapshot Agent runs for @snapshot_job_name and @password. 게시자에 연결할 때 에이전트가 SQL Server 인증을 사용하면 @publisher_security_mode 에 값 @publisher_security_mode 을 지정하고 SQL ServerSQL Server@publisher_login @password @publisher_password에서 트랜잭션 게시에 대해 구독 업데이트를 설정하는 방법에 대해 설명합니다.If the agent will use SQL 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.

    중요

    게시자를 원격 배포자로 구성할 경우 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).

  4. 아티클을 게시에 추가합니다.Add articles to the publication. 자세한 내용은 Define an Article을 참조하세요.For more information, see Define an Article.

  5. 스냅숏 에이전트 작업을 시작하여 이 게시에 대한 초기 스냅숏을 생성합니다.Start the Snapshot Agent job to generate the initial snapshot for this publication. 자세한 내용은 Create and Apply the Initial Snapshot을 참조하세요.For more information, see Create and Apply the Initial Snapshot.

예(Transact-SQL) Example (Transact-SQL)

다음 예에서는 트랜잭션 게시를 만듭니다.This example creates a transactional publication. 스크립팅 변수는 스냅숏 에이전트 및 로그 판독기 에이전트에 대한 작업을 만드는 데 필요한 Windows 자격 증명을 전달하는 데 사용됩니다.Scripting variables are used to pass Windows credentials that are needed to create jobs for the Snapshot Agent and Log Reader Agent.

-- To avoid storing the login and password in the script file, the values 
-- are passed into SQLCMD as scripting variables. 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".

DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks'; 
SET @publication = N'AdvWorksProductTran'; 
-- Windows account used to run the Log Reader and Snapshot Agents.
SET @login = $(Login); 
-- This should be passed at runtime.
SET @password = $(Password); 

-- Enable transactional or snapshot replication on the publication database.
EXEC sp_replicationdboption 
	@dbname=@publicationDB, 
	@optname=N'publish',
	@value = N'true';

-- Execute sp_addlogreader_agent to create the agent job. 
EXEC sp_addlogreader_agent 
	@job_login = @login, 
	@job_password = @password,
	-- Explicitly specify the use of Windows Integrated Authentication (default) 
	-- when connecting to the Publisher.
	@publisher_security_mode = 1;

-- Create a new transactional publication with the required properties. 
EXEC sp_addpublication 
	@publication = @publication, 
	@status = N'active',
	@allow_push = N'true',
	@allow_pull = N'true',
	@independent_agent = N'true';

-- Create a new snapshot job for the publication, using a default schedule.
EXEC sp_addpublication_snapshot 
	@publication = @publication, 
	@job_login = @login, 
	@job_password = @password,
	-- Explicitly specify the use of Windows Integrated Authentication (default) 
	-- when connecting to the Publisher.
	@publisher_security_mode = 1;
GO

다음 예에서는 병합 게시를 만듭니다.This example creates a merge publication. 스크립팅 변수는 스냅숏 에이전트에 대한 작업을 만드는 데 필요한 Windows 자격 증명을 전달하는 데 사용됩니다.Scripting variables are used to pass Windows credentials that are needed to create the job for the Snapshot Agent.

-- 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".

--Declarations for adding a merge publication
DECLARE @publicationDB AS sysname;
DECLARE @publication AS sysname;
DECLARE @login AS sysname;
DECLARE @password AS sysname;
SET @publicationDB = N'AdventureWorks2012'; 
SET @publication = N'AdvWorksSalesOrdersMerge'; 
SET @login = $(Login);
SET @password = $(Password);

-- Enable merge replication on the publication database, using defaults.
USE master
EXEC sp_replicationdboption 
  @dbname=@publicationDB, 
  @optname=N'merge publish',
  @value = N'true' 

-- Create a new merge publication, explicitly setting the defaults. 
USE [AdventureWorks2012]
EXEC sp_addmergepublication 
-- These parameters are optional.
  @publication = @publication,
  -- optional parameters 
  @description = N'Merge publication of AdventureWorks2012.',
  @publication_compatibility_level  = N'120RTM';

-- Create a new snapshot job for the publication.
EXEC sp_addpublication_snapshot 
  @publication = @publication, 
  @job_login = @login, 
  @job_password = @password;
GO

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

RMO(복제 관리 개체)를 사용하여 프로그래밍 방식으로 게시를 만들 수 있습니다.You can create publications programmatically by using Replication Management Objects (RMO). 게시를 만드는 데 사용하는 RMO 클래스는 만드는 게시 유형에 따라 달라집니다.The RMO classes that you use to create a publication depend on the type of publication you create.

스냅숏 또는 트랜잭션 게시를 만들려면To create a snapshot or transactional publication

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

  2. 게시 데이터베이스에 대해 ReplicationDatabase 클래스의 인스턴스를 만들고, 1단계에서 만든 ServerConnection 인스턴스에 ConnectionContext 속성을 설정한 다음 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, verify that the database exists.

  3. EnabledTransPublishing 속성이 false이면 true로 설정합니다.If the EnabledTransPublishing property is false, set it to true.

  4. 트랜잭션 게시에 대한 LogReaderAgentExists 속성의 값을 확인합니다.For a transactional publication, check the value of the LogReaderAgentExists property. 이 속성이 true이면 이 데이터베이스에 대한 로그 판독기 에이전트 작업이 이미 존재하는 것입니다.If this property is true, a Log Read Agent job already exists for this database. 이 속성이 false이면 다음을 수행합니다.If this property is false, do the following:

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

  6. 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).

  7. CreateSnapshotAgent 메서드를 호출하여 게시에 대한 스냅숏 에이전트 작업을 만듭니다.Call the CreateSnapshotAgent method to create the Snapshot Agent job for the publication.

병합 게시를 만들려면To create a merge publication

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

  2. 게시 데이터베이스에 대해 ReplicationDatabase 클래스의 인스턴스를 만들고, 1단계에서 만든 ServerConnection 인스턴스에 ConnectionContext 속성을 설정한 다음 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, verify 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. CreateSnapshotAgent 메서드를 호출하여 게시에 대한 스냅숏 에이전트 작업을 만듭니다.Call the CreateSnapshotAgent method to create the Snapshot Agent job for the publication.

예(RMO) Examples (RMO)

이 예에서는 AdventureWorks 데이터베이스에서 트랜잭션 게시를 사용할 수 있도록 설정하고 로그 판독기 에이전트 작업을 정의하며 AdvWorksProductTran 게시를 만듭니다.This example enables the AdventureWorks database for transactional publishing, defines a Log Reader Agent job, and creates the AdvWorksProductTran publication. 이 게시에 대한 아티클을 정의해야 합니다.An article must be defined for this publication. 로그 판독기 에이전트 작업 및 스냅숏 에이전트 작업을 만드는 데 필요한 Windows 계정 자격 증명은 런타임에 전달됩니다.The Windows account credentials that are needed to create the Log Reader Agent job and the Snapshot Agent job are passed at runtime. RMO를 사용하여 스냅숏 및 트랜잭션 아티클을 정의하는 방법은 Define an Article를 참조하세요.To learn how to use RMO to define snapshot and transactional articles, see Define an Article.

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

ReplicationDatabase publicationDb;
TransPublication publication;

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


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

	// Enable the AdventureWorks2012 database for transactional publishing.
	publicationDb = new ReplicationDatabase(publicationDbName, conn);

	// If the database exists and is not already enabled, 
	// enable it for transactional publishing.
	if (publicationDb.LoadProperties())
	{
		if (!publicationDb.EnabledTransPublishing)
		{
			publicationDb.EnabledTransPublishing = true;
		}

		// If the Log Reader Agent does not exist, create it.
		if (!publicationDb.LogReaderAgentExists)
		{
			// Specify the Windows account under which the agent job runs.
			// This account will be used for the local connection to the 
			// Distributor and all agent connections that use Windows Authentication.
			publicationDb.LogReaderAgentProcessSecurity.Login = winLogin;
			publicationDb.LogReaderAgentProcessSecurity.Password = winPassword;

			// Explicitly set authentication mode for the Publisher connection
			// to the default value of Windows Authentication.
			publicationDb.LogReaderAgentPublisherSecurity.WindowsAuthentication = true;

			// Create the Log Reader Agent job.
			publicationDb.CreateLogReaderAgent();
		}
	}
	else
	{
		throw new ApplicationException(String.Format(
			"The {0} database does not exist at {1}.",
			publicationDb, publisherName));
	}

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

	// Specify a transactional publication (the default).
	publication.Type = PublicationType.Transactional;

	// Activate the publication so that we can add subscriptions.
	publication.Status = State.Active;

             // Enable push and pull subscriptions and independent Distribition Agents.
             publication.Attributes |= PublicationAttributes.AllowPull;
             publication.Attributes |= PublicationAttributes.AllowPush;
             publication.Attributes |= PublicationAttributes.IndependentAgent;

	// 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;

	if (!publication.IsExistingObject)
	{
		// Create the transactional 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 publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2012"
Dim publisherName As String = publisherInstance

Dim publicationDb As ReplicationDatabase
Dim publication As TransPublication

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

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

    ' Enable the AdventureWorks2012 database for transactional publishing.
    publicationDb = New ReplicationDatabase(publicationDbName, conn)

    ' If the database exists and is not already enabled, 
    ' enable it for transactional publishing.
    If publicationDb.LoadProperties() Then
        If Not publicationDb.EnabledTransPublishing Then
            publicationDb.EnabledTransPublishing = True
        End If

        ' If the Log Reader Agent does not exist, create it.
        If Not publicationDb.LogReaderAgentExists Then
            ' Specify the Windows account under which the agent job runs.
            ' This account will be used for the local connection to the 
            ' Distributor and all agent connections that use Windows Authentication.
            publicationDb.LogReaderAgentProcessSecurity.Login = winLogin
            publicationDb.LogReaderAgentProcessSecurity.Password = winPassword

            ' Explicitly set authentication mode for the Publisher connection
            ' to the default value of Windows Authentication.
            publicationDb.LogReaderAgentPublisherSecurity.WindowsAuthentication = True

            ' Create the Log Reader Agent job.
            publicationDb.CreateLogReaderAgent()
        End If
    Else
        Throw New ApplicationException(String.Format( _
         "The {0} database does not exist at {1}.", _
         publicationDb, publisherName))
    End If

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

    ' Specify a transactional publication (the default).
    publication.Type = PublicationType.Transactional

    'Enable push and pull subscriptions and independent Distribition Agents.
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.AllowPull
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.AllowPush
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.IndependentAgent

    ' Activate the publication so that we can add subscriptions.
    publication.Status = State.Active

    ' 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

    If Not publication.IsExistingObject Then
        ' Create the transactional 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

이 예에서는 AdventureWorks 데이터베이스에서 병합 게시를 사용할 수 있도록 설정하고 AdvWorksSalesOrdersMerge 게시를 만듭니다.This example enables the AdventureWorks database for merge publishing and creates the AdvWorksSalesOrdersMerge publication. 이 게시에 대한 아티클을 정의해야 합니다.Articles must still be defined for this publication. 스냅숏 에이전트 작업을 만드는 데 필요한 Windows 계정 자격 증명은 런타임에 전달됩니다.The Windows account credentials that are needed to create the Snapshot Agent job are passed at runtime. RMO를 사용하여 병합 아티클을 정의하는 방법은 Define an Article를 참조하세요.To learn how to use RMO to define merge articles, see Define an Article.

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

관련 항목:See Also

스크립팅 변수와 함께 sqlcmd 사용 Use sqlcmd with Scripting Variables
데이터 및 데이터베이스 개체 게시 Publish Data and Database Objects
Replication Management Objects Concepts Replication Management Objects Concepts
Define an Article Define an Article
게시 속성 보기 및 수정 View and Modify Publication Properties
배포 구성 Configure Distribution
배포자 보안 설정 Secure the Distributor
게시자 보안 설정Secure the Publisher