IDENT_INCR (Transact-SQL)

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceBase de données SQL dans Microsoft Fabric

Retourne la valeur d’incrément spécifiée lors de la création d’une colonne d’identité d’une table ou d’une vue.

Conventions de la syntaxe Transact-SQL

Syntaxe

IDENT_INCR ( 'table_or_view' )  

Arguments

'table_or_view'
Expression qui spécifie la table ou la vue dans laquelle rechercher une valeur incrémentielle d’identité valide. 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 l’appelant n’est pas autorisé à voir l’objet.

Dans SQL Server, un utilisateur peut seulement voir les métadonnées des sécurisables dont il est propriétaire ou pour lesquels il dispose des autorisations nécessaires. Sans autorisation d’objet utilisateur, une fonction intégrée générant des métadonnées, comme IDENT_INCR, risque de retourner NULL. Pour plus d'informations, consultez Metadata Visibility Configuration.

Exemples

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

L’exemple suivant renvoie la valeur d’incrément pour la Person.Address table dans la base de données AdventureWorks2025.

USE AdventureWorks2022;  
GO  
SELECT IDENT_INCR('Person.Address') AS Identity_Increment;  
GO  

B. Renvoi de la valeur incrémentielle de plusieurs tables

L’exemple suivant renvoie les tables de la base de données AdventureWorks2025 qui incluent une colonne d’identité avec une valeur d’incrément.

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

Voici un jeu de résultats partiel.

TABLE_SCHEMA        TABLE_NAME                IDENT_INCR  
------------        ------------------------  ----------  
Person              Address                            1  
Production          ProductReview                      1  
Production          TransactionHistory                 1  
Person              AddressType                        1  
Production          ProductSubcategory                 1  
Person              vAdditionalContactInfo             1  
dbo                 AWBuildVersion                     1  
Production          BillOfMaterials                    1

Voir aussi

Expressions (Transact-SQL)
Fonctions système (Transact-SQL)
IDENT_CURRENT (Transact-SQL)
IDENT_SEED (Transact-SQL)
VÉRIFICATEUR DBC (Transact-SQL)
sys.identity_columns (Transact-SQL)