TransArticle TransArticle TransArticle Class

정의

트랜잭션 게시의 아티클을 나타냅니다. Represents an article in a transactional publication.

public ref class TransArticle sealed : Microsoft::SqlServer::Replication::Article
public sealed class TransArticle : Microsoft.SqlServer.Replication.Article
Public NotInheritable Class TransArticle
Inherits Article
상속

예제

// Define the Publisher, publication, and article names.
string publisherName = publisherInstance;
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2012";
string articleName = "Product";
string schemaOwner = "Production";

TransArticle article;

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

// Create a filtered transactional articles in the following steps:
// 1) Create the  article with a horizontal filter clause.
// 2) Add columns to or remove columns from the article.
try
{
	// Connect to the Publisher.
	conn.Connect();

	// Define a horizontally filtered, log-based table article.
	article = new TransArticle();
	article.ConnectionContext = conn;
	article.Name = articleName;
	article.DatabaseName = publicationDbName;
	article.SourceObjectName = articleName;
	article.SourceObjectOwner = schemaOwner;
	article.PublicationName = publicationName;
	article.Type = ArticleOptions.LogBased;
	article.FilterClause = "DiscontinuedDate IS NULL";

	// Ensure that we create the schema owner at the Subscriber.
	article.SchemaOption |= CreationScriptOptions.Schema;

	if (!article.IsExistingObject)
	{
		// Create the article.
		article.Create();
	}
	else
	{
		throw new ApplicationException(String.Format(
			"The article {0} already exists in publication {1}.",
			articleName, publicationName));
	}

	// Create an array of column names to remove from the article.
	String[] columns = new String[1];
	columns[0] = "DaysToManufacture";

	// Remove the column from the article.
	article.RemoveReplicatedColumns(columns);
}
catch (Exception ex)
{
	// Implement appropriate error handling here.
	throw new ApplicationException("The article could not be created.", ex);
}
finally
{
	conn.Disconnect();
}
' Define the Publisher, publication, and article names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2012"
Dim articleName As String = "Product"
Dim schemaOwner As String = "Production"

Dim article As TransArticle

' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

' Create a filtered transactional articles in the following steps:
' 1) Create the  article with a horizontal filter clause.
' 2) Add columns to or remove columns from the article.
Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Define a horizontally filtered, log-based table article.
    article = New TransArticle()
    article.ConnectionContext = conn
    article.Name = articleName
    article.DatabaseName = publicationDbName
    article.SourceObjectName = articleName
    article.SourceObjectOwner = schemaOwner
    article.PublicationName = publicationName
    article.Type = ArticleOptions.LogBased
    article.FilterClause = "DiscontinuedDate IS NULL"

    ' Ensure that we create the schema owner at the Subscriber.
    article.SchemaOption = article.SchemaOption Or _
    CreationScriptOptions.Schema

    If Not article.IsExistingObject Then
        ' Create the article.
        article.Create()
    Else
        Throw New ApplicationException(String.Format( _
         "The article {0} already exists in publication {1}.", _
         articleName, publicationName))
    End If

    ' Create an array of column names to remove from the article.
    Dim columns() As String = New String(0) {}
    columns(0) = "DaysToManufacture"

    ' Remove the column from the article.
    article.RemoveReplicatedColumns(columns)
Catch ex As Exception
    ' Implement appropriate error handling here.
    Throw New ApplicationException("The article could not be created.", ex)
Finally
    conn.Disconnect()
End Try

설명

스레드 보안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.

생성자

TransArticle() TransArticle() TransArticle()

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

TransArticle(String, String, String, ServerConnection) TransArticle(String, String, String, ServerConnection) TransArticle(String, String, String, ServerConnection)

새 인스턴스를 만듭니다는 TransArticle 클래스, 필요한 속성 및 Microsoft SQL Server의 인스턴스에 지정 된 연결을 사용 합니다. Creates a new instance of the TransArticle class, with the required properties and with the specified connection to the instance of Microsoft SQL Server.

