ReplicationServer 클래스

정의

복제에 관련된 Microsoft SQL Server 인스턴스를 나타냅니다. 이 인스턴스는 배포자, 게시자 및 구독자 역할을 하거나 각 역할을 조합할 수 있습니다.

public ref class ReplicationServer sealed : Microsoft::SqlServer::Replication::ReplicationObject
[System.Runtime.InteropServices.Guid("94506773-2893-4401-8D6E-8CACCBDE4BDB")]
public sealed class ReplicationServer : Microsoft.SqlServer.Replication.ReplicationObject
[<System.Runtime.InteropServices.Guid("94506773-2893-4401-8D6E-8CACCBDE4BDB")>]
type ReplicationServer = class
    inherit ReplicationObject
Public NotInheritable Class ReplicationServer
Inherits ReplicationObject
상속
ReplicationServer
특성

예제

이 예제에서는 개체를 ReplicationServer 사용하여 게시를 사용하도록 설정하는 방법을 보여 줍니다.

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

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 AdventureWorks2012 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 occured 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 = "AdventureWorks2012"

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 AdventureWorks2012 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 occured when installing distribution and publishing.", ex)

Finally
    conn.Disconnect()

End Try

이 예제에서는 사용 하는 ReplicationServer 방법에 설명 합니다 배포자 속성을 변경 하는 개체입니다.

// Set the Distributor and distribution database names.
string distributionDbName = "distribution";
string distributorName = publisherInstance;

ReplicationServer distributor;
DistributionDatabase distributionDb;

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

try
{
    // Open the connection. 
    conn.Connect();

    distributor = new ReplicationServer(conn);

    // Load Distributor properties, if it is installed.
    if (distributor.LoadProperties())
    {
        // Password supplied at runtime.
        distributor.ChangeDistributorPassword(password);
        distributor.AgentCheckupInterval = 5;

        // Save changes to the Distributor properties.
        distributor.CommitPropertyChanges();
    }
    else
    {
        throw new ApplicationException(
            String.Format("{0} is not a Distributor.", publisherInstance));
    }

    // Create an object for the distribution database 
    // using the open Distributor connection.
    distributionDb = new DistributionDatabase(distributionDbName, conn);

    // Change distribution database properties.
    if (distributionDb.LoadProperties())
    {
        // Change maximum retention period to 48 hours and history retention 
        // period to 24 hours.
        distributionDb.MaxDistributionRetention = 48;
        distributionDb.HistoryRetention = 24;

        // Save changes to the distribution database properties.
        distributionDb.CommitPropertyChanges();
    }
    else
    {
        // Do something here if the distribution database does not exist.
    }
}
catch (Exception ex)
{
    // Implement the appropriate error handling here. 
    throw new ApplicationException("An error occured when changing Distributor " +
        " or distribution database properties.", ex);
}
finally
{
    conn.Disconnect();
}
' Set the Distributor and distribution database names.
Dim distributionDbName As String = "distribution"
Dim distributorName As String = publisherInstance

Dim distributor As ReplicationServer
Dim distributionDb As DistributionDatabase

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

Try
    ' Open the connection. 
    conn.Connect()

    distributor = New ReplicationServer(conn)

    ' Load Distributor properties, if it is installed.
    If distributor.LoadProperties() Then
        ' Password supplied at runtime.
        distributor.ChangeDistributorPassword(password)
        distributor.AgentCheckupInterval = 5

        ' Save changes to the Distributor properties.
        distributor.CommitPropertyChanges()
    Else
        Throw New ApplicationException( _
            String.Format("{0} is not a Distributor.", publisherInstance))
    End If

    ' Create an object for the distribution database 
    ' using the open Distributor connection.
    distributionDb = New DistributionDatabase(distributionDbName, conn)

    ' Change distribution database properties.
    If distributionDb.LoadProperties() Then
        ' Change maximum retention period to 48 hours and history retention 
        ' period to 24 hours.
        distributionDb.MaxDistributionRetention = 48
        distributionDb.HistoryRetention = 24

        ' Save changes to the distribution database properties.
        distributionDb.CommitPropertyChanges()
    Else
        ' Do something here if the distribution database does not exist.
    End If
Catch ex As Exception
    ' Implement the appropriate error handling here. 
    Throw New ApplicationException("An error occured when changing Distributor " + _
        " or distribution database properties.", ex)
Finally
    conn.Disconnect()
End Try

이 예제에서는 개체를 ReplicationServer 사용하여 게시를 사용하지 않도록 설정하는 방법을 보여줍니다.

// Set the Distributor and publication database names.
// Publisher and Distributor are on the same server instance.
string publisherName = publisherInstance;
string distributorName = publisherInstance;
string distributionDbName = "distribution";
string publicationDbName = "AdventureWorks2012";

