次の方法で共有


sp_mergearticlecolumn (Transact-SQL)

適用対象: SQL サーバー

マージ パブリケーションを垂直方向にパーティション分割します。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースで実行されます。

Transact-SQL 構文表記規則

構文

sp_mergearticlecolumn
    [ @publication = ] N'publication'
    , [ @article = ] N'article'
    [ , [ @column = ] N'column' ]
    [ , [ @operation = ] N'operation' ]
    [ , [ @schema_replication = ] N'schema_replication' ]
    [ , [ @force_invalidate_snapshot = ] force_invalidate_snapshot ]
    [ , [ @force_reinit_subscription = ] force_reinit_subscription ]
[ ; ]

引数

[ @publication = ] N'publication'

出版物の名前。 @publicationsysname で、既定値はありません。

[ @article = ] N'article'

パブリケーション内のアーティクルの名前。 @articlesysname で、既定値はありません。

[ @column = ] N'column'

垂直パーティションを作成する列を識別します。 @columnsysname で、既定値は NULL です。 NULL@operationadd に設定されている場合、ソース テーブル内のすべての列が既定でアーティクルに追加されます。 @operationdrop に設定されている場合、@columnNULLできません。 アーティクルから列を除外するには、sp_mergearticlecolumnを実行して@columnを指定し、指定した@articleから削除する各列のdrop@operationを設定します。

[ @operation = ] N'operation'

レプリケーションの状態。 @operationnvarchar(4) で、既定値は add です。

  • add は、レプリケーションの列をマークします。
  • drop は列をクリアします。

[ @schema_replication = ] N'schema_replication'

マージ エージェントの実行時にスキーマ変更を反映することを指定します。 @schema_replicationnvarchar(5) で、既定値は false です。

@schema_replicationでは、falseのみがサポートされています。

[ @force_invalidate_snapshot = ] force_invalidate_snapshot

スナップショットを無効にする機能を有効または無効にします。 @force_invalidate_snapshotビットで、既定値は 0 です。

  • 0 は、マージ アーティクルに対する変更によってスナップショットが無効になることがないように指定します。

  • 1 は、マージ アーティクルに対する変更によってスナップショットが無効になる可能性があることを指定します。その場合は、 1 の値を指定すると、新しいスナップショットが発生するアクセス許可が付与されます。

[ @force_reinit_subscription = ] force_reinit_subscription

サブスクリプションを再初期化する機能を有効または無効にします。 @force_reinit_subscriptionbit で、既定値は 0 です。

  • 0 は、マージ アーティクルに対する変更によってサブスクリプションが再初期化されないように指定します。

  • 1 は、マージ アーティクルに対する変更によってサブスクリプションが再初期化される可能性があることを指定します。その場合は、 1 値を指定すると、サブスクリプションの再初期化が行われるアクセス許可が付与されます。

リターン コードの値

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

解説

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

ID 範囲の自動管理が使用されている場合、アーティクルから ID 列を削除することはできません。 詳細については、「Replicate Identity Columns」 (ID 列のレプリケート) を参照してください。

初期スナップショットの作成後にアプリケーションで新しい垂直パーティションを設定する場合は、新しいスナップショットを生成し、各サブスクリプションに再適用する必要があります。 スナップショットは、次回スケジュールされているスナップショット エージェントおよびディストリビューション エージェント、またはマージ エージェントが実行されるときに適用されます。

行レベルの追跡を使用して競合を検出する場合 (既定値)、ベース テーブルには最大 1,024 列含めることができますが、最大 246 列がパブリッシュされるようにアーティクルから列をフィルター選択する必要があります。 列の追跡を使用する場合、ベース テーブルには最大 246 列を含めることができます。

DECLARE @publication AS sysname;
DECLARE @table1 AS sysname;
DECLARE @table2 AS sysname;
DECLARE @table3 AS sysname;
DECLARE @salesschema AS sysname;
DECLARE @hrschema AS sysname;
DECLARE @filterclause AS nvarchar(1000);
SET @publication = N'AdvWorksSalesOrdersMerge'; 
SET @table1 = N'Employee'; 
SET @table2 = N'SalesOrderHeader'; 
SET @table3 = N'SalesOrderDetail'; 
SET @salesschema = N'Sales';
SET @hrschema = N'HumanResources';
SET @filterclause = N'Employee.LoginID = HOST_NAME()';

-- Add a filtered article for the Employee table.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table1, 
  @source_object = @table1, 
  @type = N'table', 
  @source_owner = @hrschema,
  @schema_option = 0x0004CF1,
  @description = N'article for the Employee table',
  @subset_filterclause = @filterclause;

-- Add an article for the SalesOrderHeader table that is filtered
-- based on Employee and horizontally filtered.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table2, 
  @source_object = @table2, 
  @type = N'table', 
  @source_owner = @salesschema, 
  @vertical_partition = N'true',
  @schema_option = 0x0034EF1,
  @description = N'article for the SalesOrderDetail table';

-- Add an article for the SalesOrderDetail table that is filtered
-- based on SaledOrderHeader.
EXEC sp_addmergearticle 
  @publication = @publication, 
  @article = @table3, 
  @source_object = @table3, 
  @source_owner = @salesschema,
  @description = 'article for the SalesOrderHeader table', 
  @identityrangemanagementoption = N'auto', 
  @pub_identity_range = 100000, 
  @identity_range = 100, 
  @threshold = 80,
  @schema_option = 0x0004EF1;

-- Add all columns to the SalesOrderHeader article.
EXEC sp_mergearticlecolumn 
  @publication = @publication, 
  @article = @table2, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Remove the credit card Approval Code column.
EXEC sp_mergearticlecolumn 
  @publication = @publication, 
  @article = @table2, 
  @column = N'CreditCardApprovalCode', 
  @operation = N'drop', 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Add a merge join filter between Employee and SalesOrderHeader.
EXEC sp_addmergefilter 
  @publication = @publication, 
  @article = @table2, 
  @filtername = N'SalesOrderHeader_Employee', 
  @join_articlename = @table1, 
  @join_filterclause = N'Employee.BusinessEntityID = SalesOrderHeader.SalesPersonID', 
  @join_unique_key = 1, 
  @filter_type = 1, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;

-- Add a merge join filter between SalesOrderHeader and SalesOrderDetail.
EXEC sp_addmergefilter 
  @publication = @publication, 
  @article = @table3, 
  @filtername = N'SalesOrderDetail_SalesOrderHeader', 
  @join_articlename = @table2, 
  @join_filterclause = N'SalesOrderHeader.SalesOrderID = SalesOrderDetail.SalesOrderID', 
  @join_unique_key = 1, 
  @filter_type = 1, 
  @force_invalidate_snapshot = 1, 
  @force_reinit_subscription = 1;
GO

アクセス許可

sysadmin固定サーバー ロールまたは固定データベース ロールdb_ownerのメンバーのみがsp_mergearticlecolumnを実行できます。