SET @local_variable (Transact-SQL)

Define a variável local especificada, criada anteriormente com a instrução DECLARE @local\_variable, para o valor especificado.

Convenções de sintaxe Transact-SQL

Sintaxe

SET 
{ @local_variable
    [ . { property_name | field_name } ] = { expression | udt_name { . | :: } method_name }
}
|
{ @SQLCLR_local_variable.mutator_method
}
|
{ @local_variable
    {+= | -= | *= | /= | %= | &= | ^= | |= } expression
}
| 
  { @cursor_variable = 
    { @cursor_variable | cursor_name 
    | { CURSOR [ FORWARD_ONLY | SCROLL ] 
        [ STATIC | KEYSET | DYNAMIC | FAST_FORWARD ] 
        [ READ_ONLY | SCROLL_LOCKS | OPTIMISTIC ] 
        [ TYPE_WARNING ] 
    FOR select_statement 
        [ FOR { READ ONLY | UPDATE [ OF column_name [ ,...n ] ] } ] 
      } 
    }
} 

Argumentos

• @local_variable
  É o nome de uma variável de qualquer tipo, exceto cursor, text, ntext, image ou table. Os nomes de variável devem começar com uma arroba (@). Os nomes de variável devem ser compatíveis com as regras para identificadores.

• property_name
  É uma propriedade de um tipo definido pelo usuário.

• field_name
  É um campo público de um tipo definido pelo usuário.

• udt_name
  É o nome de um tipo de dado CLR (Common Language Runtime) definido pelo usuário.

• { . | :: }
  Especifica um método de um tipo de dado CLR definido pelo usuário. Para um método de instância (não estático), use um ponto (.). Para um método estático, use dois-pontos duas vezes (::). Para invocar um método, uma propriedade ou um campo de um tipo de dado CLR definido pelo usuário, você deve ter a permissão EXECUTE no tipo.

• method_name**(**argument [ ,... n ] )
  É um método de um tipo definido pelo usuário que obtém um ou mais argumentos para modificar o estado de uma instância de um tipo. Os métodos estáticos devem ser públicos.

• **@**SQLCLR_local_variable
  É uma variável cujo tipo está localizado em um assembly. Para obter mais informações, consulte Conceitos de programação da Integração CLR (Common Language Runtime).

• mutator_method
  É um método no assembly que pode alterar o estado do objeto. SQLMethodAttribute.IsMutator será se aplicado a este método.

• { += | -= | *= | /= | %= | &= | ^= | |= }
  Operador de atribuição composto:

  += Somar e atribuir

  -= Subtrair e atribuir

  *= Multiplicar e atribuir

  /= Dividir e atribuir

  %= Módulo e atribuir

  &= AND bit a bit e atribuir

  ^= XOR bit a bit e atribuir

  |= OR bit a bit e atribuir

• expression
  É qualquer expressão válida.

• cursor_variable
  É o nome de uma variável de cursor. Se a variável de cursor de destino tiver mencionado anteriormente um cursor diferente, essa referência anterior será removida.

• cursor_name
  É o nome de um cursor declarado com o uso da instrução DECLARE CURSOR.

• CURSOR
  Especifica que a instrução SET contém uma declaração de um cursor.

• SCROLL
  Especifica que o cursor dá suporte para todas as opções de busca: FIRST, LAST, NEXT, PRIOR, RELATIVE e ABSOLUTE. SCROLL não pode ser especificado quando FAST_FORWARD também está especificado.

• FORWARD_ONLY
  Especifica que o cursor dá suporte somente para a opção FETCH NEXT. O cursor pode ser recuperado somente em uma direção, da primeira para a última linha. Quando FORWARD_ONLY está especificado sem as palavras-chave STATIC, KEYSET ou DYNAMIC, o cursor é implementado como DYNAMIC. Quando FORWARD_ONLY ou SCROLL não estiverem especificados, FORWARD_ONLY será o padrão; a não ser que as palavras-chave STATIC, KEYSET ou DYNAMIC estejam especificadas. Para os cursores STATIC, KEYSET e DYNAMIC, SCROLL é o padrão.

  Observação
  No SQL Server 2000, as opções de cursor FAST_FORWARD e FORWARD_ONLY são mutuamente exclusivas. Se uma delas for especificada, a outra não poderá ser e ocorrerá um erro. As duas palavras-chave podem ser usadas na mesma instrução DECLARE CURSOR.

