TransPullSubscription 클래스

정의

트랜잭션 게시에 대한 끌어오기 구독을 나타냅니다.

public ref class TransPullSubscription sealed : Microsoft::SqlServer::Replication::PullSubscription
public sealed class TransPullSubscription : Microsoft.SqlServer.Replication.PullSubscription
type TransPullSubscription = class
    inherit PullSubscription
Public NotInheritable Class TransPullSubscription
Inherits PullSubscription
상속
TransPullSubscription

예제

// Define the Publisher, publication, and databases.
string publicationName = "AdvWorksProductTran";
string publisherName = publisherInstance;
string subscriberName = subscriberInstance;
string subscriptionDbName = "AdventureWorks2012Replica";
string publicationDbName = "AdventureWorks2012";

//Create connections to the Publisher and Subscriber.
ServerConnection subscriberConn = new ServerConnection(subscriberName);
ServerConnection publisherConn = new ServerConnection(publisherName);

// Create the objects that we need.
TransPublication publication;
TransPullSubscription subscription;

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

    // Ensure that the publication exists and that 
    // it supports pull subscriptions.
    publication = new TransPublication();
    publication.Name = publicationName;
    publication.DatabaseName = publicationDbName;
    publication.ConnectionContext = publisherConn;

    if (publication.IsExistingObject)
    {
        if ((publication.Attributes & PublicationAttributes.AllowPull) == 0)
        {
            publication.Attributes |= PublicationAttributes.AllowPull;
        }

        // Define the pull subscription.
        subscription = new TransPullSubscription();
        subscription.ConnectionContext = subscriberConn;
        subscription.PublisherName = publisherName;
        subscription.PublicationName = publicationName;
        subscription.PublicationDBName = publicationDbName;
        subscription.DatabaseName = subscriptionDbName;

        // Specify the Windows login credentials for the Distribution Agent job.
        subscription.SynchronizationAgentProcessSecurity.Login = winLogin;
        subscription.SynchronizationAgentProcessSecurity.Password = winPassword;

        // Make sure that the agent job for the subscription is created.
        subscription.CreateSyncAgentByDefault = true;

        // By default, subscriptions to transactional publications are synchronized 
        // continuously, but in this case we only want to synchronize on demand.
        subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand;

        // Create the pull subscription at the Subscriber.
        subscription.Create();

        Boolean registered = false;

        // Verify that the subscription is not already registered.
        foreach (TransSubscription existing
            in publication.EnumSubscriptions())
        {
            if (existing.SubscriberName == subscriberName
                && existing.SubscriptionDBName == subscriptionDbName)
            {
                registered = true;
            }
        }
        if (!registered)
        {
            // Register the subscription with the Publisher.
            publication.MakePullSubscriptionWellKnown(
                subscriberName, subscriptionDbName,
                SubscriptionSyncType.Automatic,
                TransSubscriberType.ReadOnly);
        }
    }
    else
    {
        // Do something here if the publication does not exist.
        throw new ApplicationException(String.Format(
            "The publication '{0}' does not exist on {1}.",
            publicationName, publisherName));
    }
}
catch (Exception ex)
{
    // Implement the appropriate error handling here.
    throw new ApplicationException(String.Format(
        "The subscription to {0} could not be created.", publicationName), ex);
}
finally
{
    subscriberConn.Disconnect();
    publisherConn.Disconnect();
}
' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksProductTran"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"

'Create connections to the Publisher and Subscriber.
Dim subscriberConn As ServerConnection = New ServerConnection(subscriberName)
Dim publisherConn As ServerConnection = New ServerConnection(publisherName)

' Create the objects that we need.
Dim publication As TransPublication
Dim subscription As TransPullSubscription

