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 許可權。