sp_getqueuedrows (Transact-SQL)

適用対象: SQL Server

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

Transact-SQL 構文表記規則

構文

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 = insert DEL = delete UPD = update
tranid	nvarchar(70)	コマンドが実行されたトランザクション ID。
table column1 ...n		@tablenameで指定されたテーブルの各列の値。
msrepl_tran_version	uniqueidentifier	この列は、レプリケートされたデータに対する変更を追跡し、パブリッシャーで競合検出を実行するために使用されます。 この列はテーブルに自動的に追加されます。

解説

sp_getqueuedrows は、キュー更新に参加しているサブスクライバーで使用されます。

sp_getqueuedrows は、キューに登録された更新に参加したサブスクリプション データベース上の特定のテーブルの行を検索しますが、現在はキュー リーダー エージェントによって解決されていません。

アクセス許可

sp_getqueuedrowsには、@tablenameで指定されたテーブルに対するSELECTのアクセス許可が必要です。

関連するコンテンツ

• トランザクション レプリケーションの更新可能なサブスクリプション
• 更新可能なサブスクリプション - キュー更新の競合解決
• システム ストアド プロシージャ (Transact-SQL)