@@FETCH_STATUS (Transact-SQL)
適用於：
SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體
此函數會傳回針對連接目前開啟的任何資料指標所發出的最後一個資料指標 FETCH 陳述式的狀態。
語法
@@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