• STATIC
  Define um cursor que faz uma cópia temporária dos dados a serem usados por ele. Todas as solicitações para o cursor são respondidas a partir desta tabela temporária em tempdb; portanto, as modificações feitas nas tabelas base não são refletidas nos dados retornados pelas buscas feitas nesse cursor, o qual não permite modificações.

• KEYSET
  Especifica que a associação e a ordem de linhas no cursor são fixas, quando o cursor é aberto. O conjunto de chaves que identificam exclusivamente as linhas é criado na tabela keysetno tempdb. As alterações em valores não chave nas tabelas base, realizadas pelo proprietário do cursor ou confirmadas por outros usuários, são visíveis quando o proprietário rola o cursor. As inserções feitas por outros usuários não são visíveis e não é possível fazer inserções por um cursor de servidor Transact-SQL.

  Se uma linha for excluída, uma tentativa de buscá-la retornará um @@FETCH_STATUS com o valor -2. As atualizações de valores de chave externas ao cursor são similares à exclusão de uma linha antiga, seguida de uma inserção de uma nova linha. A linha com os novos valores não é visível e as tentativas de buscar a linha com os valores antigos retornam um @@FETCH_STATUS de-2. Os novos valores ficarão visíveis se a atualização for executada através do cursor, especificando-se a cláusula WHERE CURRENT OF.

• DYNAMIC
  Define um cursor que reflete todas as alterações de dados feitas nas linhas no seu conjunto de resultados, conforme o proprietário rola o cursor. Os valores de dados, a ordem e a associação das linhas podem ser alterados em cada busca. As opções de busca absoluta e relativa não têm suporte em cursores dinâmicos.

• FAST_FORWARD
  Especifica um cursor FORWARD_ONLY, READ_ONLY, com otimizações habilitadas. FAST_FORWARD não pode ser especificado quando SCROLL também está especificado.

  Observação
  No SQL Server 2000, as opções de cursor FAST_FORWARD e FORWARD_ONLY são mutuamente exclusivas. Se uma delas for especificada, a outra não poderá ser e ocorrerá um erro. As duas palavras-chave podem ser usadas na mesma instrução DECLARE CURSOR.

• READ_ONLY
  Impede que esse cursor faça atualizações. O cursor não pode ser referenciado em uma cláusula WHERE CURRENT OF, em uma instrução UPDATE ou DELETE. Essa opção substitui a funcionalidade padrão de um cursor a ser atualizado.

• SCROLL LOCKS
  Especifica que as atualizações ou exclusões posicionadas executadas pelo cursor terão sucesso garantido. O SQL Server bloqueia as linhas à medida que são lidas no cursor para assegurar sua disponibilidade para modificações posteriores. SCROLL_LOCKS não pode ser especificado quando FAST_FORWARD também está especificado.

• OPTIMISTIC
  Especifica que as atualizações e exclusões posicionadas realizadas pelo cursor não terão êxito se a linha tiver sido atualizada desde que foi lida no cursor. O SQL Server não bloqueia linhas à medida que são lidas no cursor. Em vez disso, ele usa comparações de valores de coluna timestamp, ou um valor de soma de verificação se a tabela não tiver nenhuma coluna timestamp, para determinar se a linha foi modificada depois de lida no cursor. Se a linha foi modificada, a tentativa de atualização ou exclusão posicionada falhará. OPTIMISTIC não poderá ser especificado quando FAST_FORWARD também estiver especificado.

