TransArticle クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
取引出版物の記事を代表します。
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のカラムデータ型マッピングを設定します。 |