sp_changemergearticle (Transact-SQL)

マージ アーティクルのプロパティを変更します。このストアド プロシージャは、パブリッシャー側でパブリケーション データベースについて実行されます。

トピック リンク アイコンTransact-SQL 構文表記規則

構文

sp_changemergearticle [ @publication = ] 'publication'
        , [ @article = ] 'article'
    [ , [ @property = ] 'property' ]
    [ , [ @value = ] 'value' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]

引数

  • [ @publication=] 'publication'
    アーティクルが存在するパブリケーションの名前を指定します。publication のデータ型は sysname で、既定値はありません。

  • [ @article=] 'article'
    変更するアーティクルの名前を指定します。article のデータ型は sysname で、既定値はありません。

  • [ @property=] 'property'
    指定したアーティクルとパブリケーションの変更対象となるプロパティを指定します。property のデータ型は nvarchar(30) で、表に記載されているいずれかの値を指定できます。

  • [ @value=] 'value'
    対象となるプロパティの新しい値を指定します。value のデータ型は nvarchar(1000) で、表に記載されているいずれかの値を指定できます。

    次の表に、アーティクルのプロパティと、それぞれの値を示します。

    プロパティ

    説明

    allow_interactive_resolver

    true

    アーティクルに対してインタラクティブ競合回避モジュールの使用を有効にします。

     

    false

    アーティクルに対してインタラクティブ競合回避モジュールの使用を無効にします。

    article_resolver

     

    アーティクルのカスタム競合回避モジュールです。テーブル アーティクルにのみ適用されます。

    check_permissions (ビットマップ)

    0x00

    テーブルレベルの権限は確認されません。

     

    0x10

    サブスクライバーで実行された INSERT ステートメントをパブリッシャーで適用する前に、テーブルレベルの権限がパブリッシャーで確認されます。

     

    0x20

    サブスクライバーで実行された UPDATE ステートメントをパブリッシャーで適用する前に、テーブルレベルの権限がパブリッシャーで確認されます。

     

    0x40

    サブスクライバーで実行された DELETE ステートメントをパブリッシャーで適用する前に、テーブルレベルの権限がパブリッシャーで確認されます。

    column_tracking

    true

    列レベルの追跡を有効にします。テーブル アーティクルにのみ適用されます。

    注意
    列レベルの追跡は、パブリッシュ テーブルの列が 246 を超える場合は使用できません。

     

    false

    列レベルの追跡を無効にし、競合検出を行レベルのままにします。テーブル アーティクルにのみ適用されます。

    compensate_for_errors

    true

    同期中にエラーが発生したときに、補正操作が実行されます。詳細については、「sp_addmergearticle」を参照してください。

     

    false

    補正操作は実行されません。これは既定の動作です。詳細については、「sp_addmergearticle」を参照してください。

    重要な注意事項重要
    影響を受ける行のデータは収束されないように見えますが、エラーを解決すると、変更は直ちに適用可能となり、データは収束されます。アーティクルのソース テーブルが別のパブリケーションで既にパブリッシュされている場合、compensate_for_errors の値は、両方のアーティクルで同じであることが必要です。

    creation_script

     

    サブスクリプション データベースにアーティクルを作成する場合に使用される、オプションのアーティクル スキーマ スクリプトのパスと名前です。

    delete_tracking

    true

    DELETE ステートメントがレプリケートされます。これは既定の動作です。

     

    false

    DELETE ステートメントはレプリケートされません。

    重要な注意事項重要
    delete_trackingfalse に設定すると、データが収束されなくなるため、削除した行を手動で取り除く必要があります。

    description

     

    アーティクルを説明するエントリです。

    destination_owner

     

    dbo 以外の場合の、サブスクリプション データベース内にあるオブジェクトの所有者の名前です。

    identity_range

     

    データ型は bigint です。アーティクルの identityrangemanagementoptionauto に設定されているか、auto_identity_rangetrue に設定されている場合に、新しい ID 値を割り当てる範囲のサイズを指定します。テーブル アーティクルにのみ適用されます。詳細については、「ID 列のレプリケート」の「マージ レプリケーション」を参照してください。

    identityrangemanagementoption

    manual

    自動での ID 範囲の管理を無効にします。NOT FOR REPLICATION を使用して ID 列にマークを付け、手動による ID 範囲処理を有効にします。詳細については、「ID 列のレプリケート」を参照してください。

     

    none

    すべての ID 範囲の管理を無効にします。

    logical_record_level_conflict_detection

    true

    論理レコードの任意の場所で変更が行われた場合に、競合を検出します。logical_record_level_conflict_resolutiontrue に設定する必要があります。

     

    false

    column_tracking で指定されている既定の競合検出が使用されます。

    logical_record_level_conflict_resolution

    true

    優先される論理レコード全体で、優先されなかった論理レコードを上書きします。

     

    false

    優先される行は、論理レコードに制約されません。

    partition_options

    0

    アーティクルのフィルター選択は、静的であるか、または各パーティションのデータの一意のサブセットを作成しません。つまり "重複する" パーティションになります。

     

    1

    パーティションは重複しています。サブスクライバーで実行された DML 更新では、行が属するパーティションを変更できません。

     

    2

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

     

    3

    アーティクルのフィルター選択により、各サブスクリプションに対して、一意で重複しないパーティションが作成されます。

    注意
    partition_options に値 3 を指定した場合、該当するアーティクル内にあるデータの各パーティションに対して、単一のサブスクリプションのみを使用できます。第 2 のサブスクリプションを作成し、その新しいサブスクリプションのフィルター選択条件が既存のサブスクリプションと同じパーティションとして判別される場合、既存のサブスクリプションは削除されます。

    pre_creation_command

    none

    サブスクライバーに既にテーブルがある場合、操作は何も行われません。

     

    delete

    サブセット フィルター内の WHERE 句に基づいて削除します。

     

    drop

    テーブルを再作成する前に削除します。

     

    truncate

    レプリケーション先テーブルを切り捨てます。

    processing_order

     

    データ型は int です。マージ パブリケーションでのアーティクルの処理順序を示します。

    pub_identity_range

     

    データ型は bigint です。アーティクルの identityrangemanagementoptionauto に設定されているか、auto_identity_rangetrue に設定されている場合に、サーバー サブスクリプションを使用してサブスクライバーに割り当てる範囲のサイズを指定します。この ID 範囲は、再パブリッシュ元のサブスクライバーが自らのサブスクライバーに割り当てるために予約されています。テーブル アーティクルにのみ適用されます。詳細については、「ID 列のレプリケート」の「マージ レプリケーション」を参照してください。

    published_in_tran_pub

    true

    アーティクルはトランザクション パブリケーションでもパブリッシュされます。

     

    false

    アーティクルはトランザクション パブリケーションではパブリッシュされません。

    resolver_info

     

    カスタム競合回避モジュールが必要とする追加の情報の指定に使用します。一部の Microsoft 競合回避モジュールには、入力用の列が必要です。resolver_info のデータ型は nvarchar(255) で、既定値は NULL です。詳細については、「Microsoft COM ベースの競合回避モジュール」を参照してください。

    schema_option (ビットマップ)

    詳細については、後の「解説」を参照してください。

     

    0x00

    スナップショット エージェントによるスクリプト作成を無効にして、creation_script が提供するスクリプトを使用します。

     

    0x01

    オブジェクト作成スクリプト (CREATE TABLE、CREATE PROCEDURE など) を生成します。

     

    0x10

    対応するクラスター化インデックスを生成します。

     

    0x20

    サブスクライバーでユーザー定義データ型を基本データ型に変換します。ユーザー定義型 (UDT) 列に CHECK 制約または DEFAULT 制約があるときに、UDT 列が主キーの一部になっている場合、または計算列で UDT 列が参照されている場合、このオプションは使用できません。

     

    0x40

    対応する非クラスター化インデックスを生成します。

     

    0x80

    宣言された参照整合性を主キーに含めます。

     

    0x100

    定義されている場合、テーブル アーティクル上のユーザー トリガーをレプリケートします。

     

    0x200

    FOREIGN KEY 制約をレプリケートします。参照するテーブルがパブリケーションの一部でない場合は、パブリッシュされたテーブルのすべての FOREIGN KEY 制約がレプリケートされるわけではありません。

     

    0x400

    CHECK 制約をレプリケートします。

     

    0x800

    既定値をレプリケートします。

     

    0x1000

    列レベルの照合順序をレプリケートします。

     

    0x2000

    パブリッシュされたアーティクルのソース オブジェクトに関連付けられた拡張プロパティをレプリケートします。

     

    0x4000

    テーブル アーティクル上で定義されていれば、一意キーをレプリケートします。

     

    0x8000

    制約のスクリプトを作成しているときに ALTER TABLE ステートメントを生成します。

     

    0x10000

    CHECK 制約を NOT FOR REPLICATION としてレプリケートして、この制約が同期中に適用されないようにします。

     

    0x20000

    FOREIGN KEY 制約を NOT FOR REPLICATION としてレプリケートして、この制約が同期中に適用されないようにします。

     

    0x40000

    パーティション テーブルまたはインデックスに関連付けられているファイル グループをレプリケートします。

     

    0x80000

    パーティション テーブルのパーティション構成をレプリケートします。

     

    0x100000

    パーティション インデックスのパーティション構成をレプリケートします。

     

    0x200000

    テーブルの統計をレプリケートします。

     

    0x400000

    既定のバインドをレプリケートします。

     

    0x800000

    ルールのバインドをレプリケートします。

     

    0x1000000

    フルテキスト インデックスをレプリケートします。

     

    0x2000000

    xml 列にバインドされた XML スキーマ コレクションはレプリケートされません。

     

    0x4000000

    xml 列のインデックスをレプリケートします。

     

    0x8000000

    サブスクライバーにまだ存在しないスキーマを作成します。

     

    0x10000000

    サブスクライバー上で xml 列を ntext に変換します。

     

    0x20000000

    SQL Server 2005 で導入されたラージ オブジェクト データ型 (nvarchar(max)、varchar(max)、および varbinary(max)) を、SQL Server 2000 でサポートされているデータ型に変換します。これらの型をマップする方法の詳細については、「レプリケーション トポロジにおける複数バージョンの SQL Server の使用」の「以前のバージョンに対する新しいデータ型のマッピング」を参照してください。

     

    0x40000000

    権限をレプリケートします。

     

    0x80000000

    パブリケーションの一部ではない任意のオブジェクトに対する依存関係の削除を試行します。

    0x100000000

    このオプションを使用すると、varbinary(max) 列に対して FILESTREAM 属性が指定されている場合にこの属性をレプリケートできます。テーブルを SQL Server 2005 サブスクライバーにレプリケートする場合は、このオプションを指定しないでください。このスキーマ オプションがどのように設定されているかに関係なく、FILESTREAM 列を含むテーブルを SQL Server 2000 サブスクライバーにレプリケートすることはサポートされていません。関連オプション 0x800000000 を参照してください。

    0x200000000

    SQL Server 2008 で導入された日付および時刻データ型 (date、time、datetimeoffset、および datetime2) を、以前のバージョンの SQL Server でサポートされているデータ型に変換します。これらの型をマップする方法の詳細については、「レプリケーション トポロジにおける複数バージョンの SQL Server の使用」の「以前のバージョンに対する新しいデータ型のマッピング」を参照してください。

    0x400000000

    データとインデックスの圧縮オプションをレプリケートします。詳細については、「圧縮されたテーブルおよびインデックスの作成」を参照してください。

    0x800000000

    このオプションを設定すると、サブスクライバーの独自のファイル グループに FILESTREAM データを格納できます。このオプションが設定されていない場合、FILESTREAM データは既定のファイル グループに格納されます。レプリケーションではファイル グループは作成されないので、このオプションを設定する場合は、サブスクライバーでスナップショットを適用する前にファイル グループを作成しておく必要があります。スナップショットを適用する前にオブジェクトを作成する方法の詳細については、「スナップショット適用前および適用後のスクリプトの実行」を参照してください。

    関連オプション 0x100000000 を参照してください。

    0x1000000000

    SQL Server 2005 を実行しているサブスクライバーに UDT 型の列をレプリケートできるように、共通言語ランタイム (CLR) ユーザー定義型 (UDT) を varbinary(max) に変換します。

    0x2000000000

    SQL Server 2005 を実行しているサブスクライバーに hierarchyid 型の列をレプリケートできるように、hierarchyid データ型を varbinary(max) に変換します。レプリケートされたテーブルで hierarchyid 列を使用する方法の詳細については、「hierarchyid (Transact-SQL)」を参照してください。

    0x4000000000

    テーブルのフィルター選択されたインデックスをレプリケートします。フィルター選択されたインデックスの詳細については、「フィルター選択されたインデックスのデザイン ガイドライン」を参照してください。

     

    0x8000000000

    SQL Server 2005 を実行しているサブスクライバーに geography 型および geometry 型の列をレプリケートできるように、これらのデータ型を varbinary(max) に変換します。

     

    0x10000000000

    geography 型と geometry 型の列のインデックスをレプリケートします。

     

    NULL

    システムによってアーティクルの有効なスキーマ オプションが自動生成されます。

    status

    active

    テーブルをパブリッシュするための初期処理スクリプトが実行されます。

     

    unsynced

    スナップショット エージェントが次回実行されるときに、テーブルをパブリッシュする初期処理スクリプトが実行されます。

    stream_blob_columns

    true

    バイナリ ラージ オブジェクトの列をレプリケートするときに、データ ストリームの最適化が使用されます。ただし、論理レコードなど特定のマージ レプリケーション機能によって、ストリームの最適化の使用が妨げられる可能性があります。FILESTREAM が有効になっている場合、stream_blob_columns は true に設定されます。これにより、FILESTREAM データのレプリケーションを最適な形で実行し、メモリ使用率を低減できます。FILESTREAM のテーブル アーティクルで BLOB ストリームが使用されないようにするには、stream_blob_columns を false に設定してください。

    重要な注意事項重要
    このメモリ最適化を有効にすると、同期を行うときにマージ エージェントのパフォーマンスが低下する場合があります。このオプションは、数メガバイトに及ぶデータが含まれる列をレプリケートする場合にのみ使用してください。

     

    false

    バイナリ ラージ オブジェクトの列をレプリケートするときに、最適化が使用されません。

    subscriber_upload_options

    0

    クライアント サブスクリプションを使用したサブスクライバーでの更新は、制限を受けません。変更はパブリッシャーにアップロードされます。このプロパティを変更するには、既存のサブスクライバーの再初期化が必要になる場合があります。

     

    1

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

     

    2

    クライアント サブスクリプションを使用したサブスクライバーでの変更は許可されません。

    subset_filterclause

     

    行方向のフィルター選択を指定する WHERE 句です。テーブル アーティクルにのみ適用されます。

    重要な注意事項重要
    パラメーター化された行フィルター句では列名に関数を適用しないことをお勧めします。これは、LEFT([MyColumn]) = SUSER_SNAME() のように指定すると、パフォーマンスに問題が生じるためです。フィルター句に HOST_NAME を指定して HOST_NAME 値よりも優先的に使用する場合は、CONVERT を使ってデータ型を変換する必要があります。このようなケースのベスト プラクティスに関する詳細については、「パラメーター化された行フィルター」の「HOST_NAME() 値の上書き」を参照してください。

    threshold

     

    SQL Server Compact 3.5 SP2 または以前のバージョンの SQL Server を実行しているサブスクライバーで使用されるパーセンテージ値です。threshold によって、マージ エージェントがどの時点で新しい ID 範囲を割り当てるかが制御されます。threshold で指定されているパーセンテージ値が使用される場合、マージ エージェントは新しい ID 範囲を作成します。identityrangemanagementoptionauto に設定されているとき、または auto_identity_rangetrue に設定されているときに使用します。テーブル アーティクルにのみ適用されます。詳細については、「ID 列のレプリケート」の「マージ レプリケーション」を参照してください。

    verify_resolver_signature

    1

    カスタム競合回避モジュールのデジタル署名について、信頼されるソースからの署名であるかを判断するための検証を行います。

     

    0

    カスタム競合回避モジュールのデジタル署名について、信頼されるソースからの署名であるかを判断するための検証を行いません。

    NULL (既定値)

     

    property 用にサポートされている値の一覧を返します。

  • [ @force_invalidate_snapshot = ] force_invalidate_snapshot
    このストアド プロシージャが実行する操作によって既存のスナップショットが無効になることを許可します。force_invalidate_snapshot のデータ型は bit で、既定値は 0 です。

    0 に設定すると、マージ アーティクルへの変更によってスナップショットが無効になることはありません。ストアド プロシージャで、変更に新しいスナップショットが必要であることが検出されると、エラーが発生し、変更は加えられません。

    1 に設定すると、マージ アーティクルの変更によってスナップショットが無効になることがあります。また、新しいスナップショットを必要とする既存のサブスクリプションがある場合は、既存のスナップショットに古いスナップショットのマークを付けて、新しいスナップショットを生成することができます。

    変更によって新しいスナップショットの生成が必要になるプロパティについては、「解説」を参照してください。

  • [ @force_reinit_subscription = ] force_reinit_subscription
    このストアド プロシージャが実行する操作によって、既存のサブスクリプションの再初期化が必要になることを許可します。force_reinit_subscription のデータ型は bit で、既定値は 0 です。

    0 に設定すると、マージ アーティクルへの変更によってサブスクリプションが再初期化されることはありません。変更に既存のサブスクリプションの再初期化が必要であることをストアド プロシージャが検出すると、エラーが発生し、変更は加えられません。

    1 は、マージ アーティクルの変更によって既存のサブスクリプションが再初期化されることを示し、サブスクリプションの再初期化を許可します。

    変更によって既存のサブスクリプションの再初期化が必要になるプロパティについては、「解説」を参照してください。