// Create connections to the Publisher and Distributor
// using Windows Authentication.
ServerConnection publisherConn = new ServerConnection(publisherName);
ServerConnection distributorConn = new ServerConnection(distributorName);

// Create the objects we need.
ReplicationServer distributor =
    new ReplicationServer(distributorConn);
DistributionPublisher publisher;
DistributionDatabase distributionDb =
    new DistributionDatabase(distributionDbName, distributorConn);
ReplicationDatabase publicationDb;
publicationDb = new ReplicationDatabase(publicationDbName, publisherConn);

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

    // Disable all publishing on the AdventureWorks2012 database.
    if (publicationDb.LoadProperties())
    {
        if (publicationDb.EnabledMergePublishing)
        {
            publicationDb.EnabledMergePublishing = false;
        }
        else if (publicationDb.EnabledTransPublishing)
        {
            publicationDb.EnabledTransPublishing = false;
        }
    }
    else
    {
        throw new ApplicationException(
            String.Format("The {0} database does not exist.", publicationDbName));
    }

    // We cannot uninstall the Publisher if there are still Subscribers.
    if (distributor.RegisteredSubscribers.Count == 0)
    {
        // Uninstall the Publisher, if it exists.
        publisher = new DistributionPublisher(publisherName, distributorConn);
        if (publisher.LoadProperties())
        {
            publisher.Remove(false);
        }
        else
        {
            // Do something here if the Publisher does not exist.
            throw new ApplicationException(String.Format(
                "{0} is not a Publisher for {1}.", publisherName, distributorName));
        }

        // Drop the distribution database.
        if (distributionDb.LoadProperties())
        {
            distributionDb.Remove();
        }
        else
        {
            // Do something here if the distribition DB does not exist.
            throw new ApplicationException(String.Format(
                "The distribution database '{0}' does not exist on {1}.",
                distributionDbName, distributorName));
        }

        // Uninstall the Distributor, if it exists.
        if (distributor.LoadProperties())
        {
            // Passing a value of false means that the Publisher 
            // and distribution databases must already be uninstalled,
            // and that no local databases be enabled for publishing.
            distributor.UninstallDistributor(false);
        }
        else
        {
            //Do something here if the distributor does not exist.
            throw new ApplicationException(String.Format(
                "The Distributor '{0}' does not exist.", distributorName));
        }
    }
    else
    {
        throw new ApplicationException("You must first delete all subscriptions.");
    }
}
catch (Exception ex)
{
    // Implement appropriate error handling here.
    throw new ApplicationException("The Publisher and Distributor could not be uninstalled", ex);
}
finally
{
    publisherConn.Disconnect();
    distributorConn.Disconnect();
}
' Set the Distributor and publication database names.
' Publisher and Distributor are on the same server instance.
Dim publisherName As String = publisherInstance
Dim distributorName As String = subscriberInstance
Dim distributionDbName As String = "distribution"
Dim publicationDbName As String = "AdventureWorks2012"

' Create connections to the Publisher and Distributor
' using Windows Authentication.
Dim publisherConn As ServerConnection = New ServerConnection(publisherName)
Dim distributorConn As ServerConnection = New ServerConnection(distributorName)

' Create the objects we need.
Dim distributor As ReplicationServer
distributor = New ReplicationServer(distributorConn)
Dim publisher As DistributionPublisher
Dim distributionDb As DistributionDatabase
distributionDb = New DistributionDatabase(distributionDbName, distributorConn)
Dim publicationDb As ReplicationDatabase
publicationDb = New ReplicationDatabase(publicationDbName, publisherConn)

Try
    ' Connect to the Publisher and Distributor.
    publisherConn.Connect()
    distributorConn.Connect()

    ' Disable all publishing on the AdventureWorks2012 database.
    If publicationDb.LoadProperties() Then
        If publicationDb.EnabledMergePublishing Then
            publicationDb.EnabledMergePublishing = False
        ElseIf publicationDb.EnabledTransPublishing Then
            publicationDb.EnabledTransPublishing = False
        End If
    Else
        Throw New ApplicationException( _
            String.Format("The {0} database does not exist.", publicationDbName))
    End If

    ' We cannot uninstall the Publisher if there are still Subscribers.
    If distributor.RegisteredSubscribers.Count = 0 Then
        ' Uninstall the Publisher, if it exists.
        publisher = New DistributionPublisher(publisherName, distributorConn)
        If publisher.LoadProperties() Then
            publisher.Remove(False)
        Else
            ' Do something here if the Publisher does not exist.
            Throw New ApplicationException(String.Format( _
                "{0} is not a Publisher for {1}.", publisherName, distributorName))
        End If

        ' Drop the distribution database.
        If distributionDb.LoadProperties() Then
            distributionDb.Remove()
        Else
            ' Do something here if the distribition DB does not exist.
            Throw New ApplicationException(String.Format( _
             "The distribution database '{0}' does not exist on {1}.", _
             distributionDbName, distributorName))
        End If

        ' Uninstall the Distributor, if it exists.
        If distributor.LoadProperties() Then
            ' Passing a value of false means that the Publisher 
            ' and distribution databases must already be uninstalled,
            ' and that no local databases be enabled for publishing.
            distributor.UninstallDistributor(False)
        Else
            'Do something here if the distributor does not exist.
            Throw New ApplicationException(String.Format( _
                "The Distributor '{0}' does not exist.", distributorName))
        End If
    Else
        Throw New ApplicationException("You must first delete all subscriptions.")
    End If

