TransSubscription.SynchronizeWithJob 메서드
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
구독을 동기화하는 에이전트 작업을 시작합니다.
public:
void SynchronizeWithJob();
public void SynchronizeWithJob ();
member this.SynchronizeWithJob : unit -> unit
Public Sub SynchronizeWithJob ()
예제
// Define the server, publication, and database names.
string subscriberName = subscriberInstance;
string publisherName = publisherInstance;
string publicationName = "AdvWorksProductTran";
string subscriptionDbName = "AdventureWorks2012Replica";
string publicationDbName = "AdventureWorks2012";
/// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);
TransSubscription subscription;
try
{
// Connect to the Publisher.
conn.Connect();
// Instantiate the push subscription.
subscription = new TransSubscription();
subscription.ConnectionContext = conn;
subscription.DatabaseName = publicationDbName;
subscription.PublicationName = publicationName;
subscription.SubscriptionDBName = subscriptionDbName;
subscription.SubscriberName = subscriberName;
// If the push subscription and the job exists, start the agent job.
if (subscription.LoadProperties() && subscription.AgentJobId != null)
{
// Start the Distribution Agent asynchronously.
subscription.SynchronizeWithJob();
}
else
{
// Do something here if the subscription does not exist.
throw new ApplicationException(String.Format(
"A subscription to '{0}' does not exists on {1}",
publicationName, subscriberName));
}
}
catch (Exception ex)
{
// Implement appropriate error handling here.
throw new ApplicationException("The subscription could not be synchronized.", ex);
}
finally
{
conn.Disconnect();
}
' Define the server, publication, and database names.
Dim subscriberName As String = subscriberInstance
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"
' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)
Dim subscription As TransSubscription
Try
' Connect to the Publisher.
conn.Connect()
' Instantiate the push subscription.
subscription = New TransSubscription()
subscription.ConnectionContext = conn
subscription.DatabaseName = publicationDbName
subscription.PublicationName = publicationName
subscription.SubscriptionDBName = subscriptionDbName
subscription.SubscriberName = subscriberName
' If the push subscription and the job exists, start the agent job.
If subscription.LoadProperties() And Not subscription.AgentJobId Is Nothing Then
' Start the Distribution Agent asynchronously.
subscription.SynchronizeWithJob()
Else
' Do something here if the subscription does not exist.
Throw New ApplicationException(String.Format( _
"A subscription to '{0}' does not exists on {1}", _
publicationName, subscriberName))
End If
Catch ex As Exception
' Implement appropriate error handling here.
Throw New ApplicationException("The subscription could not be synchronized.", ex)
Finally
conn.Disconnect()
End Try
설명
에 대한 CreateSyncAgentByDefault값을 false
사용하여 끌어오기 구독을 만든 경우 기본값인 구독에 대한 배포 에이전트 작업이 만들어지지 않습니다. 를 호출 SynchronizeWithJob 하면 예외가 발생합니다.
StopSynchronizationJob 현재 실행 중인 경우 메서드를 호출하여 작업을 중지합니다.
SQL Server 에이전트 서비스가 실행되고 있지 않으면 작업을 시작할 수 없습니다. 또한 스냅샷이 생성되지 않은 경우 에이전트 작업을 실행해도 구독이 동기화되지 않을 수 있습니다.
이 인스턴스 TransSubscription에 속성을 설정한 경우 를 호출하기 전에 를 호출 CommitPropertyChangesSynchronizeWithJob합니다.
메서드는 SynchronizeWithJob 구독자에서 고정 서버 역할의 sysadmin
멤버 또는 구독 데이터베이스의 db_owner
고정 데이터베이스 역할 멤버에 의해서만 호출할 수 있습니다.