sp_helpmergearticle (Transact-SQL)

適用対象: SQL サーバー

アーティクルに関する情報を返します。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースまたはサブスクリプション データベースの再発行サブスクライバーで実行されます。

Transact-SQL 構文表記規則

構文

sp_helpmergearticle
    [ [ @publication = ] N'publication' ]
    [ , [ @article = ] N'article' ]
[ ; ]

引数

[ @publication = ] N'publication'

情報を取得するパブリケーションの名前。 @publicationsysname で、既定値は % で、現在のデータベース内のすべてのパブリケーションに含まれるすべてのマージ アーティクルに関する情報を返します。

[ @article = ] N'article'

情報を返すアーティクルの名前。 @articlesysname で、既定値は % で、指定されたパブリケーション内のすべてのマージ アーティクルに関する情報を返します。

結果セット

列名 データ型 説明
id int アーティクルの識別子。
name sysname 記事の名前。
source_owner sysname ソース オブジェクトの所有者の名前。
source_object sysname 追加するアーティクルのソース オブジェクトの名前。
sync_object_owner sysname パブリッシュされたアーティクルを定義するビューの所有者の名前。
sync_object sysname パーティションの初期データを確立するために使用されるカスタム オブジェクトの名前。
description nvarchar (255) 記事の説明。
status tinyint 記事の状態。次のいずれかの値を指定できます。

1 = 非アクティブ

2 = アクティブ

5 = データ定義言語 (DDL) 操作が保留中

6 = 新しく生成されたスナップショットを使用した DDL 操作

注: アーティクルが再初期化されると、 56 の値が 2に変更されます。
creation_script nvarchar (255) サブスクリプション データベースでアーティクルを作成するために使用するオプションのアーティクル スキーマ スクリプトのパスと名前。
conflict_table nvarchar(270) 挿入または更新の競合を格納しているテーブルの名前。
article_resolver nvarchar (255) 記事のカスタム 競合回避モジュール。
subset_filterclause nvarchar(1000) 水平フィルター処理を指定する WHERE 句。
pre_creation_command tinyint 事前作成方法。次のいずれかの値を指定できます。

0 = none

1 = drop

2 = delete

3 = truncate
schema_option binary(8) 記事のスキーマ生成オプションのビットマップ。 このビットマップ オプションの詳細については、「 sp_addmergearticle または sp_changemergearticle」を参照してください。
type smallint 記事の種類。次のいずれかの値を指定できます。

10 = table

32 = ストアド プロシージャ

64 = ビューまたはインデックス付きビュー

128 = ユーザー定義関数

160 = シノニム スキーマのみ
column_tracking int 列レベルの追跡の設定。ここで、 1 は列レベルの追跡がオンであることを意味し、 0 は列レベルの追跡がオフであることを意味します。
resolver_info nvarchar (255) アーティクルの競合回避モジュールの名前。
vertical_partition bit アーティクルが垂直方向にパーティション分割されている場合。ここで 1 は、アーティクルが垂直方向にパーティション分割されていることを意味し、 0 は、アーティクルがパーティション分割されていないことを意味します。
destination_owner sysname コピー先オブジェクトの所有者。 ストアド プロシージャ、ビュー、およびユーザー定義関数 (UDF) スキーマ アーティクルをマージするときのみ適用されます。
identity_support int ID 範囲の自動処理が有効になっている場合。ここで、 1 が有効で、 0 が無効になっています。
pub_identity_range bigint 新しい ID 値を割り当てるときに使用する範囲サイズ。 詳細については、「 ID 列のレプリケート」の「マージ レプリケーション」セクションを参照してください。
identity_range bigint 新しい ID 値を割り当てるときに使用する範囲サイズ。 詳細については、「 ID 列のレプリケート」の「マージ レプリケーション」セクションを参照してください。
threshold int SQL Server Compact または以前のバージョンの SQL Server を実行しているサブスクライバーに使用されるパーセンテージ値。 thresholdは、マージ エージェントが新しい ID 範囲を割り当てるタイミングを制御します。 しきい値で指定された値の割合を使用すると、マージ エージェントによって新しい ID 範囲が作成されます。 詳細については、「 ID 列のレプリケート」の「マージ レプリケーション」セクションを参照してください。
verify_resolver_signature int マージ レプリケーションでリゾルバーを使用する前にデジタル署名が検証された場合。ここで、 0 は署名が検証されていないことを意味し、 1 は署名が信頼できるソースからの署名であるかどうかを確認することを意味します。
destination_object sysname コピー先オブジェクトの名前。 ストアド プロシージャ、ビュー、および UDF スキーマ アーティクルをマージするときのみ適用されます。
allow_interactive_resolver int インタラクティブリゾルバーが記事で使用されている場合。ここで 1 は、このリゾルバーが使用されることを意味し、 0 は使用されていないことを意味します。
fast_multicol_updateproc int 1 つの UPDATE ステートメント内の同じ行の複数の列に変更を適用するマージ エージェントを有効または無効にします。1は、1 つのステートメントで複数の列が更新されることを意味し、0更新された列ごとに個別の UPDATE ステートメントが問題であることを意味します。
check_permissions int 検証されるテーブル レベルのアクセス許可のビットマップを表す整数値。 使用可能な値の一覧については、「 sp_addmergearticle (Transact-SQL)」を参照してください。
processing_order int パブリケーション内のアーティクルにデータ変更が適用される順序。
upload_options tinyint クライアント サブスクリプションを使用してサブスクライバーで行われる更新に対する制限を定義します。次のいずれかの値を指定できます。

