sp_addtabletocontents (Transact-SQL)

適用対象:SQL Server

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できます。