Catch ex As Exception
    ' Implement appropriate error handling here.
    Throw New ApplicationException("The Publisher and Distributor could not be uninstalled", ex)

Finally
    publisherConn.Disconnect()
    distributorConn.Disconnect()

End Try

설명

스레드 보안

이 형식의 모든 공용 정적(Shared Microsoft Visual Basic의 경우) 멤버는 다중 스레드 작업에 안전합니다. 인스턴스 구성원은 스레드로부터의 안전성이 보장되지 않습니다.

생성자

ReplicationServer()

ReplicationServer 클래스의 새 인스턴스를 초기화합니다.

ReplicationServer(ServerConnection)

Microsoft SQL Server 인스턴스 ReplicationServer 와의 연결을 설정하는 데 사용되는 지정된 연결 컨텍스트를 사용하여 클래스의 새 인스턴스를 초기화합니다.

속성

AgentCheckupInterval

배포 에이전트에서 점검을 수행하는 간격을 가져오거나 설정합니다.

CachePropertyChanges

복제 속성에 대한 변경 내용을 캐시할지 아니면 즉시 적용할지를 가져오거나 설정합니다.

(다음에서 상속됨 ReplicationObject)
ConnectionContext

Microsoft SQL Server 인스턴스에 대한 연결을 가져오거나 설정합니다.

(다음에서 상속됨 ReplicationObject)
DistributionDatabase

현재 연결된 SQL Server 인스턴스에 대한 배포 데이터베이스의 이름을 가져옵니다.

DistributionDatabases

복제 서버에 정의된 배포 데이터베이스를 가져옵니다.

DistributionPublishers

Microsoft SQL Server 현재 연결된 인스턴스를 배포자로 사용하는 게시자를 가져옵니다.

DistributionServer

현재 연결된 SQL Server 인스턴스의 배포자 이름을 가져오거나 설정합니다.

DistributorAvailable

현재 연결된 Microsoft SQL Server 인스턴스의 배포자를 현재 연결하고 사용할 수 있는지 여부를 가져옵니다.

DistributorInstalled

현재 연결된 SQL Server 인스턴스에 로컬 배포자 또는 원격 배포자인지 여부를 가져옵니다.

HasRemotePublisher

Microsoft SQL Server 현재 연결된 인스턴스가 원격 게시자가 있는 배포자인지 여부를 가져옵니다.

IsDistributor

현재 연결된 SQL Server 인스턴스가 배포자인지 여부를 가져옵니다.

IsExistingObject

서버에 개체가 있는지 여부를 가져옵니다.

(다음에서 상속됨 ReplicationObject)
IsPublisher

Microsoft SQL Server 현재 연결된 인스턴스가 게시자인지 여부를 가져옵니다.

Name

Microsoft SQL Server 인스턴스의 이름을 가져옵니다.

RegisteredSubscribers

게시자에 등록된 구독자를 가져옵니다.

ReplicationDatabases

Microsoft SQL Server 연결된 인스턴스에서 복제를 사용하도록 설정된 데이터베이스를 가져옵니다.

SqlServerName

이 개체가 연결된 Microsoft SQL Server 인스턴스의 이름을 가져옵니다.

(다음에서 상속됨 ReplicationObject)
UserData

사용자가 자신의 고유 데이터를 개체에 연결할 수 있도록 하는 개체 속성을 가져오거나 설정합니다.

(다음에서 상속됨 ReplicationObject)
WorkingDirectory

게시자에 사용되는 작업 디렉터리를 가져옵니다.

메서드

AttachSubscriptionDatabase(String, String, ConnectionSecurityContext)

복사된 구독 데이터베이스를 구독자에서 연결합니다.

ChangeDistributorPassword(SecureString)

새 암호가 SecureString 개체로 제공되는 경우 배포자 암호를 변경합니다.

ChangeDistributorPassword(String)

배포자 암호를 변경합니다.

ChangeReplicationServerPasswords(ReplicationSecurityMode, String, SecureString)

SecureString 개체를 사용하여 복제 서버에서 유지 관리되는 로그인 암호의 저장된 모든 인스턴스를 변경합니다.