0 = クライアント サブスクリプションを使用するサブスクライバーで行われた更新に制限はありません。すべての変更がパブリッシャーにアップロードされます。

1 = 変更は、クライアント サブスクリプションを持つサブスクライバーで許可されますが、パブリッシャーにはアップロードされません。

2 = クライアント サブスクリプションを持つサブスクライバーでは、変更は許可されません。

詳細については、「ダウンロード専用アーティクルを使用したマージ レプリケーションのパフォーマンス最適化」を参照してください。
identityrangemanagementoption int ID 範囲の自動処理が有効かどうかを指定します。 1 が有効で、 0 が無効になっています。
delete_tracking bit 削除をレプリケートするかどうかを指定します。 1 は削除がレプリケートされることを意味し、 0 はレプリケートされていないことを意味します。
compensate_for_errors bit 同期中にエラーが発生したときに補正アクションが実行されるかどうかを示します。ここで、 1 は補正アクションが実行されることを示し、 0 は補正アクションが実行されていないことを意味します。
partition_options tinyint アーティクル内のデータをパーティション分割する方法を定義します。 このオプションを使用すると、すべての行が 1 つのパーティションにのみ属している場合、または 1 つのサブスクリプションにのみ属している場合に、パフォーマンスの最適化が可能になります。 partition_options には、次のいずれかの値を指定できます。

0 = アーティクルのフィルター処理は静的であるか、パーティションごとにデータの一意のサブセットが生成されません。つまり、"重複する" パーティションです。

1 = パーティションが重複しており、サブスクライバーで行われたデータ操作言語 (DML) の更新では、行が属するパーティションを変更できません。

2 = アーティクルのフィルター処理によって重複しないパーティションが生成されますが、複数のサブスクライバーが同じパーティションを受け取ることができます。

3 = アーティクルのフィルター処理により、サブスクリプションごとに一意の重複しないパーティションが生成されます。
artid uniqueidentifier アーティクルを一意に識別する識別子。
pubid uniqueidentifier アーティクルがパブリッシュされるパブリケーションを一意に識別する識別子。
stream_blob_columns bit バイナリ ラージ オブジェクト列をレプリケートするときにデータ ストリームの最適化が使用されている場合です。 1 は最適化が使用されていることを意味し、 0 は最適化が使用されていないことを意味します。

リターン コードの値

0 (成功) または 1 (失敗)。

解説

sp_helpmergearticle はマージ レプリケーションで使用されます。

アクセス許可

パブリケーション データベースの固定データベース ロール db_owner メンバー、ディストリビューション データベースの replmonitor ロール、またはパブリケーションのパブリケーション アクセス リストのメンバーのみが、 sp_helpmergearticleを実行できます。

DECLARE @publication AS sysname;
SET @publication = N'AdvWorksSalesOrdersMerge';

USE [AdventureWorks2022]
EXEC sp_helpmergearticle
  @publication = @publication;
GO