共用方式為


@@FETCH_STATUS (Transact-SQL)

適用於:SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體

此函數會傳回針對連接目前開啟的任何資料指標所發出的最後一個資料指標 FETCH 陳述式的狀態。

Transact-SQL 語法慣例

語法

@@FETCH_STATUS  

傳回類型

integer

傳回值

傳回值 描述
 0 FETCH 陳述式成功。
-1 FETCH 陳述式失敗,或資料列已超出結果集。
-2 遺漏提取的資料列。
-9 資料指標並未執行擷取作業。

備註

由於 @@FETCH_STATUS 在連線的所有資料指標的全域範圍內有效,因此,請小心使用。 在執行 FETCH 陳述式之後,@@FETCH_STATUS 的測試必須在針對另一個資料指標執行任何其他 FETCH 陳述式之前進行。 在連線進行任何擷取之前,並未定義 @@FETCH_STATUS

例如,使用者從一個資料指標執行 FETCH 陳述式,然後再呼叫預存程序來開啟和處理來自另一個資料指標的結果。 當控制權從所呼叫的預存程序傳回時,@@FETCH_STATUS 會反映預存程序中所執行的最後一個 FETCH,而不是在呼叫預存程序之前執行的 FETCH 陳述式。

若要擷取特定資料指標的最後一個擷取狀態,請查詢 sys.dm_exec_cursors 動態管理函式的 fetch_status 資料行。

範例

此範例使用 @@FETCH_STATUS 控制 WHILE 迴圈中的資料指標活動。

DECLARE Employee_Cursor CURSOR FOR  
SELECT BusinessEntityID, JobTitle  
FROM AdventureWorks2022.HumanResources.Employee;  
OPEN Employee_Cursor;  
FETCH NEXT FROM Employee_Cursor;  
WHILE @@FETCH_STATUS = 0  
   BEGIN  
      FETCH NEXT FROM Employee_Cursor;  
   END;  
CLOSE Employee_Cursor;  
DEALLOCATE Employee_Cursor;  
GO  

另請參閱

資料指標函數 (Transact-SQL)
FETCH (Transact-SQL)