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
- Les noms de tables (
dbo.Tool,pubs.jobs) sont des exemples.