DEALLOCATE(Transact-SQL)

아티클
11/19/2024

적용 대상: Microsoft Fabric의 SQL Server Azure SQL Database Azure SQL Managed Instance SQL 데이터베이스

커서 참조를 제거합니다. 마지막 커서 참조가 할당 취소되면 Microsoft SQL Server에서 커서를 구성하는 데이터 구조의 할당을 취소합니다.

구문

DEALLOCATE { { [ GLOBAL ] cursor_name } | @cursor_variable_name }

인수

cursor_name
이미 선언된 커서의 이름입니다. 글로벌 커서와 지역 커서에 모두 해당 이름으로 cursor_name이 있는 경우 GLOBAL이 지정되면 cursor_name이 글로벌 커서를 참조하고, GLOBAL이 지정되지 않으면 지역 커서를 참조합니다.

@cursor_variable_name
cursor 변수의 이름입니다. @cursor_variable_name은 cursor 형식이어야 합니다.

설명

커서에서 실행되는 문은 커서 이름이나 커서 변수를 사용하여 커서를 참조합니다. DEALLOCATE는 커서와 커서 이름 또는 커서 변수 간의 연결을 제거합니다. 커서를 참조하는 마지막 이름이나 변수의 경우 커서가 할당 해제되고 해당 커서에서 사용하던 모든 리소스가 해제됩니다. DEALLOCATE를 실행하면 인출의 격리를 보호하는 데 사용되는 스크롤 잠금이 해제됩니다. 그러나 해당 커서를 통한 현재 위치 업데이트를 포함하여 업데이트를 보호하는 트랜잭션 잠금은 트랜잭션이 종료될 때까지 유지됩니다.

DECLARE CURSOR 문은 커서 이름을 사용하여 커서를 할당하고 연결합니다.

DECLARE abc SCROLL CURSOR FOR  
SELECT * FROM Person.Person;

커서 이름이 커서와 연결된 후 이 커서를 할당 해제할 때까지 해당 이름은 같은 범위(글로벌 또는 지역)의 다른 커서에 사용할 수 없습니다.

커서 변수를 커서에 연결하려면 다음 중 한 가지 방법을 사용합니다.

이름으로 커서를 커서 변수에 설정하는 SET 문을 사용합니다.
```
DECLARE @MyCrsrRef CURSOR;  
SET @MyCrsrRef = abc;  
```

커서 이름을 정의하지 않고도 커서를 만들고 변수와 연결할 수 있습니다.

DECLARE @MyCursor CURSOR;  
SET @MyCursor = CURSOR LOCAL SCROLL FOR  
SELECT * FROM Person.Person;

DEALLOCATE <@cursor_variable_name> 문은 커서에 대해 명명된 변수의 참조만 제거합니다. 변수는 일괄 처리, 저장 프로시저, 트리거가 종료되어 범위를 벗어날 때까지 할당 해제되지 않습니다. DEALLOCATE <@cursor_variable_name> 문을 실행한 후 SET 문을 사용하여 변수를 다른 커서와 연결할 수 있습니다.

USE AdventureWorks2022;  
GO  
  
DECLARE @MyCursor CURSOR;  
SET @MyCursor = CURSOR LOCAL SCROLL FOR  
    SELECT * FROM Sales.SalesPerson;  
  
DEALLOCATE @MyCursor;  
  
SET @MyCursor = CURSOR LOCAL SCROLL FOR  
    SELECT * FROM Sales.SalesTerritory;  
GO

커서 변수는 명시적으로 할당 해제할 필요가 없으며 범위를 벗어나면 암시적으로 할당 해제됩니다.

사용 권한

DEALLOCATE 권한은 기본적으로 모든 유효한 사용자에게 부여됩니다.

예제

다음은 마지막 커서 이름이나 이를 참조하는 변수가 할당 해제될 때까지 커서가 유지되는 방법을 나타내는 스크립트입니다.

USE AdventureWorks2022;  
GO  
-- Create and open a global named cursor that  
-- is visible outside the batch.  
DECLARE abc CURSOR GLOBAL SCROLL FOR  
    SELECT * FROM Sales.SalesPerson;  
OPEN abc;  
GO  
-- Reference the named cursor with a cursor variable.  
DECLARE @MyCrsrRef1 CURSOR;  
SET @MyCrsrRef1 = abc;  
-- Now deallocate the cursor reference.  
DEALLOCATE @MyCrsrRef1;  
-- Cursor abc still exists.  
FETCH NEXT FROM abc;  
GO  
-- Reference the named cursor again.  
DECLARE @MyCrsrRef2 CURSOR;  
SET @MyCrsrRef2 = abc;  
-- Now deallocate cursor name abc.  
DEALLOCATE abc;  
-- Cursor still exists, referenced by @MyCrsrRef2.  
FETCH NEXT FROM @MyCrsrRef2;  
-- Cursor finally is deallocated when last referencing  
-- variable goes out of scope at the end of the batch.  
GO  
-- Create an unnamed cursor.  
DECLARE @MyCursor CURSOR;  
SET @MyCursor = CURSOR LOCAL SCROLL FOR  
SELECT * FROM Sales.SalesTerritory;  
-- The following statement deallocates the cursor  
-- because no other variables reference it.  
DEALLOCATE @MyCursor;  
GO

다음을 통해 공유

DEALLOCATE(Transact-SQL)

구문

인수

설명

사용 권한

예제

관련 항목

피드백

추가 리소스