게시 및 배포 구성

적용 대상: SQL Server Azure SQL Managed Instance

이 항목에서는 SQL Server Management Studio, Transact-SQL 또는 RMO(복제 관리 개체)를 사용하여 SQL Server에서 게시 및 배포를 구성하는 방법에 대해 설명합니다.

시작하기 전에

보안

자세한 내용은 복제 보안 설정 보기 및 수정을 참조하세요.

SQL Server Management Studio 사용

새 게시 마법사 또는 배포 구성 마법사를 사용하여 배포를 구성합니다. 배포자를 구성한 다음 배포자 속성 - <배포자> 대화 상자에서 속성을 확인하고 수정합니다. 고정 데이터베이스 역할의 db_owner 멤버가 게시를 만들 수 있도록 배포자를 구성하거나 게시자가 아닌 원격 배포자를 구성하려는 경우 배포 구성 마법사를 사용합니다.

배포를 구성하려면

1. Microsoft SQL Server Management Studio에서 배포자가 될 서버에 연결한 다음 서버 노드를 확장합니다. 게시자와 배포자가 같은 서버인 경우가 많습니다.

2. 복제 폴더를 마우스 오른쪽 단추로 클릭한 다음 배포 구성을 클릭합니다.

3. 배포 구성 마법사에 따라 다음을 수행하세요.

• 배포자를 선택합니다. 로컬 배포자를 사용하려면, ServerName을 자체 배포자로 사용합니다. SQL Server에서 배포 데이터베이스와 로그를 만듭니다. 원격 배포자를 사용하려면 다음 서버를 배포자로 사용을 선택한 다음 서버를 선택합니다. 서버는 미리 배포자로 구성되어 있어야 하며 해당 배포자를 사용하도록 게시자를 설정해야 합니다. 자세한 내용은 배포자에서 원격 게시자 설정(SQL Server Management Studio)을 참조하세요.

  원격 배포자를 선택하면, 배포자 비밀번호 페이지에서 이러한 게시자에서 배포자로 연결할 때 사용될 비밀번호를 입력해야 합니다. 이 암호는 원격 배포자에서 게시자를 사용할 때 지정한 비밀번호와 일치해야 합니다.

• 루트 스냅샷 폴더(로컬 배포자에 대해)를 지정합니다. 스냅샷 폴더는 단순히 공유로 지정한 디렉터리이며 이 폴더에 읽기/쓰기 작업을 수행하려면 에이전트에게 충분한 액세스 권한이 있어야 합니다. 이 배포자를 사용하는 각 게시자는 루트 폴더 아래에 폴더를 만들고 각 게시는 스냅샷 파일을 저장할 게시자 폴더 아래에 폴더를 만듭니다. 폴더의 적절한 보안 유지 방법에 대한 자세한 내용은 스냅샷 폴더 보안 설정을 참조하세요.

• 배포 데이터베이스를 지정합니다(로컬 배포자의 경우). 배포 데이터베이스는 트랜잭션 복제에 대한 모든 유형의 복제 및 트랜잭션에 대한 메타데이터와 기록 데이터를 저장합니다.

• 필요에 따라 배포자를 사용할 수 있도록 다른 게시자를 설정합니다. 배포자를 사용할 수 있도록 다른 게시자를 설정한 경우 배포자 암호 페이지에서 이러한 게시자에서 배포자로 연결할 때 사용될 암호를 입력해야 합니다.

• 필요에 따라 구성 설정을 스크립팅합니다. 자세한 내용은 복제 스크립팅을 참조하세요.

Transact-SQL 사용

복제 저장 프로시저를 사용하여 프로그래밍 방식으로 복제 게시 및 배포를 구성할 수 있습니다.

로컬 배포자를 사용하여 게시를 구성하려면

1. sp_get_distributor (Transact-SQL)를 실행하여 서버가 배포자로 이미 구성되어 있는지 확인합니다.

• 결과 집합의 installed 값이 0면 master 데이터베이스의 배포자에서sp_adddistributor(Transact-SQL)를 실행합니다.

