sp_getqueuedrows (Transact-SQL)

更新がキューに保留されているサブスクライバで行を取得します。このストアドプロシージャは、サブスクライバ側でサブスクリプションデータベースについて実行されます。

構文

sp_getqueuedrows [ @tablename = ] 'tablename'
    [ , [ @owner = ] 'owner'
    [ , [ @tranid = ] 'transaction_id' ]

[ @tablename =] 'tablename'
テーブルの名前を指定します。tablename のデータ型は sysname で、既定値はありません。テーブルは、キューに登録されているサブスクリプションの一部でなければなりません。

[ @owner =] 'owner'
サブスクリプションの所有者を指定します。owner のデータ型は sysname で、既定値は NULL です。

[ @tranid = ] 'transaction_id'
出力をトランザクション ID でフィルタ選択できます。transaction_id のデータ型は nvarchar(70) で、既定値は NULL です。指定する場合、キューに登録されたコマンドに関連付けられているトランザクション ID が表示されます。NULL の場合、キュー内のすべてのコマンドが表示されます。

サブスクライブされたテーブルについて、現在、キューに少なくとも 1 つのトランザクションが登録されているすべての行を表示します。

列名	データ型	説明
Action	nvarchar(10)	同期を実行するときに行われるアクションの種類。 INS= 挿入 DEL = 削除 UPD = 更新
Tranid	nvarchar(70)	コマンドが実行されたときのトランザクション ID。
table column1...n		tablename で指定されるテーブルの各列の値。
msrepl_tran_version	uniqueidentifier	この列は、レプリケートされたデータの変更を追跡し、パブリッシャで競合を検出するために使用されます。またこの列は、自動的にテーブルに追加されます。

sp_getqueuedrows は、キュー更新に関係するサブスクライバで使用されます。

sp_getqueuedrows は、キュー更新に関係するが、キューリーダーエージェントによってまだ解決されていない、サブスクリプションデータベース上の指定のテーブルの行を検索します。

sp_getqueuedrows では、tablename で指定されるテーブルに対する SELECT 権限が必要です。

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