sp_addtabletocontents (Transact-SQL)
適用対象: SQL サーバー
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
を実行できます。