LLI Wiki — My Digital Knowledge Base

IDENTITY SQL Server : lire, insérer et réinitialiser les valeurs

Comparer @@IDENTITY, SCOPE_IDENTITY() et IDENT_CURRENT(), insérer une valeur explicite et réinitialiser une colonne IDENTITY avec DBCC CHECKIDENT.

SQL Server propose trois fonctions qui renvoient la dernière valeur IDENTITY générée, chacune avec une portée différente. Cet article les résume, puis montre comment insérer une valeur explicite et réinitialiser une colonne. Les descriptions sont reformulées à partir de la documentation Microsoft Learn : @@IDENTITY, SCOPE_IDENTITY(), IDENT_CURRENT() et DBCC CHECKIDENT.

Lire la dernière valeur IDENTITY

Fonction Renvoie la dernière valeur IDENTITY générée...
@@IDENTITY sur la connexion, pour toute table et toute portée
SCOPE_IDENTITY() sur la connexion, dans la portée courante, pour toute table
IDENT_CURRENT('table') dans la table indiquée, pour toute connexion et toute portée
SELECT @@IDENTITY
SELECT SCOPE_IDENTITY()
SELECT IDENT_CURRENT('dbo.Tool')

Utiliser SCOPE_IDENTITY() après un insert lorsque la table possède des déclencheurs ou que l'instruction s'exécute dans une portée imbriquée, car @@IDENTITY peut renvoyer une valeur générée par un déclencheur.

Insérer une valeur explicite

SET IDENTITY_INSERT permet d'écrire une valeur explicite dans une colonne IDENTITY. Le paramètre se règle par table et doit être désactivé ensuite.

SET IDENTITY_INSERT dbo.Tool ON
GO

-- Insert an explicit ID value of 3.
INSERT INTO dbo.Tool (ID, Name) VALUES (3, 'Garden shovel')
GO

Réinitialiser une colonne IDENTITY

DBCC CHECKIDENT ... RESEED définit la valeur IDENTITY courante. La valeur générée ensuite est la valeur de réinitialisation plus l'incrément.

USE pubs
GO
DBCC CHECKIDENT (jobs, RESEED, 100)
GO

La valeur courante passe à 100 : l'insertion suivante obtient 101. Pour que la prochaine valeur générée soit 1 sur une table vide avec un incrément de 1, réinitialiser à 0.

Remarques

Mastodon LLIMastodon SocialFosstodon