Try
    ' Connect to the Publisher and Subscriber.
    subscriberConn.Connect()
    publisherConn.Connect()

    ' Ensure that the publication exists and that 
    ' it supports pull subscriptions.
    publication = New TransPublication()
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName
    publication.ConnectionContext = publisherConn

    If publication.IsExistingObject Then
        If (publication.Attributes And PublicationAttributes.AllowPull) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowPull
        End If

        ' Define the pull subscription.
        subscription = New TransPullSubscription()
        subscription.ConnectionContext = subscriberConn
        subscription.PublisherName = publisherName
        subscription.PublicationName = publicationName
        subscription.PublicationDBName = publicationDbName
        subscription.DatabaseName = subscriptionDbName
        subscription.Description = "Pull subscription to " + publicationDbName _
        + " on " + subscriberName + "."

        ' Specify the Windows login credentials for the Distribution Agent job.
        subscription.SynchronizationAgentProcessSecurity.Login = winLogin
        subscription.SynchronizationAgentProcessSecurity.Password = winPassword

        ' Make sure that the agent job for the subscription is created.
        subscription.CreateSyncAgentByDefault = True

        ' By default, subscriptions to transactional publications are synchronized 
        ' continuously, but in this case we only want to synchronize on demand.
        subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand

        ' Create the pull subscription at the Subscriber.
        subscription.Create()

        Dim registered As Boolean = False

        ' Verify that the subscription is not already registered.
        For Each existing As TransSubscription In publication.EnumSubscriptions()
            If existing.SubscriberName = subscriberName And _
                existing.SubscriptionDBName = subscriptionDbName Then
                registered = True
            End If
        Next existing
        If Not registered Then
            ' Register the subscription with the Publisher.
            publication.MakePullSubscriptionWellKnown( _
             subscriberName, subscriptionDbName, _
             SubscriptionSyncType.Automatic, _
             TransSubscriberType.ReadOnly)
        End If
    Else
        ' Do something here if the publication does not exist.
        Throw New ApplicationException(String.Format( _
         "The publication '{0}' does not exist on {1}.", _
         publicationName, publisherName))
    End If
Catch ex As Exception
    ' Implement the appropriate error handling here.
    Throw New ApplicationException(String.Format( _
        "The subscription to {0} could not be created.", publicationName), ex)
Finally
    subscriberConn.Disconnect()
    publisherConn.Disconnect()
End Try

설명

끌어오기 구독의 경우 배포 에이전트 구독자에서 실행됩니다.

스레드 보안

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

생성자

TransPullSubscription()

TransPullSubscription 클래스의 새 인스턴스를 만듭니다.

TransPullSubscription(String, String, String, String, ServerConnection)

끌어오기 구독을 정의하는 속성을 사용하여 TransPullSubscription 클래스의 새 인스턴스를 만듭니다.

TransPullSubscription(String, String, String, String, ServerConnection, Boolean)

끌어오기 구독을 정의하는 속성 및 구독에 대한 에이전트 작업을 만들지 여부를 사용하여 TransPullSubscription 클래스의 새 인스턴스를 만듭니다.

속성

AgentJobId

구독을 동기화하는 데 사용되는 에이전트 작업의 ID를 가져옵니다.

(다음에서 상속됨 PullSubscription)
AgentOffload

동기화 에이전트가 에이전트 작업이 만들어진 컴퓨터가 아닌 다른 컴퓨터에서 실행되는지 여부를 가져오거나 설정합니다. 이 속성은 Microsoft SQL Server 2005 이상을 실행하는 배포자에 대해 더 이상 지원되지 않습니다.

(다음에서 상속됨 PullSubscription)
AgentOffloadServer

원격 에이전트 활성화를 사용하는 경우 에이전트가 실행되는 원격 컴퓨터의 이름을 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
AgentSchedule

구독을 동기화하는 데 사용되는 에이전트 작업의 일정을 가져옵니다.

(다음에서 상속됨 PullSubscription)
AltSnapshotFolder

배포자에서 기본 스냅샷 위치가 사용되지 않는 경우 게시 스냅샷 파일을 가져오는 위치를 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
Attributes

트랜잭션 게시에서 구독에 지원되는 특성을 가져오거나 설정합니다.

CachePropertyChanges

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

(다음에서 상속됨 ReplicationObject)
ConnectionContext

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

(다음에서 상속됨 ReplicationObject)
CreateSyncAgentByDefault

구독이 만들어지면 구독을 동기화하기 위해 복제 에이전트를 시작하는 데 사용되는 에이전트 작업이 만들어지는지 여부를 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
DatabaseName

구독 데이터베이스의 이름을 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
Description

끌어오기 구독에 대한 텍스트 설명을 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
DistributorName

배포자이며 구독이 구독하는 게시를 배포하는 Microsoft SQL Server 인스턴스를 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
DistributorSecurity

배포자에 연결하는 데 사용되는 보안 컨텍스트를 가져옵니다.

(다음에서 상속됨 PullSubscription)
DtsPackageLocation

변환 가능한 구독에 사용되는 DTS(데이터 변환 서비스) 패키지의 위치를 가져오거나 설정합니다.

DtsPackageName

변환 가능한 구독에 사용되는 DTS(데이터 변환 서비스) 패키지 이름을 가져오거나 설정합니다.

DtsPackagePassword

변환 가능한 구독에 사용되는 암호를 가져오거나 설정합니다.

EnabledForSynchronizationManager

Windows 동기화 관리자를 사용하여 구독을 동기화할 수 있는지 여부를 지정합니다.

(다음에서 상속됨 PullSubscription)
FtpAddress