ChangeReplicationServerPasswords(ReplicationSecurityMode, String, String)

복제 서버에서 유지 관리되는 로그인 암호의 저장된 모든 인스턴스를 변경합니다.

CheckValidCreation()

유효한 복제 만들기를 확인합니다.

(다음에서 상속됨 ReplicationObject)
CheckValidDefinition(Boolean)

정의가 유효한지 여부를 나타냅니다.

(다음에서 상속됨 ReplicationObject)
CommitPropertyChanges()

캐시된 모든 속성 변경 문을 Microsoft SQL Server 인스턴스로 보냅니다.

(다음에서 상속됨 ReplicationObject)
CopySubscriptionDatabase(String, String, Boolean)

기존 끌어오기 구독 데이터베이스를 복사합니다.

Decouple()

참조된 복제 개체를 서버에서 분리합니다.

(다음에서 상속됨 ReplicationObject)
EnumAgentProfiles(AgentType)

서버에서 지원되는 복제 에이전트 성능 프로필을 반환합니다.

EnumBusinessLogicHandlers()

서버에 등록된 비즈니스 논리 처리기를 반환합니다.

EnumCurrentPrincipals()

데이터베이스 미러링에 참여하는 게시된 모든 데이터베이스의 정보를 반환합니다.

EnumCustomResolvers()

SQL Server 연결된 인스턴스에 등록된 모든 사용자 지정 충돌 해결 프로그램을 반환합니다.

EnumDistributionDatabases()

현재 연결된 Microsoft SQL Server 인스턴스가 배포자일 때 설치된 배포 데이터베이스를 반환합니다.

EnumDistributionPublishers()

Microsoft SQL Server 현재 연결된 인스턴스를 배포자로 사용하여 게시자를 반환합니다.

EnumHeterogeneousColumns(String, String, String)

SQL Server 아닌 게시자의 테이블에 있는 열을 반환합니다.

EnumHeterogeneousTables(String)

SQL Server 아닌 게시자에서 사용 가능한 테이블을 반환합니다.

EnumLightPublications(String, Int32, Boolean, Boolean)

가벼운 게시를 반환합니다.

EnumRegisteredSubscribers()

게시자에 등록된 구독자를 반환합니다.

EnumReplicationDatabases()

복제에 사용할 수 있는 데이터베이스를 반환합니다.

EnumSubscriberSubscriptions(String, Int32)

구독자 서버에서 구독을 반환합니다.

GetChangeCommand(StringBuilder, String, String)

복제에서 변경 명령을 반환합니다.

(다음에서 상속됨 ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)

복제에서 생성 명령을 반환합니다.

(다음에서 상속됨 ReplicationObject)
GetCurrentPrincipal(String)

지정된 게시 데이터베이스에 대한 현재 데이터베이스 미러링 주체를 반환합니다.

GetDropCommand(StringBuilder, Boolean)

복제에서 삭제 명령을 반환합니다.

(다음에서 상속됨 ReplicationObject)
GetOriginalPublisher(String)

데이터베이스 미러링 세션에 참여하는 게시된 데이터베이스의 원래 게시자 이름을 반환합니다.

InstallDistributor(SecureString, DistributionDatabase)

현재 연결된 Microsoft SQL Server 인스턴스에 배포자를 설치합니다. 여기서 암호는 개체를 SecureString 사용하여 지정됩니다.

InstallDistributor(String, DistributionDatabase)

현재 연결된 Microsoft SQL Server 인스턴스에 배포자를 설치합니다.

InstallDistributor(String, SecureString)

SecureString 개체를 사용하여 암호가 지정된 경우 원격 배포자를 등록합니다.

InstallDistributor(String, String)

원격 배포자를 등록합니다.

InternalRefresh(Boolean)

복제에서 내부 새로 고침을 시작합니다.

(다음에서 상속됨 ReplicationObject)
Load()

서버에서 기존 개체의 속성을 로드합니다.

(다음에서 상속됨 ReplicationObject)
LoadProperties()

서버에서 기존 개체의 속성을 로드합니다.

(다음에서 상속됨 ReplicationObject)
Refresh()

개체의 속성을 다시 로드합니다.

(다음에서 상속됨 ReplicationObject)
Script(ScriptOptions)

서버에 복제를 설치하거나 제거하는 Transact-SQL 스크립트를 반환합니다.

ScriptInstallDistributor(String, ScriptOptions)

배포자를 설치하는 Transact-SQL 스크립트를 반환합니다.

ScriptUninstallDistributor(ScriptOptions)

배포자를 제거하는 데 사용할 수 있는 Transact-SQL 스크립트를 반환합니다.

UninstallDistributor(Boolean)

현재 연결된 SQL Server 인스턴스에서 복제 게시 및 배포를 제거합니다.

적용 대상

추가 정보