IDENTITY (Fonction) (Transact-SQL)

Article
12/22/2023

S’applique à :SQL Server Azure SQL Managed Instance

S’utilise uniquement dans une instruction SELECT avec une clause INTO table pour insérer une colonne d’identité dans une nouvelle table. Bien qu'elles soient similaires, la fonction IDENTITY n'est pas identique à la propriété IDENTITY qui est utilisée avec CREATE TABLE et ALTER TABLE.

Notes

Pour créer un numéro à incrémentation automatique qui peut être utilisé dans plusieurs tables ou être appelé par des applications sans faire référence à une table, consultez Numéros de séquence.

Conventions de la syntaxe Transact-SQL

Syntaxe

IDENTITY (data_type [ , seed , increment ] ) AS column_name

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

Arguments

data_type
Type de données de la colonne d'identité. Tous les types de données de la catégorie de type entier sont valides pour une colonne d’identité, à l’exception des types de données bit et decimal.

seed
Entier à affecter à la première ligne de la table. La valeur d’identité suivante est affectée à chaque ligne suivante. Cette valeur est égale à la dernière valeur IDENTITY augmentée de la valeur increment. Si vous ne spécifiez ni seed ni increment, les deux arguments reçoivent par défaut la valeur 1.

increment
Entier à ajouter à la valeur seed pour des lignes successives de la table.

column_name
Nom de la colonne qui doit être insérée dans la nouvelle table.

Types de retour

Retourne le même type que data_type.

Remarques

Étant donné que cette fonction crée une colonne dans une table, vous devez spécifier pour la colonne un nom figurant dans la liste de sélection de l'une des manières suivantes :

--(1)  
SELECT IDENTITY(int, 1,1) AS ID_Num  
INTO NewTable  
FROM OldTable;  
  
--(2)  
SELECT ID_Num = IDENTITY(int, 1, 1)  
INTO NewTable  
FROM OldTable;

Exemples

L’exemple suivant insère toutes les lignes de la table Contact de la base de données AdventureWorks2022database dans une nouvelle table nommée NewContact. La fonction IDENTITY est utilisée pour démarrer les numéros d'identification à 100 au lieu de 1 dans la table NewContact.

USE AdventureWorks2022;  
GO  
IF OBJECT_ID (N'Person.NewContact', N'U') IS NOT NULL  
    DROP TABLE Person.NewContact;  
GO  
ALTER DATABASE AdventureWorks2022 SET RECOVERY BULK_LOGGED;  
GO  
SELECT  IDENTITY(smallint, 100, 1) AS ContactNum,  
        FirstName AS First,  
        LastName AS Last  
INTO Person.NewContact  
FROM Person.Person;  
GO  
ALTER DATABASE AdventureWorks2022 SET RECOVERY FULL;  
GO  
SELECT ContactNum, First, Last FROM Person.NewContact;  
GO

Voir aussi

CREATE TABLE (Transact-SQL)
@@IDENTITY (Transact-SQL)
IDENTITY (Property) (Transact-SQL)
SELECT @local_variable (Transact-SQL)
DBCC CHECKIDENT (Transact-SQL)
sys.identity_columns (Transact-SQL)