@@IDENTITY (Transact-SQL)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure

É uma função de sistema que retorna o último valor de identidade inserido.

Convenções de sintaxe de Transact-SQL

Sintaxe

@@IDENTITY  

Tipos de retorno

numeric(38,0)

Comentários

Depois que uma instrução INSERT, SELECT INTO ou de cópia em massa é concluída, @@IDENTITY contém o último valor de identidade gerado por ela. Se a instrução não afetar nenhuma tabela com colunas de identidade, @@IDENTITY retornará NULL. Se forem inseridas várias linhas, gerando vários valores de identidade, @@IDENTITY retornará o último valor de identidade gerado. Se a instrução acionar um ou mais disparadores que executem inserções que geram valores de identidade, a ação de chamar @@IDENTITY imediatamente após a instrução irá retornar o último valor gerado pelos disparadores. Se um disparador for acionado depois de uma ação de inserção em uma tabela que possui uma coluna de identidade e fizer a inserção em outra tabela que não tenha uma coluna de identidade, @@IDENTITY retornará o valor de identidade da primeira inserção. O valor @@IDENTITY não será revertido para uma configuração anterior se a instrução INSERT, SELECT INTO ou a cópia em massa falhar, ou se a transação for revertida.

Instruções e transações com falha podem alterar a identidade atual de uma tabela e criar lacunas nos valores da coluna de identidade. O valor de identidade nunca é revertido, mesmo que a transação que tentou inserir o valor na tabela não seja confirmada. Por exemplo, se uma instrução INSERT falhar por causa de uma violação IGNORE_DUP_KEY, o valor de identidade atual para a tabela ainda será incrementado.

@@IDENTITY, SCOPE_IDENTITY e IDENT_CURRENT são funções semelhantes porque retornam o último valor inserido na coluna IDENTITY de uma tabela.

@@IDENTITY e SCOPE_IDENTITY retornam o último valor de identidade gerado em qualquer tabela da sessão atual. Entretanto, SCOPE_IDENTITY só retorna o valor dentro do escopo atual; @@IDENTITY não é limitada a um escopo específico.

IDENT_CURRENT não é limitado por escopo e sessão, mas a uma tabela especificada. IDENT_CURRENT retorna o valor de identidade gerado para uma tabela específica em qualquer sessão e escopo. Para obter mais informações, confira IDENT_CURRENT (Transact-SQL).

O escopo da função @@IDENTITY é a sessão atual do servidor local no qual ela é executada. Essa função não pode ser se aplicada a servidores remotos ou vinculados. Para obter um valor de identidade em um servidor diferente, execute um procedimento armazenado no servidor remoto ou vinculado e faça com que esse procedimento (ao ser executado no contexto do servidor remoto ou vinculado) obtenha o valor de identidade e o retorne para a conexão de chamada no servidor local.

A replicação pode afetar o valor @@IDENTITY, já que ele é usado dentro dos disparadores de replicação e procedimentos armazenados. @@IDENTITY não será um indicador confiável da identidade mais recente criada pelo usuário se fizer parte de um artigo de replicação. Você pode usar a sintaxe de função SCOPE_IDENTITY() em vez de @@IDENTITY. Para obter mais informações, confira SCOPE_IDENTITY (Transact-SQL)

Exemplos

O exemplo a seguir insere uma linha em uma tabela com uma coluna de identidade (LocationID) e usa @@IDENTITY para exibir o valor de identidade usado na nova linha.

USE AdventureWorks2022;  
GO  
--Display the value of LocationID in the last row in the table.  
SELECT MAX(LocationID) FROM Production.Location;  
GO  
INSERT INTO Production.Location (Name, CostRate, Availability, ModifiedDate)  
VALUES ('Damaged Goods', 5, 2.5, GETDATE());  
GO  
SELECT @@IDENTITY AS 'Identity';  
GO  
--Display the value of LocationID of the newly inserted row.  
SELECT MAX(LocationID) FROM Production.Location;  
GO  

Consulte Também

Funções de sistema (Transact-SQL)
CREATE TABLE (Transact-SQL)
IDENT_CURRENT (Transact-SQL)
INSERT (Transact-SQL)
SCOPE_IDENTITY (Transact-SQL)
SELECT (Transact-SQL)