sp_getqueuedrows （Transact-SQL）

適用於：SQL Server

擷取在佇列中擱置更新之訂閱者端的數據列。這個預存程式會在訂閱資料庫的訂閱者端執行。

語法

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

[ @tablename = ] 'tablename' 這是數據表的名稱。 tablename 是 sysname，沒有預設值。數據表必須是佇列訂閱的一部分。

[ @owner = ] 'owner' 這是訂用帳戶擁有者。 owner 是 sysname，預設值為 NULL。

[ @tranid = ] 'transaction_id'允許依交易識別碼篩選輸出。 transaction_id為 nvarchar（70），預設值為 NULL。如果指定，則會顯示與佇列命令相關聯的交易標識碼。如果為 NULL，則會顯示佇列中的所有命令。

0 （成功）或 1 （失敗）

顯示目前訂閱數據表至少有一個佇列交易的所有數據列。

資料行名稱	資料類型	描述
動作	nvarchar（10）	同步處理發生時要採取的動作類型。 INS= 插入 DEL = delete UPD = update
Tranid	nvarchar（70）	執行命令的交易識別碼。
資料表資料列1...n		tablename 中所指定數據表之每個數據行的值。
msrepl_tran_version	uniqueidentifier	此數據行用於追蹤複寫資料的變更，以及在發行者端執行衝突偵測。此數據行會自動新增至資料表。

參與佇列更新的訂閱者會使用sp_getqueuedrows 。

sp_getqueuedrows在已參與佇列更新的訂閱資料庫上尋找給定數據表的數據列，但目前尚未由佇列讀取器代理程式解析。

sp_getqueuedrows需要 tablename 中所指定數據表的 SELECT 許可權。