적용 대상:
SQL ServerAzure SQL 데이터베이스Azure SQL Managed Instance
CURSOR_STATUS는 특정 매개 변수에 대해 커서 선언이 커서 및 결과 집합을 반환했는지 여부를 보여줍니다.
구문
CURSOR_STATUS
(
{ 'local' , 'cursor_name' }
| { 'global' , 'cursor_name' }
| { 'variable' , 'cursor_variable' }
)
인수
'로컬'
커서 소스가 로컬 커서임을 나타내는 상수입니다.
'cursor_name'
커서의 이름입니다. 커서 이름은 데이터베이스 식별자 규칙을 따라야 합니다.
'global'
커서의 원본이 전역 커서임을 나타내는 상수입니다.
'variable'
커서의 원본이 로컬 변수임을 나타내는 상수를 지정합니다.
'cursor_variable'
커서 변수의 이름입니다. 커서 변수는 cursor 데이터 형식을 사용하여 정의해야 합니다.
반환 형식
smallint (스몰인트)
| 반환 값 | 커서 이름 | 커서 변수 |
|---|---|---|
1 |
커서 결과 집합에 최소 한 개의 행이 있습니다. 변경 감지 불능 커서와 키 집합 커서의 경우 결과 집합에 최소 한 개의 행이 있습니다. 동적 커서의 경우 결과 집합에는 0개, 1개 또는 그 이상의 행이 있습니다. |
이 변수에 할당된 커서가 열려 있습니다. 변경 감지 불능 커서와 키 집합 커서의 경우 결과 집합에 최소 한 개의 행이 있습니다. 동적 커서의 경우 결과 집합에는 0개, 1개 또는 그 이상의 행이 있습니다. |
0 |
커서 결과 집합이 비어 있습니다. 1 | 이 변수에 할당된 커서는 열려 있지만 결과 집합은 확실히 비어 있습니다.* |
-1 |
커서가 닫혀 있습니다. | 이 변수에 할당된 커서가 닫혀 있습니다. |
-2 |
해당 사항 없음 | 다음 중 하나일 가능성이 있습니다. 이전에 호출된 프로시저가 이 OUTPUT 변수에 커서를 할당하지 않았습니다.이전에 할당된 프로시저는 이 OUTPUT 변수에 커서를 할당했지만 프로시저가 완료되면 커서가 닫힌 상태입니다. 따라서 커서의 할당이 취소되고 호출 프로시저로 반환되지 않습니다.선언된 커서 변수에 할당된 커서가 없습니다. |
-3 |
지정된 이름의 커서가 없습니다. | 지정된 이름의 커서 변수가 없거나 커서가 있는 경우 커서가 아직 할당되지 않았습니다. |
1 동적 커서는 이 결과를 반환하지 않습니다.
예
이 예에서는 CURSOR_STATUS 함수를 사용하여 커서의 상태(선언 후, 열린 후, 닫힌 후)를 보여줍니다.
CREATE TABLE #TMP (ii INT);
GO
INSERT INTO #TMP (ii) VALUES (1);
INSERT INTO #TMP (ii) VALUES (2);
INSERT INTO #TMP (ii) VALUES (3);
GO
-- Create a cursor
DECLARE cur CURSOR
FOR SELECT * FROM #TMP;
-- Display the status of the cursor before and after opening
-- and closing the cursor
SELECT CURSOR_STATUS('global', 'cur') AS 'After declare';
OPEN cur;
SELECT CURSOR_STATUS('global', 'cur') AS 'After Open';
CLOSE cur;
SELECT CURSOR_STATUS('global', 'cur') AS 'After Close';
-- Remove the cursor.
DEALLOCATE cur;
-- Drop the table.
DROP TABLE #TMP;
결과 집합은 다음과 같습니다.
After declare
---------------
-1
After Open
----------
1
After Close
-----------
-1