속성

ArticleId ArticleId ArticleId

아티클 ID 값을 가져옵니다. Gets the article ID value.

(Inherited from Article)
ArticleLogTablespace ArticleLogTablespace ArticleLogTablespace

복제 로그 정보를 저장하는 데 사용되는 Oracle 테이블스페이스의 이름을 가져오거나 설정합니다. Gets or sets the name of the Oracle tablespace used to store replication log information.

CachePropertyChanges CachePropertyChanges CachePropertyChanges

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

(Inherited from ReplicationObject)
CommandFormat CommandFormat CommandFormat

아티클에 대한 변경 내용이 전파되는 방식을 가져오거나 설정합니다. Gets or sets how changes are propagated for the article.

ConnectionContext ConnectionContext ConnectionContext

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

(Inherited from ReplicationObject)
CreateArticleAsHeterogeneous CreateArticleAsHeterogeneous CreateArticleAsHeterogeneous

아티클을 다른 유형으로 만들지 여부를 나타내는 값을 가져오거나 설정합니다. Gets or sets a value that indicates whether to create an article as heterogeneous.

(Inherited from Article)
CreationScript CreationScript CreationScript

이름 및 Transact의 전체 경로 가져오거나-구독자에서 대상 개체를 만드는 데 사용 되는 SQL 스크립트 파일입니다. Gets or sets the name and full path of the Transact-SQL script file that is used to create the destination object at the Subscriber.

(Inherited from Article)
DatabaseName DatabaseName DatabaseName

아티클에 게시되는 개체 및 데이터를 포함하는 데이터베이스의 이름을 가져오거나 설정합니다. Gets or sets the name of the database that contains the data and the objects that are published in the article.

(Inherited from Article)
DatatypeMappingOptions DatatypeMappingOptions DatatypeMappingOptions

SQL Server 이외의 게시자에 기본 아티클 데이터 형식 매핑이 사용되는지 여부를 반환합니다. Returns whether the default article data type mapping is used for a non-SQL Server Publisher.

DeleteCommand DeleteCommand DeleteCommand

삭제 내용을 복제하는 데 사용되는 명령을 가져오거나 설정합니다. Gets or sets the command used to replicate deletes.

Description Description Description

아티클에 대한 텍스트 설명을 가져오거나 설정합니다. Gets or sets a textual description of the article.

(Inherited from Article)
DestinationObjectName DestinationObjectName DestinationObjectName

구독자에서 아티클에 대한 원본 데이터베이스 개체로 사용되는 데이터베이스 개체를 가져오거나 설정합니다. Gets or sets the database object that is the source database object for the article at the Subscriber.

(Inherited from Article)
DestinationObjectOwner DestinationObjectOwner DestinationObjectOwner

구독자에서 아티클에 대한 원본 데이터베이스 개체의 스키마 소유자를 가져오거나 설정합니다. Gets or sets the schema owner of the source database object for the article at the Subscriber.

(Inherited from Article)
FilterClause FilterClause FilterClause

