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