@@FETCH_STATUS(Transact-SQL)
현재 연결에서 연 모든 커서에 대해 실행된 마지막 커서 FETCH 문의 상태를 반환합니다.
.gif "항목 링크 아이콘")
구문
@@FETCH_STATUS
반환 값
| 반환 값 | 설명 |
|---|---|
0 |
FETCH 문이 성공적으로 수행되었습니다. |
-1 |
FETCH 문이 실패했거나 행이 결과 집합의 범위를 벗어났습니다. |
-2 |
인출된 행이 없습니다. |
주의
@@FETCH_STATUS는 연결의 모든 커서에 전역으로 적용되므로 @@FETCH_STATUS를 신중히 사용하십시오. FETCH 문이 실행된 후 다른 커서에 대해 다른 FETCH 문을 실행하기 전에 @@FETCH_STATUS의 테스트를 수행해야 합니다. @@FETCH_STATUS의 값은 연결에서 인출이 수행되기 전에 정의되지 않습니다.
예를 들어 사용자는 한 커서에서 FETCH 문을 실행한 다음 다른 커서에서 결과를 열고 처리하는 저장 프로시저를 호출합니다. 호출한 저장 프로시저에서 컨트롤이 반환되면 @@FETCH_STATUS는 저장 프로시저에서 실행된 마지막 FETCH를 반영하고 저장 프로시저가 호출되기 전에 실행된 FETCH 문은 반영하지 않습니다.
특정 커서의 마지막 인출 상태를 검색하려면 sys.dm_exec_cursors 동적 관리 함수의 fetch_status 열을 쿼리하십시오.
반환 형식
integer
예
다음 예에서는 @@FETCH_STATUS를 사용하여 WHILE 루프에 있는 커서 작업을 제어합니다.
DECLARE Employee_Cursor CURSOR FOR
SELECT EmployeeID, Title FROM AdventureWorks.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)