sp_describe_cursor(Transact-SQL)
적용 대상:SQL Server
서버 커서의 특성을 보고합니다.
구문
sp_describe_cursor [ @cursor_return = ] output_cursor_variable OUTPUT
{ [ , [ @cursor_source = ] N'local'
, [ @cursor_identity = ] N'local_cursor_name' ]
| [ , [ @cursor_source = ] N'global'
, [ @cursor_identity = ] N'global_cursor_name' ]
| [ , [ @cursor_source = ] N'variable'
, [ @cursor_identity = ] N'input_cursor_variable' ]
}
[;]
인수
[ @cursor_return= ] output_cursor_variable OUTPUT
커서 출력을 수신하기 위해 선언된 커서 변수의 이름입니다. output_cursor_variable 커서이며 기본값이 없으며 sp_describe_cursor 호출될 때 커서와 연결해서는 안 됩니다. 반환된 커서는 스크롤 가능한 동적 읽기 전용 커서입니다.
[ @cursor_source= ] { N'local' | N'global' | N'variable' }
로컬 커서의 이름, 전역 커서 또는 커서 변수를 사용하여 보고되는 커서를 지정할지 여부를 지정합니다. 매개 변수는 nvarchar(30)입니다.
[ @cursor_identity= ] N'local_cursor_name' ]
LOCAL 키워드를 갖거나 LOCAL이 기본값인 DECLARE CURSOR 문에 의해 생성된 커서의 이름입니다. local_cursor_name nvarchar(128)입니다.
[ @cursor_identity= ] N'global_cursor_name' ]
GLOBAL 키워드를 갖거나 GLOBAL이 기본값인 DECLARE CURSOR 문에 의해 생성된 커서의 이름입니다. global_cursor_name nvarchar(128)입니다.
global_cursor_name SQLSetCursorName을 호출하여 이름을 지정한 ODBC 애플리케이션에서 연 API 서버 커서의 이름일 수도 있습니다.
[ @cursor_identity= ] N'input_cursor_variable' ]
열린 커서와 연관된 커서 변수의 이름입니다. input_cursor_variable nvarchar(128)입니다.
반환 코드 값
아니요
반환된 커서
sp_describe_cursor Transact-SQL 커서 출력 매개 변수에 결과 집합을 캡슐화합니다 . 이렇게 하면 Transact-SQL 일괄 처리, 저장 프로시저 및 트리거가 출력을 한 번에 한 행씩 사용할 수 있습니다. 이는 데이터베이스 API 함수에서 바로 프로시저를 호출할 수 없음을 의미하기도 합니다. 커서 출력 매개 변수는 프로그램 변수에 바인딩되어야 하지만 데이터베이스 API는 커서 매개 변수 또는 변수 바인딩을 지원하지 않습니다.
다음 표에서는 sp_describe_cursor 사용하여 반환되는 커서의 형식을 보여 줍니다. 커서의 형식은 sp_cursor_list 사용하여 반환된 형식과 동일합니다.
열 이름 | 데이터 형식 | 설명 |
---|---|---|
reference_name | sysname | 커서를 지칭할 때 사용하는 이름입니다. DECLARE CURSOR 문에서 지정한 이름으로 커서를 참조하는 경우 참조 이름과 커서 이름이 동일합니다. 변수로 커서를 참조하는 경우 변수 이름이 참조 이름이 됩니다. |
cursor_name | sysname | DECLARE CURSOR 문의 커서 이름입니다. SQL Server에서 커서 변수를 커서로 설정하여 커서를 만든 경우 cursor_name 커서 변수의 이름을 반환합니다. 이전 버전의 SQL Server에서 이 출력 열은 시스템에서 생성된 이름을 반환합니다. |
cursor_scope | tinyint | 1 = 로컬 2 = 전역 |
status | int | CURSOR_STATUS 시스템 함수에서 보고한 값과 동일한 값: 1 = 커서 이름 또는 변수에서 참조하는 커서가 열려 있습니다. 커서가 민감하지 않거나 정적 또는 키 집합인 경우 행이 하나 이상 있습니다. 커서가 동적이면 결과 집합에 0개 이상의 행이 있습니다. 0 = 커서 이름 또는 변수에서 참조하는 커서가 열려 있지만 행이 없습니다. 동적 커서는 이 값을 반환하지 않습니다. -1 = 커서 이름 또는 변수에서 참조하는 커서가 닫힙니다. -2 = 커서 변수에만 적용됩니다. 변수에 할당된 커서가 없습니다. 출력 매개 변수가 변수에 커서를 할당했지만 저장 프로시저가 반환하기 전에 커서를 닫았을 수 있습니다. -3 = 지정된 이름의 커서 또는 커서 변수가 없거나 커서 변수에 커서가 할당되지 않았습니다. |
모델 | tinyint | 1 = 둔감(또는 정적) 2 = 키 집합 3 = 동적 4 = 빨리 감기 |
동시성 | tinyint | 1 = 읽기 전용 2 = 스크롤 잠금 3 = 낙관적 |
scrollable | tinyint | 0 = 전달 전용 1 = 스크롤 가능 |
open_status | tinyint | 0 = 닫힘 1 = 열기 |
cursor_rows | decimal(10,0) | 결과 집합의 정규화 행 수입니다. 자세한 내용은 @@CURSOR_ROWS(Transact-SQL)를 참조 하세요. |
fetch_status | smallint | 이 커서의 마지막 인출 상태입니다. 자세한 내용은 @@FETCH_STATUS(Transact-SQL)를 참조하세요. 0 = 페치 성공. -1 = 페치에 실패했거나 커서의 범위를 벗어났습니다. -2 = 요청된 행이 없습니다. -9 = 커서에 대한 인출이 없습니다. |
column_count | smallint | 커서 결과 집합의 열 수입니다. |
row_count | decimal(10,0) | 커서의 마지막 작업의 영향을 받는 행 수입니다. 자세한 내용은 (Transact-SQL)를 참조하세요. |
last_operation | tinyint | 커서에서 마지막으로 수행된 작업: 0 = 커서에서 작업이 수행되지 않았습니다. 1 = OPEN 2 = FETCH 3 = INSERT 4 = UPDATE 5 = DELETE 6 = 닫기 7 = 할당 취소 |
cursor_handle | int | 서버 범위 내의 커서에 대한 고유 값입니다. |
설명
sp_describe_cursor 스크롤 및 업데이트 기능과 같이 서버 커서에 전역적인 특성을 설명합니다. 커서에서 반환된 결과 집합의 특성에 대한 설명에 sp_describe_cursor_columns 사용합니다. 커서에서 참조하는 기본 테이블의 보고서에 sp_describe_cursor_tables 사용합니다. 연결에 표시되는 Transact-SQL 서버 커서의 보고서를 가져오려면 sp_cursor_list 사용합니다.
DECLARE CURSOR 문은 SQL Server가 DECLARE CURSOR에 포함된 SELECT 문을 사용하여 지원할 수 없는 커서 형식을 요청할 수 있습니다. SQL Server는 SELECT 문을 사용하여 지원할 수 있는 형식으로 커서를 암시적으로 변환합니다. DECLARE CURSOR 문에 TYPE_WARNING 지정되면 SQL Server는 변환이 완료되었다는 정보 메시지를 애플리케이션에 보냅니다. 그런 다음 sp_describe_cursor 호출하여 구현된 커서 유형을 확인할 수 있습니다.
사용 권한
public 역할의 멤버 자격이 필요합니다.
예
다음 예제에서는 전역 커서를 열고 커서의 특성을 보고하는 데 사용합니다 sp_describe_cursor
.
USE AdventureWorks2022;
GO
-- Declare and open a global cursor.
DECLARE abc CURSOR STATIC FOR
SELECT LastName
FROM Person.Person;
OPEN abc;
-- Declare a cursor variable to hold the cursor output variable
-- from sp_describe_cursor.
DECLARE @Report CURSOR;
-- Execute sp_describe_cursor into the cursor variable.
EXEC master.dbo.sp_describe_cursor @cursor_return = @Report OUTPUT,
@cursor_source = N'global', @cursor_identity = N'abc';
-- Fetch all the rows from the sp_describe_cursor output cursor.
FETCH NEXT from @Report;
WHILE (@@FETCH_STATUS <> -1)
BEGIN
FETCH NEXT from @Report;
END
-- Close and deallocate the cursor from sp_describe_cursor.
CLOSE @Report;
DEALLOCATE @Report;
GO
-- Close and deallocate the original cursor.
CLOSE abc;
DEALLOCATE abc;
GO
참고 항목
커서
CURSOR_STATUS(Transact-SQL)
DECLARE CURSOR(Transact-SQL)
sp_cursor_list(Transact-SQL)
sp_describe_cursor_columns(Transact-SQL)
sp_describe_cursor_tables(Transact-SQL)
피드백
https://aka.ms/ContentUserFeedback
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요.다음에 대한 사용자 의견 제출 및 보기