@@FETCH_STATUS(Transact-SQL)

현재 연결에서 연 모든 커서에 대해 실행된 마지막 커서 FETCH 문의 상태를 반환합니다.

항목 링크 아이콘Transact-SQL 구문 표기 규칙

구문

@@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)

도움말 및 정보

SQL Server 2005 지원 받기