FTP 서버의 IP 주소를 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
FtpLogin

FTP 로그인을 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
FtpPassword

FTP 암호를 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
FtpPort

FTP 서버의 포트 번호를 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
IsExistingObject

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

(다음에서 상속됨 ReplicationObject)
IsMemoryOptimized

트랜잭션 게시에 대한 끌어오기 구독을 나타냅니다.

(다음에서 상속됨 PullSubscription)
LastAgentDateTime

구독을 마지막으로 동기화한 날짜 및 시간을 가져옵니다.

(다음에서 상속됨 PullSubscription)
LastAgentStatus

가장 최근의 구독 동기화 상태를 가져옵니다.

(다음에서 상속됨 PullSubscription)
LastAgentSummary

가장 최근의 구독 동기화 결과의 요약을 가져옵니다.

(다음에서 상속됨 PullSubscription)
LastSummaryDateTime

마지막 동기화가 완료된 날짜 및 시간을 가져옵니다.

MemoryOptimized

트랜잭션 게시에 대한 끌어오기 구독을 나타냅니다.

Name

끌어오기 구독에 대해 생성된 이름을 가져옵니다.

(다음에서 상속됨 PullSubscription)
PublicationDBName

게시 데이터베이스의 이름을 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
PublicationName

구독에서 구독하는 게시의 이름을 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
PublisherName

게시자의 이름을 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
PublisherSecurity

게시자에 연결할 때 동기화 에이전트에서 사용하는 보안 컨텍스트를 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
SecureFtpPassword

FTP 서버에 연결하는 데 사용되는 로그인의 보안 암호를 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
SqlServerName

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

(다음에서 상속됨 ReplicationObject)
SubscriberSecurity

구독자에 연결할 때 동기화 에이전트에서 사용하는 보안 컨텍스트를 가져옵니다.

(다음에서 상속됨 PullSubscription)
SubscriberType

구독의 업데이트 동작을 가져오거나 설정합니다.

SubscriptionId

구독 ID 값을 가져옵니다.

(다음에서 상속됨 PullSubscription)
SubscriptionType

구독 등록이 밀어넣기, 끌어오기 또는 익명 구독인지를 가져옵니다.

(다음에서 상속됨 PullSubscription)
SynchronizationAgent

구독을 동기화하는 데 사용할 수 있는 배포 에이전트의 인스턴스를 나타내는 개체를 가져옵니다.

SynchronizationAgentProcessSecurity

동기화 에이전트 작업이 구독을 동기화하기 위해 실행되는 Microsoft Windows 계정을 지정하는 데 사용되는 보안 컨텍스트를 가져옵니다.

(다음에서 상속됨 PullSubscription)
Type

게시 유형을 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
UseFtp

끌어오기 구독을 초기화하는 데 필요한 스냅샷 파일이 FTP(파일 전송 프로토콜)를 사용하여 동기화 에이전트에 의해 액세스되는지 여부를 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)
UserData

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

(다음에서 상속됨 ReplicationObject)
WorkingDirectory

다운로드된 스냅샷 파일을 임시로 저장하고 압축을 푸는 데 사용되는 구독자의 디렉터리 경로를 가져오거나 설정합니다.

(다음에서 상속됨 PullSubscription)

메서드

CheckValidCreation()

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

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

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

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

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

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

구독자에 끌어오기 구독을 만듭니다.

(다음에서 상속됨 PullSubscription)
CustomEnabledForSyncMgr(StringBuilder)

동기 관리자에 대한 사용자 지정 게시를 사용하도록 지정합니다.

(다음에서 상속됨 PullSubscription)
Decouple()

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

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

트랜잭션 게시에 대한 끌어오기 구독을 나타냅니다.

GetChangeCommand(StringBuilder, String, String)

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

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

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

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

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

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

멤버 변수를 초기화합니다.

(다음에서 상속됨 PullSubscription)
InternalRefresh(Boolean)

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

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

마지막으로 실행된 동기화 에이전트 작업에 대한 정보를 반환합니다.

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

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

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

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

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

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

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

끌어오기 구독을 다시 초기화하도록 표시합니다.

Remove()

끌어오기 구독을 제거합니다.

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

개체의 현재 속성 설정에 따라 끌어오기 구독을 만들거나 삭제하는 Transact-SQL 스크립트를 PullSubscription 반환합니다.

(다음에서 상속됨 PullSubscription)
StopSynchronizationJob()

현재 구독을 동기화 중인 배포 에이전트 작업의 실행을 중지하려고 합니다.

SynchronizeWithJob()

구독을 동기화하는 에이전트 작업을 시작합니다.

적용 대상

추가 정보