TransSubscription TransSubscription TransSubscription Class

정의

트랜잭션 또는 스냅숏 게시에 대한 밀어넣기 구독을 나타냅니다. Represents a push subscription to a transactional or snapshot publication.

public ref class TransSubscription sealed : Microsoft::SqlServer::Replication::Subscription
public sealed class TransSubscription : Microsoft.SqlServer.Replication.Subscription
Public NotInheritable Class TransSubscription
Inherits Subscription
상속

예제

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

//Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(subscriberName);

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

try
{
	// Connect to the Publisher.
	conn.Connect();

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

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

		// Define the push subscription.
		subscription = new TransSubscription();
		subscription.ConnectionContext = conn;
		subscription.SubscriberName = subscriberName;
		subscription.PublicationName = publicationName;
		subscription.DatabaseName = publicationDbName;
		subscription.SubscriptionDBName = subscriptionDbName;

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

                 // 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 push subscription.
		subscription.Create();
	}
	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
{
	conn.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 a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(subscriberName)

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

Try
    ' Connect to the Publisher.
    conn.Connect()

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

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

        ' Define the push subscription.
        subscription = New TransSubscription()
        subscription.ConnectionContext = conn
        subscription.SubscriberName = subscriberName
        subscription.PublicationName = publicationName
        subscription.DatabaseName = publicationDbName
        subscription.SubscriptionDBName = subscriptionDbName

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

        ' 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 push subscription.
        subscription.Create()
    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
    conn.Disconnect()
End Try

설명

모든 매개 변수에 대해 제공 된 값을 원격 배포자로 게시자를 구성할 경우 포함 하 여 SynchronizationAgentProcessSecurity를 일반 텍스트로 배포자에 보내집니다.When configuring a Publisher with a remote Distributor, the values supplied for all parameters, including SynchronizationAgentProcessSecurity, are sent to the Distributor as plain text. Create 메서드를 호출하기 전에 게시자와 해당 원격 배포자 간 연결을 암호화해야 합니다.You should encrypt the connection between the Publisher and its remote Distributor before calling the Create method. 자세한 내용은 참조 sp_reinitsubscription (Transact SQL)합니다.For more information, see sp_reinitsubscription (Transact-SQL).

이외에 구독이 속한 경우 SQL Server 게시자는 ConnectionContext 대신 게시자, 배포자 속성에서 DatabaseName 게시 데이터베이스와는 대신배포데이터베이스속성은PublisherName이외의 이름 속성이 SQL Server 게시자입니다.When the subscription belongs to a non- SQL Server Publisher, the ConnectionContext property is set to the Distributor instead of Publisher, the DatabaseName property is set to the distribution database instead of the publication database, and the PublisherName property is set to the name of the non- SQL Server Publisher.

스레드 보안Thread Safety

모든 public static (Shared 에 Microsoft Visual Basic)이 형식의 멤버는 다중 스레드 작업에 안전 합니다.Any public static (Shared in Microsoft Visual Basic) members of this type are safe for multithreaded operations. 인스턴스 구성원은 스레드로부터의 안전성이 보장되지 않습니다.Any instance members are not guaranteed to be thread safe.

생성자

TransSubscription() TransSubscription() TransSubscription()

새 인스턴스를 만듭니다는 TransSubscription 클래스입니다. Creates a new instance of the TransSubscription class.

TransSubscription(String, String, String, String, ServerConnection) TransSubscription(String, String, String, String, ServerConnection) TransSubscription(String, String, String, String, ServerConnection)

새 인스턴스를 만듭니다는 TransSubscription 클래스 지정한 게시, 데이터베이스, 구독자 및 구독자 데이터베이스 및 Microsoft SQL Server의 인스턴스에 지정 된 연결을 사용 합니다. Creates a new instance of the TransSubscription class with the specified publication, database, Subscriber, and subscriber database, and with the specified connection to the instance of Microsoft SQL Server.

속성

AgentJobId AgentJobId AgentJobId

구독을 동기화하는 데 사용되는 에이전트 작업의 ID를 가져옵니다. Gets the ID of the agent job used to synchronize the subscription.

(Inherited from Subscription)
AgentOffload AgentOffload AgentOffload

동기화 에이전트가 에이전트 작업이 만들어진 컴퓨터가 아닌 다른 컴퓨터에서 실행되는지 여부를 가져오거나 설정합니다. Gets or sets whether the synchronization agent runs on a computer other than the one where the agent job was created. 이 속성은 더 이상 이상 Microsoft SQL Server 2005를 실행 하는 배포자에 대 한 지원. This property is no longer supported for Distributors running Microsoft SQL Server 2005 and later.

(Inherited from Subscription)
AgentOffloadServer AgentOffloadServer AgentOffloadServer

원격 에이전트 활성화를 사용하는 경우 에이전트가 실행되는 원격 컴퓨터의 이름을 가져오거나 설정합니다. Gets or sets the name of the remote computer where the agent runs when using remote agent activation.

(Inherited from Subscription)
AgentSchedule AgentSchedule AgentSchedule

구독을 동기화하는 데 사용되는 에이전트 작업의 일정을 가져옵니다. Gets the schedule for the agent job used to synchronize the subscription.

(Inherited from Subscription)
BackupInformation BackupInformation BackupInformation

백업에서 구독을 초기화하는 데 필요한 정보를 가져오거나 설정합니다. Gets or sets information needed to initialize a subscription from a backup.

CachePropertyChanges CachePropertyChanges CachePropertyChanges

복제 속성에 대한 변경 내용을 캐시할지 아니면 즉시 적용할지를 가져오거나 설정합니다. Gets or sets whether to cache changes made to the replication properties or to apply them immediately.

(Inherited from ReplicationObject)
ConnectionContext ConnectionContext ConnectionContext

Microsoft SQL Server의 인스턴스에 연결을 가져오거나 설정 합니다. Gets or sets the connection to an instance of Microsoft SQL Server.

(Inherited from ReplicationObject)
CreateSyncAgentByDefault CreateSyncAgentByDefault CreateSyncAgentByDefault

구독을 동기화하는 데 사용되는 에이전트 작업이 기본적으로 만들어지는지 여부를 가져오거나 설정합니다. Gets or sets whether the agent job used to synchronize the subscription is created by default.

(Inherited from Subscription)
DatabaseName DatabaseName DatabaseName

게시 데이터베이스의 이름을 가져오거나 설정합니다. Gets or sets the name of the publication database.

(Inherited from Subscription)
DtsPackageLocation DtsPackageLocation DtsPackageLocation

Microsoft SQL Server 2000 데이터 변환 서비스 (DTS) 패키지의 위치를 가져오거나 설정 합니다. Gets or sets the location of the Microsoft SQL Server 2000 Data Transformation Services (DTS) package.

DtsPackageName DtsPackageName DtsPackageName

구독자에서 적용 되는 Microsoft SQL Server 2000 데이터 변환 서비스 (DTS) 패키지의 이름을 가져오거나 설정 합니다. Gets or sets the name of the Microsoft SQL Server 2000 Data Transformation Services (DTS) package that is applied at the Subscriber.

DtsPackagePassword DtsPackagePassword DtsPackagePassword

Microsoft SQL Server 2000 데이터 변환 서비스 (DTS) 패키지를 실행 하는 데 사용 되는 암호를 설정 합니다. Sets the password used to run the Microsoft SQL Server 2000 Data Transformation Services (DTS) package.

EnabledForSynchronizationManager EnabledForSynchronizationManager EnabledForSynchronizationManager

Microsoft Windows 동기화 관리자를 사용 하 여 구독을 동기화 수 하는지 여부를 지정 합니다. Specifies whether the subscription can be synchronized using Microsoft Windows Synchronization Manager.

(Inherited from Subscription)
FullSubscription FullSubscription FullSubscription

구독이 전체인지 여부를 나타내는 값을 가져옵니다. Gets a value that indicates whether the subscription is full.

IsExistingObject IsExistingObject IsExistingObject

서버에 개체가 있는지 여부를 가져옵니다. Gets whether the object exists on the server or not.

(Inherited from ReplicationObject)
LoopBackDetection LoopBackDetection LoopBackDetection

배포 에이전트가 구독자에서 발생한 트랜잭션을 다시 구독자에게 보내는지 여부를 가져오거나 설정합니다. Gets or sets whether or not the Distribution Agent sends transactions that originated at the Subscriber back to the Subscriber.

MemoryOptimized MemoryOptimized MemoryOptimized
Name Name Name

기존 구독에 할당된 이름을 가져옵니다. Gets the name assigned to an existing subscription.

(Inherited from Subscription)
PublicationName PublicationName PublicationName

구독에서 구독하는 게시의 이름을 가져오거나 설정합니다. Gets or sets the name of the publication to which the subscription subscribes.

(Inherited from Subscription)
PublisherName PublisherName PublisherName

구독에는 SQL Server 이외 게시자 속해 있는 경우 게시자의 이름을 가져오거나 설정 합니다. Gets or sets the name of the Publisher when the subscription belongs to a non- SQL Server Publisher.

SecureDtsPackagePassword SecureDtsPackagePassword SecureDtsPackagePassword

암호를 설정 (으로 SecureString 개체)는 Microsoft SQL Server 2000 데이터 변환 서비스 (DTS) 패키지를 실행 하는 데 사용 합니다. Sets the password (as a SecureString object) used to run the Microsoft SQL Server 2000 Data Transformation Services (DTS) package.

SqlServerName SqlServerName SqlServerName

이 개체가 연결 된 Microsoft SQL Server 인스턴스의 이름을 가져옵니다. Gets the name of the Microsoft SQL Server instance to which this object is connected.

(Inherited from ReplicationObject)
Status Status Status

구독 상태를 가져옵니다. Gets the status of the subscription.

(Inherited from Subscription)
SubscriberCatalog SubscriberCatalog SubscriberCatalog

OLE DB 공급자에 대 한-SQL Server 이외 구독자에 연결할 때 사용 되는 카탈로그를 가져오거나 설정 합니다. Gets or sets the catalog used when making a connection to the OLE DB provider for a non-SQL Server Subscriber.

SubscriberDatasource SubscriberDatasource SubscriberDatasource

OLE DB 공급자에 대 한-SQL Server 이외 구독자가 이해 하는 데이터 원본의 이름입니다. Name of the data source as understood by the OLE DB provider for a non-SQL Server Subscriber.

SubscriberDatasourceType SubscriberDatasourceType SubscriberDatasourceType

-SQL Server 이외 구독자는 데이터 원본 유형을 식별 합니다. Identifies the type of data source that is a non-SQL Server Subscriber.

SubscriberLocation SubscriberLocation SubscriberLocation

OLE DB 공급자에 대 한는 SQL Server 이외 구독자가 이해 하는 데이터베이스의 위치입니다. Location of the database as understood by the OLE DB provider for the non-SQL Server Subscriber.

SubscriberName SubscriberName SubscriberName

구독자인 Microsoft SQL Server 인스턴스의 이름을 가져오거나 설정합니다. Gets or sets the name of the instance of Microsoft SQL Server that is the Subscriber.

(Inherited from Subscription)
SubscriberProvider SubscriberProvider SubscriberProvider

고유 PROGID (프로그래밍 식별자)는 OLE DB 공급자에 대 한는 SQL Server 이외 구독자 등록 Unique programmatic identifier (PROGID) with which the OLE DB provider for the non-SQL Server Subscriber is registered

SubscriberProviderString SubscriberProviderString SubscriberProviderString

OLE DB 공급자별 연결 문자열은 데이터 원본에 대 한 SQL Server 이외 구독자에 연결 하는 데 사용 됩니다. OLE DB provider-specific connection string is used to connect to the data source for non-SQL Server Subscribers.

SubscriberSecurity SubscriberSecurity SubscriberSecurity

구독자에 연결하는 데 사용되는 보안 컨텍스트를 가져옵니다. Gets the security context used to connect to the Subscriber.

(Inherited from Subscription)
SubscriberType SubscriberType SubscriberType

구독자에서 데이터 변경에 대한 업데이트 동작을 가져오거나 설정합니다. Gets or sets the updating behavior for data changes at the Subscriber.

SubscriptionDBName SubscriptionDBName SubscriptionDBName

복제된 데이터를 받는 구독자 데이터베이스의 이름을 가져오거나 설정합니다. Gets or sets the name of the database on the Subscriber that receives the replicated data.

(Inherited from Subscription)
SubscriptionLSN SubscriptionLSN SubscriptionLSN

구독의 로그 시퀀스 수를 가져오거나 설정합니다. Gets or sets the log sequence number of the subscription.

SubscriptionType SubscriptionType SubscriptionType

구독 등록이 밀어넣기 구독인지 아니면 끌어오기 구독인지를 가져옵니다. Gets whether the subscription registration is for a push or pull subscription.

(Inherited from Subscription)
SynchronizationAgent SynchronizationAgent SynchronizationAgent

구독을 동기화하는 데 사용할 수 있는 TransSynchronizationAgent 클래스의 인스턴스를 가져옵니다. Gets an instance of the TransSynchronizationAgent class that can be used to synchronize the subscription.

SynchronizationAgentName SynchronizationAgentName SynchronizationAgentName

구독을 동기화하기 위해 만든 에이전트 작업의 이름을 가져오거나 설정합니다. Gets or sets the name of the agent job created to synchronize the subscription.

(Inherited from Subscription)
SynchronizationAgentProcessSecurity SynchronizationAgentProcessSecurity SynchronizationAgentProcessSecurity

구독을 동기화 할 동기화 에이전트 작업이 실행 되는 Microsoft Windows 계정을 지정 하는 데 사용 되는 보안 컨텍스트를 가져옵니다. Gets the security context that is used to specify the Microsoft Windows account under which the synchronization agent job runs to synchronize the subscription.

(Inherited from Subscription)
SyncType SyncType SyncType

구독이 초기화되는 방식을 가져오거나 설정합니다. Gets or sets the manner in which the subscription is initialized.

(Inherited from Subscription)
UserData UserData UserData

사용자가 자신의 고유 데이터를 개체에 연결할 수 있도록 하는 개체 속성을 가져오거나 설정합니다. Gets or sets an object property that allows users to attach their own data to the object.

(Inherited from ReplicationObject)

메서드

CheckValidCreation() CheckValidCreation() CheckValidCreation()

유효한 복제 만들기를 확인합니다. Checks the valid replication creation.

(Inherited from ReplicationObject)
CheckValidDefinition(Boolean) CheckValidDefinition(Boolean) CheckValidDefinition(Boolean)

구독 정의가 유효한지 여부를 나타냅니다. Indicates whether the subscription definition is valid.

(Inherited from Subscription)
CommitPropertyChanges() CommitPropertyChanges() CommitPropertyChanges()

Microsoft SQL Server 인스턴스의 모든 캐시 된 속성 변경 문을 보냅니다. Sends all the cached property change statements to the instance of Microsoft SQL Server.

(Inherited from ReplicationObject)
Create() Create() Create()

게시자에서 구독 등록을 만듭니다. Creates the subscription registration at the Publisher.

(Inherited from Subscription)
Decouple() Decouple() Decouple()

참조된 복제 개체를 서버에서 분리합니다. Decouples the referenced replication object from the server.

(Inherited from ReplicationObject)
DoUpdateMemoryOptimizedProperty(String) DoUpdateMemoryOptimizedProperty(String) DoUpdateMemoryOptimizedProperty(String)
GetChangeCommand(StringBuilder, String, String) GetChangeCommand(StringBuilder, String, String) GetChangeCommand(StringBuilder, String, String)

복제에서 변경 명령을 반환합니다. Returns the change command from the replication.

(Inherited from ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions) GetCreateCommand(StringBuilder, Boolean, ScriptOptions) GetCreateCommand(StringBuilder, Boolean, ScriptOptions)

복제에서 생성 명령을 반환합니다. Returns the create command from the replication.

(Inherited from ReplicationObject)
GetDropCommand(StringBuilder, Boolean) GetDropCommand(StringBuilder, Boolean) GetDropCommand(StringBuilder, Boolean)

복제에서 삭제 명령을 반환합니다. Returns the drop command from the replication.

(Inherited from ReplicationObject)
InternalRefresh(Boolean) InternalRefresh(Boolean) InternalRefresh(Boolean)

복제에서 내부 새로 고침을 시작합니다. Initiates an internal refresh from the replication.

(Inherited from ReplicationObject)
Load() Load() Load()

서버에서 기존 개체의 속성을 로드합니다. Loads the properties of an existing object from the server.

(Inherited from ReplicationObject)
LoadProperties() LoadProperties() LoadProperties()

서버에서 기존 개체의 속성을 로드합니다. Loads the properties of an existing object from the server.

(Inherited from ReplicationObject)
Refresh() Refresh() Refresh()

개체의 속성을 다시 로드합니다. Reloads the properties of the object.

(Inherited from ReplicationObject)
Reinitialize() Reinitialize() Reinitialize()

다음에 배포 에이전트를 실행하여 구독을 동기화할 때 구독을 다시 초기화하도록 표시합니다. Marks the subscription for reinitialization the next time the Distribution Agent runs to synchronize the subscription.

Reinitialize(Boolean) Reinitialize(Boolean) Reinitialize(Boolean)

구독을 다시 초기화합니다. Reinitializes the subscription.

Remove() Remove() Remove()

밀어넣기 구독의 경우 게시자에서 구독 등록을 삭제하고 구독자에서 복제 개체를 제거합니다. Deletes the subscription registration at the Publisher and removes replication objects at the Subscriber for a push subscription.

(Inherited from Subscription)
Script(ScriptOptions) Script(ScriptOptions) Script(ScriptOptions)

Transact 반환-만들거나 구독을 삭제 하는 데 사용할 수 있는 SQL 스크립트. Returns a Transact-SQL script that can be used to create or delete the subscription.

(Inherited from Subscription)
StopSynchronizationJob() StopSynchronizationJob() StopSynchronizationJob()

현재 구독을 동기화 중인 배포 에이전트 작업의 실행을 중지하려고 합니다. Attempts to stop a running Distribution Agent job that is currently synchronizing the subscription.

SynchronizeWithJob() SynchronizeWithJob() SynchronizeWithJob()

구독을 동기화하는 에이전트 작업을 시작합니다. Starts the agent job to synchronize the subscription.

적용 대상

추가 정보