sp_getqueuedrows (Transact-SQL)

擷取訂閱者有更新在佇列中暫止的資料列。這個預存程序執行於訂閱資料庫的訂閱者端。

語法

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 = 刪除 UPD = 更新
Tranid	nvarchar(70)	用來執行命令的交易識別碼。
table column1...n		tablename 所指定資料表之每個資料行的值。
msrepl_tran_version	uniqueidentifier	這個資料行用來追蹤複寫資料的變更，以及在發行者端執行衝突偵測。這個資料行會自動加入資料表中。

sp_getqueuedrows 用於參與佇列更新的訂閱者端。

sp_getqueuedrows 會尋找參與佇列更新，但目前尚未被佇列讀取器代理程式解析之訂閱資料庫給定資料表的資料列。

sp_getqueuedrows 需要 tablename 所指定之資料表的 SELECT 權限。