• 결과 집합의 distribution db installed 값이0면 master 데이터베이스의 배포자에서 sp_adddistributor (Transact-SQL)를 실행합니다. 이때 @database에 배포 데이터베이스의 이름을 지정합니다. 필요에 따라 @max_distretention에 최대 트랜잭션 보존 기간을 지정하고 @history_retention에 기록 보존 기간을 지정할 수 있습니다. 새 데이터베이스를 만드는 경우 원하는 데이터베이스 속성 매개 변수를 지정합니다.

2. 게시자이기도 한 배포자에서 기본 스냅샷 폴더@working_directory로 사용할 UNC 공유를 지정하여 sp_adddistpublisher(Transact-SQL)를 실행합니다.

   SQL Managed Instance의 배포자의 경우 @working_directory에 대해 Azure 스토리지 계정 및 @storage_connection_string에 대해 스토리지 액세스 키를 사용합니다.

3. 게시자에서 sp_replicationdboption (Transact-SQL)를 실행합니다. 이때 @dbname에 게시할 데이터베이스를 지정하고 @optname에 복제 유형을 지정하며 true에 @value 값을 지정합니다.

원격 배포자를 사용하여 게시를 구성하려면

1. sp_get_distributor (Transact-SQL)를 실행하여 서버가 배포자로 이미 구성되어 있는지 확인합니다.

   • 결과 집합의 installed 값이 0면 master 데이터베이스의 배포자에서sp_adddistributor(Transact-SQL)를 실행합니다. 이때 @password을 참조하세요. 이 암호는 distributor_admin 계정의 암호로 배포자에 연결할 때 게시자에서 사용됩니다.

   • 결과 집합의 distribution db installed 값이0면 master 데이터베이스의 배포자에서 sp_adddistributor (Transact-SQL)를 실행합니다. 이때 @database에 배포 데이터베이스의 이름을 지정합니다. 필요에 따라 @max_distretention에 최대 트랜잭션 보존 기간을 지정하고 @history_retention에 기록 보존 기간을 지정할 수 있습니다. 새 데이터베이스를 만드는 경우 원하는 데이터베이스 속성 매개 변수를 지정합니다.

2. 배포자에서 @working_directory에 대한 기본 스냅샷 폴더로 사용할 UNC 공유를 지정하여 sp_adddistpublisher (Transact-SQL)를 실행합니다. 게시자에 연결할 때 배포자가 SQL Server 인증을 사용하면 0에 @security_mode 값을 지정하고 @login 및 @password에 로그인 정보를 지정해야 합니다.

   SQL Managed Instance의 배포자의 경우 @working_directory에 대해 Azure 스토리지 계정 및 @storage_connection_string에 대해 스토리지 액세스 키를 사용합니다.

3. 게시 데이터베이스의 게시자에서 sp_adddistributor (Transact-SQL)을 실행합니다. 이때 @password을 참조하세요. 이 비밀번호는 배포자에 연결할 때 게시자에서 사용됩니다.

4. 게시자에서 sp_replicationdboption (Transact-SQL)를 실행합니다. 이때 @dbname에 게시할 데이터베이스를 지정하고 @optname에 복제 유형을 지정하며 @value에 true값을 지정합니다.

예(Transact-SQL)

다음 예제에서는 게시 및 배포를 프로그래밍 방식으로 구성하는 방법을 보여 줍니다. 이 예제에서는 게시자 및 로컬 배포자로 구성되는 서버의 이름이 스크립팅 변수를 사용하여 제공됩니다. 복제 저장 프로시저를 사용하여 프로그래밍 방식으로 복제 게시 및 배포를 구성할 수 있습니다.

-- This script uses sqlcmd scripting variables. They are in the form
-- $(MyVariable). 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".

-- Install the Distributor and the distribution database.
DECLARE @distributor AS sysname;
DECLARE @distributionDB AS sysname;
DECLARE @publisher AS sysname;
DECLARE @directory AS nvarchar(500);
DECLARE @publicationDB AS sysname;
-- Specify the Distributor name.
SET @distributor = $(DistPubServer);
-- Specify the distribution database.
SET @distributionDB = N'distribution';
-- Specify the Publisher name.
SET @publisher = $(DistPubServer);
-- Specify the replication working directory.
SET @directory = N'\\' + $(DistPubServer) + '\repldata';
-- Specify the publication database.
SET @publicationDB = N'AdventureWorks2022'; 

