IDENT_SEED (Transact-SQL)

Article
10/16/2024

S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance

Retourne la valeur de départ d’origine spécifiée lors de la création d’une colonne d’identité dans une table ou une vue. La modification de la valeur actuelle d’une colonne d’identité en utilisant DBCC CHECKIDENT ne modifie pas la valeur retournée par cette fonction.

Conventions de la syntaxe Transact-SQL

Syntaxe

IDENT_SEED ( 'table_or_view' )

Arguments

' table_or_view '
Expression qui spécifie la table ou la vue dans laquelle rechercher une valeur de départ d’identité. table_or_view peut être une constante de type chaîne de caractères entre guillemets, une variable, une fonction ou un nom de colonne. table_or_view est de type char, nchar, varchar ou nvarchar.

Types de retour

numeric(@@MAXPRECISION,0))

Exceptions

Retourne NULL en cas d’erreur ou si un appelant n’est pas autorisé à voir l’objet.

Dans SQL Server, un utilisateur peut seulement voir les métadonnées des éléments sécurisables qui lui appartiennent ou pour lesquels il dispose d’une autorisation. Cette sécurité signifie que les fonctions intégrées générant des métadonnées comme IDENT_SEED peuvent retourner la valeur NULL si l’utilisateur ne dispose d’aucune autorisation sur l’objet. Pour plus d'informations, consultez Metadata Visibility Configuration.

Exemples

R. Renvoi de la valeur de départ d'une table spécifiée

L’exemple suivant renvoie la valeur initiale pour la table AdventureWorks2022 de la base de données Person.Address.

USE AdventureWorks2022;  
GO  
SELECT IDENT_SEED('Person.Address') AS Identity_Seed;  
GO

B. Renvoi de la valeur initiale de plusieurs tables

L’exemple suivant retourne les tables de la base de données AdventureWorks2022 qui contiennent une colonne d’identité avec une valeur de départ.

USE AdventureWorks2022;  
GO  
SELECT TABLE_SCHEMA, TABLE_NAME,   
   IDENT_SEED(TABLE_SCHEMA + '.' + TABLE_NAME) AS IDENT_SEED  
FROM INFORMATION_SCHEMA.TABLES  
WHERE IDENT_SEED(TABLE_SCHEMA + '.' + TABLE_NAME) IS NOT NULL;  
GO

Voici un jeu de résultats partiel.

TABLE_SCHEMA       TABLE_NAME                   IDENT_SEED  
------------       ---------------------------  -----------  
Person             Address                                1  
Production         ProductReview                          1  
Production         TransactionHistory                100000  
Person             AddressType                            1  
Production         ProductSubcategory                     1  
Person             vAdditionalContactInfo                 1  
dbo                AWBuildVersion                         1

Voir aussi

Expressions (Transact-SQL)
Fonctions système (Transact-SQL)
IDENT_CURRENT (Transact-SQL)
IDENT_INCR (Transact-SQL)
DBCC CHECKIDENT (Transact-SQL)
sys.identity_columns (Transact-SQL)

Partager via