TransArticle クラス

定義

取引出版物の記事を代表します。

public ref class TransArticle sealed : Microsoft::SqlServer::Replication::Article
public sealed class TransArticle : Microsoft.SqlServer.Replication.Article
type TransArticle = class
    inherit 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

注釈

スレッド セーフ

このタイプの公開静的(Microsoft Visual BasicShared)メンバーはマルチスレッド操作に安全です。 インスタンス メンバーがスレッド セーフであるとは限りません。

コンストラクター

名前 説明
TransArticle()

TransArticle クラスの新しいインスタンスを作成します。

TransArticle(String, String, String, ServerConnection)

TransArticleクラスの新しいインスタンスを作成し、必要なプロパティを持ち、Microsoft SQL Serverインスタンスとの指定された接続を持ちます。

プロパティ

名前 説明
ArticleId

記事IDの値を取得します。

(継承元 Article)
ArticleLogTablespace

レプリケーションログ情報を格納するOracleテーブルスペースの名前を取得したり設定したりします。

CachePropertyChanges

レプリケーションプロパティの変更をキャッシュするか、即座に適用するかを取得または設定します。

(継承元 ReplicationObject)
CommandFormat

記事の変更をどのように伝播するかを取得または設定します。

ConnectionContext

Microsoft SQL Serverのインスタンスへの接続を取得または設定します。

(継承元 ReplicationObject)
CreateArticleAsHeterogeneous

異種記事を作成するかどうかを示す値を取得または設定します。

(継承元 Article)
CreationScript

サブスクライバーで宛先オブジェクトを作成するために使われる Transact-SQL スクリプトファイルの名前とフルパスを取得します。

(継承元 Article)
DatabaseName

記事に掲載されたデータとオブジェクトを含むデータベース名を取得するか設定します。

(継承元 Article)
DatatypeMappingOptions

非SQL Server Publisherにデフォルトの記事データタイプマッピングが使われているかどうかを返します。

DeleteCommand

削除を再現するために使うコマンドを取得または設定します。

Description

記事のテキスト説明を取得または設定します。

(継承元 Article)
DestinationObjectName

Subscriberで記事のソースデータベースオブジェクトを取得するか設定します。

(継承元 Article)
DestinationObjectOwner

Subscriberで記事のソースデータベースオブジェクトのスキーマ所有者を取得するか設定します。

(継承元 Article)
FilterClause

記事を水平にフィルタリングするために使う WHERE 節を取得するか設定します。

FilterProcName

テーブルを水平にフィルタリングするために使われるストアドプロシージャ(FOR REPLICATIONで作成)を取得したり設定したりします。

FilterProcOwner

テーブルベースの記事を水平に分割するために使われるストアドプロシージャを所有するデータベースユーザーを取得するか設定します。

IdentityRangeManagementOption

記事のアイデンティティ範囲管理オプションを取得するか設定します。

(継承元 Article)
IdentityRangeThreshold

新しい識別カラムの値の範囲がPublisherまたはSubscriberに割り当てられる値を取得または設定します。

(継承元 Article)
InsertCommand

挿入を複製するために使うコマンドを取得したり設定したりします。

IsExistingObject

オブジェクトがサーバー上に存在するかどうかを把握します。

(継承元 ReplicationObject)
Name

記事名を取得するか設定します。

(継承元 Article)
PreCreationMethod

公開されたオブジェクトがすでにサブスクリプションデータベースに存在している場合に、実行するアクションを取得したり設定したりします。

(継承元 Article)
PublicationName

記事が所属する出版物の名前を取得するか設定します。

(継承元 Article)
PublisherIdentityRangeSize

Publisherでテーブルの列に割り当てられる識別値の範囲を取得したり設定したりします。

(継承元 Article)
PublisherName

記事を掲載した非SQL Server Publisherの名前を取得するか設定します。

SchemaOption

記事のスキーマ作成オプションを取得または設定します。

(継承元 Article)
SnapshotObjectName