• TYPE_WARNING
  Especifica que uma mensagem de aviso é enviada ao cliente quando o cursor é convertido implicitamente em outro a partir do tipo solicitado.

• FOR select_statement
  É uma instrução SELECT padrão que define o conjunto de resultados do cursor. As palavras-chave COMPUTE, COMPUTE BY, FOR BROWSE e INTO não são permitidas na select_statement de uma declaração de cursor.

  Se DISTINCT, UNION, GROUP BY ou HAVING forem usados, ou se uma expressão de agregação for incluída na select_list, o cursor será criado como STATIC.

  Se cada tabela subjacente não tiver um índice exclusivo e um cursor ISO SCROLL ou um cursor Transact-SQL KEYSET for solicitado, ele será automaticamente um cursor STATIC.

  Se select_statement contiver uma cláusula ORDER BY na qual as colunas não são identificadores de linha exclusivos, um cursor DYNAMIC será convertido em um cursor KEYSET, ou em um cursor STATIC se não for possível abrir um cursor KEYSET. Isto também acontece para um cursor definido com a sintaxe ISO, mas sem a palavra-chave STATIC.

• READ ONLY
  Impede que esse cursor faça atualizações. O cursor não pode ser referenciado em uma cláusula WHERE CURRENT OF, em uma instrução UPDATE ou DELETE. Essa opção substitui a funcionalidade padrão de um cursor a ser atualizado. Essa palavra-chave é diferente do READ_ONLY anterior, pois tem um espaço em vez de um sublinhado entre READ e ONLY.

• UPDATE [OF column_name[ ,... n ] ]
  Define colunas atualizáveis em um cursor. Se OF column_name [,...n] for fornecido, somente as colunas listadas permitirão modificações. Se nenhuma lista for fornecida, todas as colunas poderão ser atualizadas, a menos que o cursor tenha sido definido como READ_ONLY.

Comentários

Depois de uma variável ser declarada, ela é inicializada como NULL. Use a instrução SET para atribuir um valor que não é NULL a uma variável declarada. A instrução SET que atribui um valor à variável retorna um único valor. Ao inicializar várias variáveis, use uma instrução SET separada para cada variável local.

As variáveis podem ser usadas somente em expressões, não em nomes de objeto ou palavras-chave. Para construir instruções Transact-SQL dinâmicas, use EXECUTE.

As regras de sintaxe para SET **@**cursor_variable não incluem as palavras-chave LOCAL e GLOBAL. Quando a sintaxe SET **@**cursor_variable = CURSOR... é usada, o cursor é criado como GLOBAL ou LOCAL, dependendo da configuração padrão da opção de banco de dados do cursor local.

As variáveis de cursor sempre são locais, mesmo se fizerem referência a um cursor global. Quando uma variável de cursor faz referência a um cursor global, o cursor tem as duas referências, uma global e uma local. Para obter mais informações, veja o Exemplo C.

Para obter mais informações, consulte DECLARE CURSOR (Transact-SQL).

O operador de atribuição composto pode ser usado em qualquer lugar onde haja uma atribuição com uma expressão à direita do operador, incluindo variáveis e uma SET em uma instrução UPDATE, SELECT e RECEIVE.

Permissões

Requer associação na função pública. Todos os usuários podem usar SET **@**local_variable.

Exemplos

A. Imprimindo o valor de uma variável inicializada com a instrução SET

O exemplo a seguir cria a variável @myvar, coloca um valor de cadeia de caracteres na variável e imprime o valor da variável @myvar .

DECLARE @myvar char(20);
SET @myvar = 'This is a test';
SELECT @myvar;
GO

B. Usando uma variável local que atribuiu um valor usando SET em uma instrução SELECT

O exemplo a seguir cria uma variável local chamada @state e usa essa variável em uma instrução SELECT para localizar o nome e o sobrenome de todos os funcionários que moram no estado de Oregon.