[위치]을 가져오거나 설정 합니다. (http://msdn.microsoft.com/library/a8430421-7bce-4fab-a2d2-56c00a3c6fa4) 절 아티클을 행 필터링 하는 데 사용 합니다. Gets or sets the WHERE clause used to filter the article horizontally.

FilterProcName FilterProcName FilterProcName

테이블을 행 필터링하는 데 사용되는 저장 프로시저(FOR REPLICATION을 사용하여 만들어짐)를 가져오거나 설정합니다. Gets or sets the stored procedure (created with FOR REPLICATION) used to filter the table horizontally.

FilterProcOwner FilterProcOwner FilterProcOwner

테이블 기반 아티클을 수평 분할하는 데 사용되는 저장 프로시저를 소유하는 데이터베이스 사용자를 가져오거나 설정합니다. Gets or sets the database user who owns the stored procedure that is used to horizontally partition a table-based article.

IdentityRangeManagementOption IdentityRangeManagementOption IdentityRangeManagementOption

아티클에 대한 ID 범위 관리 옵션을 가져오거나 설정합니다. Gets or sets the identity range management options for the article.

(Inherited from Article)
IdentityRangeThreshold IdentityRangeThreshold IdentityRangeThreshold

새 범위의 ID 열 값이 게시자 또는 구독자에 할당되는 값을 가져오거나 설정합니다. Gets or sets the value at which a new range of identity column values are assigned to a Publisher or to a Subscriber.

(Inherited from Article)
InsertCommand InsertCommand InsertCommand

삽입 내용을 복제하는 데 사용되는 명령을 가져오거나 설정합니다. Gets or sets the command used to replicate inserts.

IsExistingObject IsExistingObject IsExistingObject

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

(Inherited from ReplicationObject)
Name Name Name

아티클 이름을 가져오거나 설정합니다. Gets or sets the name of the article.

(Inherited from Article)
PreCreationMethod PreCreationMethod PreCreationMethod

게시된 개체가 구독 데이터베이스에 이미 있는 경우 수행할 동작을 가져오거나 설정합니다. Gets or sets the action to take when the published object already exists in the subscription database.

(Inherited from Article)
PublicationName PublicationName PublicationName

아티클이 속한 게시의 이름을 가져오거나 설정합니다. Gets or sets the name of the publication to which the article belongs.

(Inherited from Article)
PublisherIdentityRangeSize PublisherIdentityRangeSize PublisherIdentityRangeSize

게시자에서 테이블 열에 할당 된 id 값의 범위를 가져오거나 설정 합니다. Gets or sets the range of identity values assigned to table columns at the Publisher.

(Inherited from Article)
PublisherName PublisherName PublisherName

아티클을 게시하는 SQL Server 이외의 게시자 이름을 가져오거나 설정합니다. Gets or sets the name of the non-SQL Server Publisher that publishes the article.

SchemaOption SchemaOption SchemaOption

아티클에 대한 스키마 만들기 옵션을 가져오거나 설정합니다. Gets or sets the schema creation options for an article.

(Inherited from Article)
SnapshotObjectName SnapshotObjectName SnapshotObjectName

아티클에 대한 초기 데이터 스냅숏을 제공하는 데이터베이스 개체를 가져오거나 설정합니다. Gets or sets the database object that provides the initial data snapshot for the article.

SnapshotObjectOwner SnapshotObjectOwner SnapshotObjectOwner

아티클에 대한 초기 데이터 스냅숏을 제공하는 데이터베이스 개체의 소유자를 가져오거나 설정합니다. Gets or sets the owner of the database object that provides the initial data snapshot for the article.

SourceObjectName SourceObjectName SourceObjectName

게시되는 데이터베이스 개체의 이름을 가져오거나 설정합니다. Gets or sets the name of the database object that is being published.

(Inherited from Article)
SourceObjectOwner SourceObjectOwner SourceObjectOwner

게시되는 데이터베이스 개체의 소유자를 가져오거나 설정합니다. Gets or sets the owner of the database object that is being published.

(Inherited from Article)
SqlServerName SqlServerName SqlServerName

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

(Inherited from ReplicationObject)
SubscriberIdentityRangeSize SubscriberIdentityRangeSize SubscriberIdentityRangeSize

다른 ID 범위를 할당해야 하기 전에 구독자에서 테이블의 ID 열에 삽입할 수 있는 최대 새 행 수를 가져오거나 설정합니다. Gets or sets the maximum number of new rows that can be inserted into an identity column in a table at a Subscriber before another identity range must be allocated.

(Inherited from Article)
Type Type Type

아티클 유형을 가져오거나 설정합니다. Gets or sets the type of article.

(Inherited from Article)
UpdateCommand UpdateCommand UpdateCommand

업데이트 내용을 복제하는 데 사용되는 명령을 가져오거나 설정합니다. Gets or sets the command used to replicate updates.

UserData UserData UserData

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

(Inherited from ReplicationObject)
VerticalPartition VerticalPartition VerticalPartition

모든 열이 테이블 아티클에 게시되는지 여부를 나타내는 값을 가져옵니다. Gets a value that indicates whether all columns are published in a table article.

(Inherited from Article)

메서드

AddReplicatedColumns(Array) AddReplicatedColumns(Array) AddReplicatedColumns(Array)

수직 분할된 테이블 아티클에 열을 포함합니다. Includes columns in a vertically partitioned table article.

CheckValidCreation() CheckValidCreation() CheckValidCreation()

유효한 아티클 생성을 확인합니다. Checks the valid article creation.

(Inherited from Article)
CheckValidDefinition(Boolean) CheckValidDefinition(Boolean) CheckValidDefinition(Boolean)

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

(Inherited from Article)
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()

현재 속성에 따라 SQL Server의 현재 연결 된 인스턴스에서 새 아티클을 만듭니다는 TransArticle 개체 또는 MergeArticle 개체입니다. Creates a new article on the currently connected instance of SQL Server based on the current properties of the TransArticle object or the MergeArticle object.

(Inherited from Article)
Decouple() Decouple() Decouple()

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

(Inherited from ReplicationObject)
EnumHeterogeneousColumns() EnumHeterogeneousColumns() EnumHeterogeneousColumns()

SQL Server 이외의 게시자에서 게시하는 테이블 아티클에 대한 열 정보를 반환합니다. Returns column information for a table article published by a non-SQL Server Publisher.

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)
ListReplicatedColumns() ListReplicatedColumns() ListReplicatedColumns()

