sp_getqueuedrows (Transact-SQL)

適用対象:SQL Server

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

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 の場合、キュー内のすべてのコマンドが表示されます。

リターン コードの値

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

結果セット

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

列名	データ型	説明
操作	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 権限が必要です。

参照

Updatable Subscriptions for Transactional Replication
Queued Updating Conflict Detection and Resolution
システム ストアド プロシージャ (Transact-SQL)