USE AdventureWorks;
GO
DECLARE @state char(25);
SET @state = N'Oregon';
SELECT RTRIM(FirstName) + ' ' + RTRIM(LastName) AS Name, City
FROM HumanResources.vEmployee
WHERE StateProvinceName = @state;

C. Usando uma atribuição composta para uma variável local

Os dois exemplos a seguir produzem o mesmo resultado. Eles criam uma variável local chamada @NewBalance, multiplicam-na por 10 e exibem o novo valor da variável local em uma instrução SELECT. O segundo exemplo usa um operador de atribuição composto.

/* Example one */
DECLARE  @NewBalance  int ;
SET  @NewBalance  =  10;
SET  @NewBalance  =  @NewBalance  *  10;
SELECT  @NewBalance;

/* Example Two */
DECLARE @NewBalance int = 10;
SET @NewBalance *= 10;
SELECT @NewBalance;

D. Usando SET com um cursor global

O exemplo a seguir cria uma variável local e define a variável de cursor como o nome de cursor global.

DECLARE my_cursor CURSOR GLOBAL 
FOR SELECT * FROM Purchasing.ShipMethod
DECLARE @my_variable CURSOR ;
SET @my_variable = my_cursor ; 
--There is a GLOBAL cursor declared(my_cursor) and a LOCAL variable
--(@my_variable) set to the my_cursor cursor.
DEALLOCATE my_cursor; 
--There is now only a LOCAL variable reference
--(@my_variable) to the my_cursor cursor.

E. Definindo um cursor com SET

O exemplo a seguir usa a instrução SET para definir um cursor.

DECLARE @CursorVar CURSOR;

SET @CursorVar = CURSOR SCROLL DYNAMIC
FOR
SELECT LastName, FirstName
FROM AdventureWorks.HumanResources.vEmployee
WHERE LastName like 'B%';

OPEN @CursorVar;

FETCH NEXT FROM @CursorVar;
WHILE @@FETCH_STATUS = 0
BEGIN
    FETCH NEXT FROM @CursorVar
END;

CLOSE @CursorVar;
DEALLOCATE @CursorVar;

F. Atribuindo um valor de uma consulta

O exemplo a seguir usa uma consulta para atribuir um valor a uma variável.

USE AdventureWorks;
GO
DECLARE @rows int;
SET @rows = (SELECT COUNT(*) FROM Sales.Customer);
SELECT @rows;

G. Atribuindo um valor a uma variável de tipo definida pelo usuário através da modificação de uma propriedade do tipo

O exemplo a seguir define o valor para o tipo Point definido pelo usuário através da modificação do valor da propriedade X do tipo.

DECLARE @p Point;
SET @p.X = @p.X + 1.1;
SELECT @p;
GO

H. Atribuindo um valor a uma variável de tipo definida pelo usuário através da invocação de um método do tipo

O exemplo a seguir define um valor para o tipo point definido pelo usuário através da invocação do método SetXY do tipo.

DECLARE @p Point;
SET @p=point.SetXY(23.5, 23.5);

I. Criando uma variável para um tipo CLR e chamando um método modificador

O exemplo a seguir cria uma variável para o tipo Pointe, depois, executa um método modificador em Point.

CREATE ASSEMBLY mytest from 'c:\test.dll' WITH PERMISSION_SET = SAFE
CREATE TYPE Point EXTERNAL NAME mytest.Point
GO
DECLARE @p Point = CONVERT(Point, '')
SET @p.SetXY(22, 23);

Histórico de alterações

Conteúdo atualizado
Adicionado @SQLCLR_local_variable.mutator_method à seção de Sintaxe e descrições às variáveis na seção de Argumentos.
O exemplo I foi adicionado.

Consulte também

Referência

DECLARE @local\_variable (Transact-SQL)

EXECUTE (Transact-SQL)

SELECT (Transact-SQL)

SET (Transact-SQL)

Conceitos

Expressões (Mecanismo de Banco de Dados)

Usando variáveis e parâmetros (Mecanismo de Banco de Dados)