DEALLOCATE (Transact-SQL)

Artigo
03/07/2014

Remove uma referência de cursor. Quando a última referência de cursor for desalocada, as estruturas de dados que incluem o cursor serão liberadas pelo Microsoft SQL Server.

Aplica-se a: SQL Server (SQL Server 2008 até a versão atual), Banco de dados SQL do Windows Azure (versão inicial até a versão atual).

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

cursor_name
É o nome de um cursor já declarado. Se um cursor global e um cursor local existirem com cursor_name como seu nome, cursor_name se ferirá ao cursor global, se GLOBAL for especificado, e ao cursor local, se GLOBAL não for especificado.
@cursor\_variable\_name
É o nome de uma variável cursor. @cursor\_variable\_name deve ser do tipo cursor.

Comentários

As instruções que operam em cursores usam um nome de cursor ou uma variável de cursor para se referir ao cursor. DEALLOCATE remove a associação entre um cursor e o nome de cursor ou variável de cursor. Se um nome ou uma variável forem os últimos a referenciarem o cursor, ele será desalocado e qualquer recurso usado por ele será liberado. Os bloqueios de rolagem usados para proteger o isolamento de buscas são liberado em DEALLOCATE. Os bloqueios de transação usados para proteger atualizações, incluindo atualizações posicionadas feitas através do cursor, são mantidos até o fim da transação.

A instrução DECLARE CURSOR aloca e associa um cursor a um nome de cursor.

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

Depois que um nome de cursor é associado a um cursor, o nome não pode ser usado para outro cursor do mesmo escopo (GLOBAL ou LOCAL) até que este tenha sido desalocado.

Uma variável de cursor é associada a um cursor usando um destes dois métodos:

Pelo nome usando uma instrução SET que define um cursor como uma variável de cursor.
```
DECLARE @MyCrsrRef CURSOR;
SET @MyCrsrRef = abc;
```
Um cursor também pode ser criado e associado a uma variável sem ter um nome de cursor definido.
```
DECLARE @MyCursor CURSOR;
SET @MyCursor = CURSOR LOCAL SCROLL FOR
SELECT * FROM Person.Person;
```

Uma instrução DEALLOCATE @cursor\_variable\_name remove somente a referência da variável nomeada como o cursor. A variável não é desalocada até que saia do escopo no fim do lote, procedimento armazenado ou gatilho. Depois de uma instrução DEALLOCATE @cursor\_variable\_name, a variável pode ser associada a outro cursor usando a instrução SET.

USE AdventureWorks2012;
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

Uma variável de cursor não precisa ser desalocada explicitamente. A variável é implicitamente desalocada quando sai de escopo.

Permissões

As permissões DEALLOCATE assumem como padrão qualquer usuário válido.

Exemplos

O script a seguir mostra como os cursores persistem até o último nome ou até a variável que os referenciam ser desalocada.

USE AdventureWorks2012;
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