リターン コードの値

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

説明

sp_changemergearticle はマージ レプリケーションで使用します。

sp_changemergearticle は、sp_addmergearticle で最初に指定されたアーティクルのプロパティを変更する場合に使用されます。これらのプロパティの詳細については、「sp_addmergearticle」を参照してください。

次のプロパティを変更するには、新しいスナップショットを生成する必要があります。また force_invalidate_snapshot パラメーターに値 1 を指定する必要があります。

  • check_permissions

  • column_tracking

  • destination_owner

  • pre_creation_cmd

  • schema_options

  • subset_filterclause

次のプロパティを変更するには、既存のサブスクリプションを再初期化する必要があります。また force_reinit_subscription パラメーターに値 1 を指定する必要があります。

  • check_permissions

  • column_tracking

  • destination_owner

  • subscriber_upload_options

  • subset_filterclause

partition_options に 3 を指定すると、マージ エージェントが実行されるたびにメタデータがクリーンアップされ、パーティション スナップショットの有効期限が短くなります。このオプションを使用するときは、サブスクライバーが要求したパーティション スナップショットを有効にすることを検討してください。詳細については、「パラメータ化されたフィルタを使用したマージ パブリケーションのスナップショット」を参照してください。

column_tracking プロパティを設定するときに、テーブルが他のマージ パブリケーションで既にパブリッシュされている場合は、列追跡の値を、このテーブルに基づく既存のアーティクルが使用している値と同じにする必要があります。このパラメーターは、テーブル アーティクルのみに固有のものです。

