MergeArticle クラス
マージ パブリケーションのアーティクルを表します。
継承階層
System. . :: . .Object
Microsoft.SqlServer.Replication. . :: . .ReplicationObject
Microsoft.SqlServer.Replication. . :: . .Article
Microsoft.SqlServer.Replication..::..MergeArticle
名前空間: Microsoft.SqlServer.Replication
アセンブリ: Microsoft.SqlServer.Rmo (Microsoft.SqlServer.Rmo.dll)
構文
'宣言
Public NotInheritable Class MergeArticle _
Inherits Article
'使用
Dim instance As MergeArticle
public sealed class MergeArticle : Article
public ref class MergeArticle sealed : public Article
[<SealedAttribute>]
type MergeArticle =
class
inherit Article
end
public final class MergeArticle extends Article
MergeArticle 型は、以下のメンバーを公開しています。
コンストラクター
名前 | 説明 | |
---|---|---|
MergeArticle() () () () | MergeArticle クラスの新しいインスタンスを作成します。 | |
MergeArticle(String, String, String, ServerConnection) | 指定された名前、パブリケーション、データベース、および Microsoft SQL Server のインスタンスへの接続を使用して、MergeArticle クラスの新しいインスタンスを作成します。 |
先頭に戻る
プロパティ
名前 | 説明 | |
---|---|---|
AllowInteractiveResolver | 同期中に競合が発生した場合にサブスクリプションでインタラクティブ競合回避モジュールを呼び出せるようにするかどうかを取得します。値の設定も可能です。 | |
ArticleId | アーティクルの ID 値を取得します。 (Article から継承されています。) | |
ArticleResolver | アーティクルの同期に使用されるカスタム競合回避モジュールまたはビジネス ロジック ハンドラの表示名を取得します。値の設定も可能です。 | |
CachePropertyChanges | レプリケーション プロパティに加えられた変更をキャッシュするか、またはすぐに適用するかを取得します。値の設定も可能です。 (ReplicationObject から継承されています。) | |
CheckPermissions | サブスクライバから変更がアップロードされる前に、パブリッシャで権限がチェックされる方法を取得します。値の設定も可能です。 | |
ColumnTracking | データ行の同期のときに競合をどのようにして検出するかを取得します。値の設定も可能です。 | |
CompensateForErrors | 同期中にエラーが検出された場合、補正アクションを実行するかどうかを取得します。値の設定も可能です。 | |
ConflictTable | マージ アーティクルの同期中に発生する競合の追跡に使用された、テーブルの名前を取得します。 | |
ConnectionContext | Microsoft SQL Server のインスタンスへの接続を取得します。値の設定も可能です。 (ReplicationObject から継承されています。) | |
CreateArticleAsHeterogeneous | (Article から継承されています。) | |
CreationScript | サブスクライバでレプリケーション先オブジェクトの作成に使われる Transact-SQL スクリプト ファイルの名前と完全なパスを取得します。値の設定も可能です。 (Article から継承されています。) | |
DatabaseName | アーティクルでパブリッシュされるデータとオブジェクトを含むデータベース名を取得します。値の設定も可能です。 (Article から継承されています。) | |
DeleteTracking | 削除がレプリケートされるかどうかを取得します。値の設定も可能です。 | |
Description | アーティクルの説明テキストを取得します。値の設定も可能です。 (Article から継承されています。) | |
DestinationObjectName | サブスクライバ側アーティクルのレプリケーション元データベース オブジェクトを取得します。値の設定も可能です。 (Article から継承されています。) | |
DestinationObjectOwner | サブスクライバ側アーティクルのレプリケーション元データベース オブジェクトのスキーマ所有者を取得します。値の設定も可能です。 (Article から継承されています。) | |
FilterClause | アーティクルの水平方向のフィルタ選択のために評価される WHERE (Transact-SQL) 句を取得します。値の設定も可能です。 | |
IdentityRangeManagementOption | アーティクルに対する ID 範囲の管理オプションを取得します。値の設定も可能です。 (Article から継承されています。) | |
IdentityRangeThreshold | 新しい範囲の ID 列値がパブリッシャまたはサブスクライバに割り当てられる値を取得します。値の設定も可能です。 (Article から継承されています。) | |
IsExistingObject | サーバーにオブジェクトが存在するかどうかを取得します。 (ReplicationObject から継承されています。) | |
MultipleColumnUpdate | インフラストラクチャです。 | |
Name | アーティクルの名前を取得します。値の設定も可能です。 (Article から継承されています。) | |
PartitionOption | パラメータ化された行フィルタを使用してアーティクルをフィルタ選択する場合のフィルタ オプションを取得します。値の設定も可能です。 | |
PreCreationMethod | パブリッシュされたオブジェクトがサブスクリプション データベース内に既に存在する場合に行う処理を取得します。値の設定も可能です。 (Article から継承されています。) | |
ProcessingOrder | 同期中のアーティクルの処理順序を取得します。値の設定も可能です。 | |
PublicationName | アーティクルが属するパブリケーションの名前を取得します。値の設定も可能です。 (Article から継承されています。) | |
PublisherIdentityRangeSize | TransArticle オブジェクトの場合、パブリッシャのテーブル列に割り当てられる ID 値の範囲を取得します。値の設定も可能です。MergeArticle オブジェクトの場合、サーバー サブスクリプションを持つサブスクライバのテーブル列に割り当てられる ID 値の範囲を取得します。値の設定も可能です。 (Article から継承されています。) | |
ResolverInfo | COM ベースの競合回避モジュールで使用される追加データとパラメータを取得します。値の設定も可能です。 | |
SchemaOption | アーティクルのスキーマ作成オプションを取得します。値の設定も可能です。 (Article から継承されています。) | |
SnapshotObjectName | アーティクルの初期スナップショット データを表すデータベース オブジェクトの名前を取得します。 | |
SnapshotObjectOwner | アーティクルの初期スナップショット データを表すデータベース オブジェクトの所有者を取得します。 | |
SourceObjectName | パブリッシュされるデータベース オブジェクトの名前を取得します。値の設定も可能です。 (Article から継承されています。) | |
SourceObjectOwner | パブリッシュされるデータベース オブジェクトの所有者を取得します。値の設定も可能です。 (Article から継承されています。) | |
SqlServerName | このオブジェクトの接続先となる Microsoft SQL Server インスタンスの名前を取得します。 (ReplicationObject から継承されています。) | |
Status | マージ アーティクルの状態を取得します。値の設定も可能です。 | |
StreamBlobColumns | バイナリ ラージ オブジェクト (BLOB) 列のレプリケート時にデータ ストリームの最適化が使用されるかどうかを取得します。値の設定も可能です。 | |
SubscriberIdentityRangeSize | サブスクライバのテーブルの ID 列に対して、別の ID 範囲を割り当てることなく挿入可能な新しい行の最大数を取得します。値の設定も可能です。 (Article から継承されています。) | |
SubscriberUploadOption | サブスクライバ側でクライアント サブスクリプションを使用して行われる更新の動作を取得します。値の設定も可能です。 | |
Type | アーティクルの種類を取得します。値の設定も可能です。 (Article から継承されています。) | |
UserData | ユーザーが独自のデータをオブジェクトにアタッチすることを許可するオブジェクト プロパティを取得します。値の設定も可能です。 (ReplicationObject から継承されています。) | |
VerifyResolverSignature | COM ベースの競合回避モジュールのデジタル署名を確認して、信頼できる発行元のものかどうかを調べるオプションを取得します。値の設定も可能です。 | |
VerticalPartition | すべての列がテーブル アーティクルにパブリッシュされるかどうか指定します。 (Article から継承されています。) |
先頭に戻る
メソッド
名前 | 説明 | |
---|---|---|
AddMergeJoinFilter | マージ アーティクルに結合フィルタを追加します。 | |
AddReplicatedColumns | マージ アーティクルに指定された列を追加します。 | |
ChangeMergeJoinFilter | マージ アーティクルに定義されている結合フィルタを変更します。 | |
CheckValidCreation | インフラストラクチャです。 (Article から継承されています。) | |
CheckValidDefinition | インフラストラクチャです。 (Article から継承されています。) | |
CommitPropertyChanges | キャッシュされているすべてのプロパティ変更ステートメントを、Microsoft SQL Server のインスタンスに送信します。 (ReplicationObject から継承されています。) | |
Create | 現在接続されている SQL Server のインスタンス上で、TransArticle オブジェクトまたは MergeArticle オブジェクトの現在のプロパティに基づいて、新しいアーティクルを作成します。 (Article から継承されています。) | |
Decouple | 参照先のレプリケーション オブジェクトをサーバーから切断します。 (ReplicationObject から継承されています。) | |
EnumMergeJoinFilters | マージ アーティクルに対して定義されている結合フィルタを返します。 | |
Equals | (Object から継承されています。) | |
Finalize | (Object から継承されています。) | |
GetChangeCommand | インフラストラクチャです。 (ReplicationObject から継承されています。) | |
GetCreateCommand | インフラストラクチャです。 (ReplicationObject から継承されています。) | |
GetDropCommand | インフラストラクチャです。 (ReplicationObject から継承されています。) | |
GetHashCode | (Object から継承されています。) | |
GetType | (Object から継承されています。) | |
InitializeSharedPropertiesBasedOnExistingArticles | インフラストラクチャです。 | |
InternalRefresh | インフラストラクチャです。 (ReplicationObject から継承されています。) | |
ListReplicatedColumns | 左右に分割されたアーティクルに存在する列を返します。 | |
Load | サーバーから既存のオブジェクトのプロパティを読み込みます。 (ReplicationObject から継承されています。) | |
LoadProperties | サーバーから既存のオブジェクトのプロパティを読み込みます。 (ReplicationObject から継承されています。) | |
MemberwiseClone | (Object から継承されています。) | |
Refresh | オブジェクトのプロパティを再度読み込みます。 (ReplicationObject から継承されています。) | |
Remove | 現在接続されている SQL Server のインスタンス上で、TransArticle オブジェクトまたは MergeArticle オブジェクトの現在のプロパティに基づいて、既存のアーティクルを削除します。 (Article から継承されています。) | |
RemoveMergeJoinFilter | アーティクルから指定されたマージ結合フィルタを削除します。 | |
RemoveReplicatedColumns | 左右にパーティション分割されたアーティクルから既存の列を削除します。 | |
Script | サーバー上で TransArticle オブジェクトまたは MergeArticle オブジェクトを作成または削除するために実行できる Transact-SQL スクリプトを生成します。 (Article から継承されています。) | |
ScriptMergeJoinFilter | マージ アーティクルにアタッチされたマージ結合フィルタの Transact-SQL スクリプトを返します。 | |
ToString | (Object から継承されています。) |
先頭に戻る
説明
この名前空間、クラス、またはメンバは、Microsoft .NET Framework 2.0 でのみサポートされています。
スレッド セーフ
この型の public static (Microsoft Visual Basic では Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンス メンバの場合は、スレッド セーフであるとは限りません。
使用例
この例では、3 つのマージ アーティクルと関連する結合フィルタを作成しています。
// Define the Publisher and publication names.
string publisherName = publisherInstance;
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2008R2";
// Specify article names.
string articleName1 = "Employee";
string articleName2 = "SalesOrderHeader";
string articleName3 = "SalesOrderDetail";
// Specify join filter information.
string filterName12 = "SalesOrderHeader_Employee";
string filterClause12 = "Employee.BusinessEntityID = " +
"SalesOrderHeader.SalesPersonID";
string filterName23 = "SalesOrderDetail_SalesOrderHeader";
string filterClause23 = "SalesOrderHeader.SalesOrderID = " +
"SalesOrderDetail.SalesOrderID";
string salesSchema = "Sales";
string hrSchema = "HumanResources";
MergeArticle article1 = new MergeArticle();
MergeArticle article2 = new MergeArticle();
MergeArticle article3 = new MergeArticle();
MergeJoinFilter filter12 = new MergeJoinFilter();
MergeJoinFilter filter23 = new MergeJoinFilter();
// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);
// Create three merge articles that are horizontally partitioned
// using a parameterized row filter on Employee.BusinessEntityID, which is
// extended to the two other articles using join filters.
try
{
// Connect to the Publisher.
conn.Connect();
// Create each article.
// For clarity, each article is defined separately.
// In practice, iterative structures and arrays should
// be used to efficiently create multiple articles.
// Set the required properties for the Employee article.
article1.ConnectionContext = conn;
article1.Name = articleName1;
article1.DatabaseName = publicationDbName;
article1.SourceObjectName = articleName1;
article1.SourceObjectOwner = hrSchema;
article1.PublicationName = publicationName;
article1.Type = ArticleOptions.TableBased;
// Define the parameterized filter clause based on Hostname.
article1.FilterClause = "Employee.LoginID = HOST_NAME()";
// Set the required properties for the SalesOrderHeader article.
article2.ConnectionContext = conn;
article2.Name = articleName2;
article2.DatabaseName = publicationDbName;
article2.SourceObjectName = articleName2;
article2.SourceObjectOwner = salesSchema;
article2.PublicationName = publicationName;
article2.Type = ArticleOptions.TableBased;
// Set the required properties for the SalesOrderDetail article.
article3.ConnectionContext = conn;
article3.Name = articleName3;
article3.DatabaseName = publicationDbName;
article3.SourceObjectName = articleName3;
article3.SourceObjectOwner = salesSchema;
article3.PublicationName = publicationName;
article3.Type = ArticleOptions.TableBased;
if (!article1.IsExistingObject) article1.Create();
if (!article2.IsExistingObject) article2.Create();
if (!article3.IsExistingObject) article3.Create();
// Select published columns for SalesOrderHeader.
// Create an array of column names to vertically filter out.
// In this example, only one column is removed.
String[] columns = new String[1];
columns[0] = "CreditCardApprovalCode";
// Remove the column.
article2.RemoveReplicatedColumns(columns);
// Define a merge filter clauses that filter
// SalesOrderHeader based on Employee and
// SalesOrderDetail based on SalesOrderHeader.
// Parent article.
filter12.JoinArticleName = articleName1;
// Child article.
filter12.ArticleName = articleName2;
filter12.FilterName = filterName12;
filter12.JoinUniqueKey = true;
filter12.FilterTypes = FilterTypes.JoinFilter;
filter12.JoinFilterClause = filterClause12;
// Add the join filter to the child article.
article2.AddMergeJoinFilter(filter12);
// Parent article.
filter23.JoinArticleName = articleName2;
// Child article.
filter23.ArticleName = articleName3;
filter23.FilterName = filterName23;
filter23.JoinUniqueKey = true;
filter23.FilterTypes = FilterTypes.JoinFilter;
filter23.JoinFilterClause = filterClause23;
// Add the join filter to the child article.
article3.AddMergeJoinFilter(filter23);
}
catch (Exception ex)
{
// Do error handling here and rollback the transaction.
throw new ApplicationException(
"The filtered articles could not be created", ex);
}
finally
{
conn.Disconnect();
}
' Define the Publisher and publication names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2008R2"
' Specify article names.
Dim articleName1 As String = "Employee"
Dim articleName2 As String = "SalesOrderHeader"
Dim articleName3 As String = "SalesOrderDetail"
' Specify join filter information.
Dim filterName12 As String = "SalesOrderHeader_Employee"
Dim filterClause12 As String = "Employee.BusinessEntityID = " + _
"SalesOrderHeader.SalesPersonID"
Dim filterName23 As String = "SalesOrderDetail_SalesOrderHeader"
Dim filterClause23 As String = "SalesOrderHeader.SalesOrderID = " + _
"SalesOrderDetail.SalesOrderID"
Dim salesSchema As String = "Sales"
Dim hrSchema As String = "HumanResources"
Dim article1 As MergeArticle = New MergeArticle()
Dim article2 As MergeArticle = New MergeArticle()
Dim article3 As MergeArticle = New MergeArticle()
Dim filter12 As MergeJoinFilter = New MergeJoinFilter()
Dim filter23 As MergeJoinFilter = New MergeJoinFilter()
' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)
' Create three merge articles that are horizontally partitioned
' using a parameterized row filter on Employee.BusinessEntityID, which is
' extended to the two other articles using join filters.
Try
' Connect to the Publisher.
conn.Connect()
' Create each article.
' For clarity, each article is defined separately.
' In practice, iterative structures and arrays should
' be used to efficiently create multiple articles.
' Set the required properties for the Employee article.
article1.ConnectionContext = conn
article1.Name = articleName1
article1.DatabaseName = publicationDbName
article1.SourceObjectName = articleName1
article1.SourceObjectOwner = hrSchema
article1.PublicationName = publicationName
article1.Type = ArticleOptions.TableBased
' Define the parameterized filter clause based on Hostname.
article1.FilterClause = "Employee.LoginID = HOST_NAME()"
' Set the required properties for the SalesOrderHeader article.
article2.ConnectionContext = conn
article2.Name = articleName2
article2.DatabaseName = publicationDbName
article2.SourceObjectName = articleName2
article2.SourceObjectOwner = salesSchema
article2.PublicationName = publicationName
article2.Type = ArticleOptions.TableBased
' Set the required properties for the SalesOrderDetail article.
article3.ConnectionContext = conn
article3.Name = articleName3
article3.DatabaseName = publicationDbName
article3.SourceObjectName = articleName3
article3.SourceObjectOwner = salesSchema
article3.PublicationName = publicationName
article3.Type = ArticleOptions.TableBased
' Create the articles, if they do not already exist.
If article1.IsExistingObject = False Then
article1.Create()
End If
If article2.IsExistingObject = False Then
article2.Create()
End If
If article3.IsExistingObject = False Then
article3.Create()
End If
' Select published columns for SalesOrderHeader.
' Create an array of column names to vertically filter out.
' In this example, only one column is removed.
Dim columns() As String = New String(0) {}
columns(0) = "CreditCardApprovalCode"
' Remove the column.
article2.RemoveReplicatedColumns(columns)
' Define a merge filter clauses that filter
' SalesOrderHeader based on Employee and
' SalesOrderDetail based on SalesOrderHeader.
' Parent article.
filter12.JoinArticleName = articleName1
' Child article.
filter12.ArticleName = articleName2
filter12.FilterName = filterName12
filter12.JoinUniqueKey = True
filter12.FilterTypes = FilterTypes.JoinFilter
filter12.JoinFilterClause = filterClause12
' Add the join filter to the child article.
article2.AddMergeJoinFilter(filter12)
' Parent article.
filter23.JoinArticleName = articleName2
' Child article.
filter23.ArticleName = articleName3
filter23.FilterName = filterName23
filter23.JoinUniqueKey = True
filter23.FilterTypes = FilterTypes.JoinFilter
filter23.JoinFilterClause = filterClause23
' Add the join filter to the child article.
article3.AddMergeJoinFilter(filter23)
Catch ex As Exception
' Do error handling here and rollback the transaction.
Throw New ApplicationException( _
"The filtered articles could not be created", ex)
Finally
conn.Disconnect()
End Try
この例では、既存のマージ アーティクルを変更してビジネス ロジック ハンドラにアーティクルを関連付けます。詳細については、「マージ アーティクルにビジネス ロジック ハンドラを実装する方法 (RMO プログラミング)」を参照してください。
// Define the Publisher, publication, and article names.
string publisherName = publisherInstance;
string publicationName = "AdvWorksSalesOrdersMerge";
string publicationDbName = "AdventureWorks2008R2";
string articleName = "SalesOrderHeader";
// Set the friendly name of the business logic handler.
string customLogic = "OrderEntryLogic";
MergeArticle article = new MergeArticle();
// Create a connection to the Publisher.
ServerConnection conn = new ServerConnection(publisherName);
try
{
// Connect to the Publisher.
conn.Connect();
// Set the required properties for the article.
article.ConnectionContext = conn;
article.Name = articleName;
article.DatabaseName = publicationDbName;
article.PublicationName = publicationName;
// Load the article properties.
if (article.LoadProperties())
{
article.ArticleResolver = customLogic;
}
else
{
// Throw an exception of the article does not exist.
throw new ApplicationException(String.Format(
"{0} is not published in {1}", articleName, publicationName));
}
}
catch (Exception ex)
{
// Do error handling here and rollback the transaction.
throw new ApplicationException(String.Format(
"The business logic handler {0} could not be associated with " +
" the {1} article.",customLogic,articleName), ex);
}
finally
{
conn.Disconnect();
}
' Define the Publisher, publication, and article names.
Dim publisherName As String = publisherInstance
Dim publicationName As String = "AdvWorksSalesOrdersMerge"
Dim publicationDbName As String = "AdventureWorks2008R2"
Dim articleName As String = "SalesOrderHeader"
' Set the friendly name of the business logic handler.
Dim customLogic As String = "OrderEntryLogic"
Dim article As MergeArticle = New MergeArticle()
' Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)
Try
' Connect to the Publisher.
conn.Connect()
' Set the required properties for the article.
article.ConnectionContext = conn
article.Name = articleName
article.DatabaseName = publicationDbName
article.PublicationName = publicationName
' Load the article properties.
If article.LoadProperties() Then
article.ArticleResolver = customLogic
Else
' Throw an exception of the article does not exist.
Throw New ApplicationException(String.Format( _
"{0} is not published in {1}", articleName, publicationName))
End If
Catch ex As Exception
' Do error handling here and rollback the transaction.
Throw New ApplicationException(String.Format( _
"The business logic handler {0} could not be associated with " + _
" the {1} article.", customLogic, articleName), ex)
Finally
conn.Disconnect()
End Try
スレッド セーフ
この型の public static (Visual Basic では Shared) のメンバーはすべて、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。