TransPullSubscription 클래스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
트랜잭션 게시에 대한 끌어오기 구독을 나타냅니다.
public ref class TransPullSubscription sealed : Microsoft::SqlServer::Replication::PullSubscriptionpublic sealed class TransPullSubscription : Microsoft.SqlServer.Replication.PullSubscriptiontype TransPullSubscription = class
inherit PullSubscriptionPublic NotInheritable Class TransPullSubscription
Inherits PullSubscription- 상속
예제
// 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) |