同一のテーブルに基づいているアーティクルを、複数のパブリケーションがパブリッシュしている場合、1 つのアーティクルの delete_tracking プロパティまたは compensate_for_errors プロパティを変更すると、同じテーブルに基づいている他のアーティクルにも同じ変更が加えられます。

マージ処理が使用するパブリッシャーのログインまたはユーザー アカウントが正しいテーブル権限を持っていない場合、無効な変更は競合としてログに記録されます。

schema_option の値を変更すると、ビットごとの更新は実行されません。つまり、sp_changemergearticle を使用して schema_option を設定すると、既存のビット設定が無効になる可能性があります。既存の設定を維持するには、設定する値と、schema_option の現在の値の間で、& (ビット演算子 AND) を実行する必要があります。schema_option の現在の値は、sp_helpmergearticle を実行することによって判断できます。

有効なスキーマ オプションの一覧

次の表に、アーティクルの種類に応じて許可される schema_option の値を示します。

アーティクルの種類

スキーマ オプションの値

func schema only

0x01 および 0x2000

indexed view schema only

0x010x0400x01000x20000x400000x1000000、および 0x200000

proc schema only

0x01 および 0x2000

table

すべてのオプション

view schema only

0x010x0400x01000x20000x400000x1000000、および 0x200000

使用例

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

-- Enable column-level conflict tracking.
-- Changing this property requires that existing subscriptions
-- be reinitialized and that a new snapshot be generated.
USE [AdventureWorks2008R2]
EXEC sp_changemergearticle 
  @publication = @publication,
  @article = @article, 
  @property = N'column_tracking', 
  @value = N'true',
  @force_invalidate_snapshot = 1,
  @force_reinit_subscription = 1;
GO

権限

sp_changemergearticle を実行できるのは、sysadmin 固定サーバー ロールまたは db_owner 固定データベース ロールのメンバーだけです。