테이블 아티클에서 게시된 열을 반환합니다. Returns the published columns in a table article.

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)
Remove() Remove() Remove()

현재 연결 된의 현재 속성에 따라 SQL Server 인스턴스에서 기존 아티클을 제거는 TransArticle 개체 또는 MergeArticle 개체입니다. Removes an existing article on the currently connected instance of SQL Server based on the current properties of the TransArticle object or the MergeArticle object.

(Inherited from Article)
RemoveReplicatedColumns(Array) RemoveReplicatedColumns(Array) RemoveReplicatedColumns(Array)

수직 분할된 테이블 아티클에서 열을 제외합니다. Excludes columns from a vertically partitioned table article.

Script(ScriptOptions) Script(ScriptOptions) Script(ScriptOptions)

에서는 오류가 발생 하는 Transact-만들기 또는 삭제 하기 위해 실행할 수 있는 SQL 스크립트는 TransArticle 개체 또는 MergeArticle 서버 개체입니다. Generates a Transact-SQL script that can be executed to create or delete the TransArticle object or the MergeArticle object on the server.

(Inherited from Article)
ScriptChangeColumnDestinationDataType(String, String, Int64, Int32, Int64, ScriptOptions) ScriptChangeColumnDestinationDataType(String, String, Int64, Int32, Int64, ScriptOptions) ScriptChangeColumnDestinationDataType(String, String, Int64, Int32, Int64, ScriptOptions)

Transact 반환-SQL 스크립트에 대 한-SQL Server 이외 게시자 열 데이터 형식 매핑을 변경 하는 데 사용 합니다. Returns a Transact-SQL script used to change the column data type mapping for a non-SQL Server Publisher.

SetColumnDestinationDataType(String, String, Int64, Int32, Int64) SetColumnDestinationDataType(String, String, Int64, Int32, Int64) SetColumnDestinationDataType(String, String, Int64, Int32, Int64)

SQL Server 이외의 게시자에 대한 열 데이터 형식 매핑을 설정합니다. Sets the column data type mapping for a non-SQL Server Publisher.

적용 대상

추가 정보