記事の初期データスナップショットを提供するデータベースオブジェクトを取得したり設定したりします。

SnapshotObjectOwner

記事の初期データスナップショットを提供するデータベースオブジェクトの所有者を取得するか設定します。

SourceObjectName

公開されるデータベースオブジェクトの名前を取得したり設定したりします。

(継承元 Article)
SourceObjectOwner

公開されるデータベースオブジェクトの所有者を取得するか設定します。

(継承元 Article)
SqlServerName

このオブジェクトが接続されているMicrosoft SQL Serverインスタンスの名前を取得します。

(継承元 ReplicationObject)
SubscriberIdentityRangeSize

サブスクライバーのテーブルの識別列に挿入できる最大数の新しい行数を取得または設定し、その後に別の識別範囲を割り当てる必要があります。

(継承元 Article)
Type

記事の種類を取得または設定します。

(継承元 Article)
UpdateCommand

更新のレプリケートに使われるコマンドを取得または設定します。

UserData

ユーザーが自分のデータをオブジェクトにアタッチできるオブジェクトプロパティを取得したり設定したりします。

(継承元 ReplicationObject)
VerticalPartition

すべての列が表記事で公開されているかどうかを示す値が得られます。

(継承元 Article)

メソッド

名前 説明
AddReplicatedColumns(Array)

縦分割された表記事の列を含みます。

CheckValidCreation()

有効な記事作成を確認します。

(継承元 Article)
CheckValidDefinition(Boolean)

定義が有効かどうかを示します。

(継承元 Article)
CommitPropertyChanges()

キャッシュされたプロパティ変更文をすべてMicrosoft SQL Serverのインスタンスに送信します。

(継承元 ReplicationObject)
Create()

TransArticleオブジェクトまたはMergeArticleオブジェクトの現在のプロパティに基づいて、現在接続されているSQL Serverインスタンスについて新しい記事を作成します。

(継承元 Article)
Decouple()

参照されたレプリケーションオブジェクトをサーバーから切り離します。

(継承元 ReplicationObject)
EnumHeterogeneousColumns()

非SQL Server Publisherが発行した表記事の列情報を返します。

GetChangeCommand(StringBuilder, String, String)

レプリケーションからの変更コマンドを返します。

(継承元 ReplicationObject)
GetCreateCommand(StringBuilder, Boolean, ScriptOptions)

レプリケーションからcreateコマンドを返します。

(継承元 ReplicationObject)
GetDropCommand(StringBuilder, Boolean)

レプリケーションからドロップコマンドを返します。

(継承元 ReplicationObject)
InternalRefresh(Boolean)

レプリケーションから内部リフレッシュを開始します。

(継承元 ReplicationObject)
ListReplicatedColumns()

表記事の公開された列を返します。

Load()

サーバーから既存のオブジェクトのプロパティを読み込みます。

(継承元 ReplicationObject)
LoadProperties()

サーバーから既存のオブジェクトのプロパティを読み込みます。

(継承元 ReplicationObject)
Refresh()

オブジェクトのプロパティをリロードします。

(継承元 ReplicationObject)
Remove()

TransArticleオブジェクトまたはMergeArticleオブジェクトの現在のプロパティに基づいて、現在接続されているSQL Serverインスタンスの既存の記事を削除します。

(継承元 Article)
RemoveReplicatedColumns(Array)

縦分割された表記事から列を除外します。

Script(ScriptOptions)

サーバー上の TransArticle オブジェクトや MergeArticle オブジェクトを作成または削除するために実行可能な Transact-SQL スクリプトを生成します。

(継承元 Article)
ScriptChangeColumnDestinationDataType(String, String, Int64, Int32, Int64, ScriptOptions)

非SQL Server Publisherのカラムデータ型マッピングを変更するために使われた Transact-SQL スクリプトを返します。

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

非SQL Server Publisherのカラムデータ型マッピングを設定します。

適用対象

こちらもご覧ください