-- Install the server MYDISTPUB as a Distributor using the defaults,
-- including autogenerating the distributor password.
USE master
EXEC sp_adddistributor @distributor = @distributor;

-- Create a new distribution database using the defaults, including
-- using Windows Authentication.
USE master
EXEC sp_adddistributiondb @database = @distributionDB, 
    @security_mode = 1;
GO

-- Create a Publisher and enable AdventureWorks2022 for replication.
-- Add MYDISTPUB as a publisher with MYDISTPUB as a local distributor
-- and use Windows Authentication.
DECLARE @distributionDB AS sysname;
DECLARE @publisher AS sysname;
-- Specify the distribution database.
SET @distributionDB = N'distribution';
-- Specify the Publisher name.
SET @publisher = $(DistPubServer);

USE [distribution]
EXEC sp_adddistpublisher @publisher=@publisher, 
    @distribution_db=@distributionDB, 
    @security_mode = 1;
GO

RMO(복제 관리 개체) 사용

단일 서버에서 게시 및 배포를 구성하려면

1. ServerConnection 클래스를 사용하여 서버에 대한 연결을 만듭니다.

2. ReplicationServer 클래스의 인스턴스를 만듭니다. 1단계에서 만든 ServerConnection 을 전달합니다.

3. DistributionDatabase 클래스의 인스턴스를 만듭니다.

4. Name 속성을 데이터베이스 이름으로 설정하고 1단계의 ConnectionContext를 ServerConnection 속성으로 설정합니다.

5. InstallDistributor 메서드를 호출하여 배포자를 설치합니다. 3단계에서 만든 DistributionDatabase 개체를 전달합니다.

6. DistributionPublisher 클래스의 인스턴스를 만듭니다.

7. 다음과 같이 DistributionPublisher 속성을 설정합니다.

• Name - 게시자의 이름

• ConnectionContext- 1단계의 ServerConnection

• DistributionDatabase - 5단계에서 만든 데이터베이스 이름을 클릭합니다.

• WorkingDirectory - 스냅샷 파일에 액세스하는 데 사용되는 공유입니다.

• PublisherSecurity - 게시자에 연결할 때 사용되는 보안 모드입니다. WindowsAuthentication 을 사용하는 것이 좋습니다.

8. Create 메서드를 호출합니다.

원격 배포자를 사용하여 게시 및 배포를 구성하려면

1. ServerConnection 클래스를 사용하여 원격 배포자 서버 연결을 만듭니다.

2. ReplicationServer 클래스의 인스턴스를 만듭니다. 1단계에서 만든 ServerConnection 을 전달합니다.

3. DistributionDatabase 클래스의 인스턴스를 만듭니다.

4. Name 속성을 데이터베이스 이름으로 설정하고 1단계의 ConnectionContext를 ServerConnection속성으로 설정합니다.

5. InstallDistributor 메서드를 호출하여 배포자를 설치합니다. 보안 암호(원격 배포자에 연결할 때 게시자가 사용) 및 3단계의 DistributionDatabase 개체를 지정합니다. 자세한 내용은 배포자 보안을 참조하세요.

   Important

   가능한 경우 런타임 시 사용자에게 보안 자격 증명을 입력하라는 메시지가 표시됩니다. 자격 증명을 저장해야 하는 경우 Microsoft Windows .NET Framework에서 제공하는 암호화 서비스를 사용합니다.

6. DistributionPublisher 클래스의 인스턴스를 만듭니다.

7. 다음과 같이 DistributionPublisher 속성을 설정합니다.

• Name - 로컬 게시자 서버의 이름입니다.

• ConnectionContext- 1단계의 ServerConnection

• DistributionDatabase - 5단계에서 만든 데이터베이스 이름을 클릭합니다.

• WorkingDirectory - 스냅샷 파일에 액세스하는 데 사용되는 공유입니다.

• PublisherSecurity - 게시자에 연결할 때 사용되는 보안 모드입니다. WindowsAuthentication 을 사용하는 것이 좋습니다.

8. Create 메서드를 호출합니다.

9. ServerConnection 클래스를 사용하여 로컬 게시자 서버 연결을 만듭니다.

