sp_getqueuedrows (Transact-SQL)
適用対象: SQL Server
キューで更新が保留されているサブスクライバーの行を取得します。 このストアド プロシージャは、サブスクリプション データベースのサブスクライバーで実行されます。
構文
sp_getqueuedrows
[ @tablename = ] N'tablename'
[ , [ @owner = ] N'owner' ]
[ , [ @tranid = ] N'tranid' ]
[ ; ]
引数
[ @tablename = ] N'tablename'
テーブルの名前。 @tablename は sysname で、既定値はありません。 テーブルは、キューに登録されたサブスクリプションの一部である必要があります。
[ @owner = ] N'owner'
サブスクリプションの所有者。 @owner は sysname で、既定値は NULL
です。
[ @tranid = ] N'tranid'
トランザクション ID で出力をフィルター処理できるようにします。 @tranid は nvarchar(70) で、既定値は NULL
です。 指定した場合、キューに登録されたコマンドに関連付けられているトランザクション ID が表示されます。 NULL
場合は、キュー内のすべてのコマンドが表示されます。
リターン コードの値
0
(成功) または 1
(失敗)。
結果セット
現在、サブスクライブテーブルに対して少なくとも 1 つのキューに登録されたトランザクションを持つすべての行を表示します。
列名 | データ型 | 説明 |
---|---|---|
action |
nvarchar(10) | 同期を実行するときに行われるアクションの種類。INS = insertDEL = deleteUPD = update |
tranid |
nvarchar(70) | コマンドが実行されたトランザクション ID。 |
table column1 ...n |
@tablenameで指定されたテーブルの各列の値。 | |
msrepl_tran_version |
uniqueidentifier | この列は、レプリケートされたデータに対する変更を追跡し、パブリッシャーで競合検出を実行するために使用されます。 この列はテーブルに自動的に追加されます。 |
解説
sp_getqueuedrows
は、キュー更新に参加しているサブスクライバーで使用されます。
sp_getqueuedrows
は、キューに登録された更新に参加したサブスクリプション データベース上の特定のテーブルの行を検索しますが、現在はキュー リーダー エージェントによって解決されていません。
アクセス許可
sp_getqueuedrows
には、@tablenameで指定されたテーブルに対するSELECT
のアクセス許可が必要です。