sp_addtabletocontents (Transact-SQL)

適用対象: SQL サーバー

sp_addtabletocontents は、現在追跡テーブルに含まれていないソース テーブル内のすべての行に対する参照をマージ追跡テーブルに挿入します。 bcpを使用して大量のデータを一括読み込みした場合に、マージ追跡トリガーを起動しない場合は、このオプションを使用します。 このストアド プロシージャは、パブリッシャー側のパブリケーション データベースで実行されます。

Transact-SQL 構文表記規則

構文

sp_addtabletocontents
    [ @table_name = ] N'table_name'
    [ , [ @owner_name = ] N'owner_name' ]
    [ , [ @filter_clause = ] N'filter_clause' ]
[ ; ]

引数

[ @table_name = ] N'table_name'

テーブルの名前。 @table_name は sysname で、既定値はありません。

[ @owner_name = ] N'owner_name'

テーブルの所有者の名前。 @owner_name は sysname で、既定値は NULL です。

[ @filter_clause = ] N'filter_clause'

新しく読み込まれたデータのどの行をマージ追跡テーブルに追加するかを制御するフィルター句を指定します。 @filter_clause は nvarchar(4000) で、既定値は NULL です。 @filter_clauseがNULLされている場合は、一括読み込みされたすべての行が追加されます。

リターン コードの値

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

解説

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

@table_name内の行はrowguidcolによって参照され、参照はマージ追跡テーブルに追加されます。 sp_addtabletocontents は、マージ レプリケーションを使用してパブリッシュされたテーブルにデータを一括コピーした後に使用する必要があります。 このストアド プロシージャは、コピーされた行のトラッキングを実行し、次の同期処理の際に新しい行を確実に挿入します。

アクセス許可

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

関連するコンテンツ

• システム ストアド プロシージャ (Transact-SQL)