10. ReplicationServer 클래스의 인스턴스를 만듭니다. 9단계에서 만든 ServerConnection 을 전달합니다.

11. InstallDistributor 메서드를 호출합니다. 5단계에서 지정한 원격 배포자의 이름과 원격 배포자의 비밀번호를 전달합니다.

Important

가능한 경우 런타임 시 사용자에게 보안 자격 증명을 입력하라는 메시지가 표시됩니다. 자격 증명을 저장해야 하는 경우 Windows .NET Framework에서 제공하는 암호화 서비스를 사용합니다.

예제(RMO)

RMO(복제 관리 개체)를 사용하여 프로그래밍 방식으로 복제 게시 및 배포를 구성할 수 있습니다.

// Set the server and database names
string distributionDbName = "distribution";
string publisherName = publisherInstance;
string publicationDbName = "AdventureWorks2022";

DistributionDatabase distributionDb;
ReplicationServer distributor;
DistributionPublisher publisher;
ReplicationDatabase publicationDb;

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

try
{
    // Connect to the server acting as the Distributor 
    // and local Publisher.
    conn.Connect();

    // Define the distribution database at the Distributor,
    // but do not create it now.
    distributionDb = new DistributionDatabase(distributionDbName, conn);
    distributionDb.MaxDistributionRetention = 96;
    distributionDb.HistoryRetention = 120;

    // Set the Distributor properties and install the Distributor.
    // This also creates the specified distribution database.
    distributor = new ReplicationServer(conn);
    distributor.InstallDistributor((string)null, distributionDb);

    // Set the Publisher properties and install the Publisher.
    publisher = new DistributionPublisher(publisherName, conn);
    publisher.DistributionDatabase = distributionDb.Name;
    publisher.WorkingDirectory = @"\\" + publisherName + @"\repldata";
    publisher.PublisherSecurity.WindowsAuthentication = true;
    publisher.Create();

    // Enable AdventureWorks2022 as a publication database.
    publicationDb = new ReplicationDatabase(publicationDbName, conn);

    publicationDb.EnabledTransPublishing = true;
    publicationDb.EnabledMergePublishing = true;
}
catch (Exception ex)
{
    // Implement appropriate error handling here.
    throw new ApplicationException("An error occurred when installing distribution and publishing.", ex);
}
finally
{
    conn.Disconnect();
}

' Set the server and database names
Dim distributionDbName As String = "distribution"
Dim publisherName As String = publisherInstance
Dim publicationDbName As String = "AdventureWorks2022"

Dim distributionDb As DistributionDatabase
Dim distributor As ReplicationServer
Dim publisher As DistributionPublisher
Dim publicationDb As ReplicationDatabase

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

Try
    ' Connect to the server acting as the Distributor 
    ' and local Publisher.
    conn.Connect()

    ' Define the distribution database at the Distributor,
    ' but do not create it now.
    distributionDb = New DistributionDatabase(distributionDbName, conn)
    distributionDb.MaxDistributionRetention = 96
    distributionDb.HistoryRetention = 120

    ' Set the Distributor properties and install the Distributor.
    ' This also creates the specified distribution database.
    distributor = New ReplicationServer(conn)
    distributor.InstallDistributor((CType(Nothing, String)), distributionDb)

    ' Set the Publisher properties and install the Publisher.
    publisher = New DistributionPublisher(publisherName, conn)
    publisher.DistributionDatabase = distributionDb.Name
    publisher.WorkingDirectory = "\\" + publisherName + "\repldata"
    publisher.PublisherSecurity.WindowsAuthentication = True
    publisher.Create()

    ' Enable AdventureWorks2022 as a publication database.
    publicationDb = New ReplicationDatabase(publicationDbName, conn)

    publicationDb.EnabledTransPublishing = True
    publicationDb.EnabledMergePublishing = True

Catch ex As Exception
    ' Implement appropriate error handling here.
    Throw New ApplicationException("An error occurred when installing distribution and publishing.", ex)

Finally
    conn.Disconnect()

End Try

참고 항목

배포자 및 게시자 속성 보기 및 수정
Replication System Stored Procedures Concepts
배포 구성
Replication Management Objects Concepts
Always On 가용성 그룹에 대한 복제 구성(SQL Server)