IDENT_INCR (Transact-SQL)

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

La IDENT_INCR fonction système renvoie la valeur d’incrément spécifiée lors de la création de la 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

Une expression spécifiant la table ou la vue pour vérifier la présence d’une valeur d’incrément 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

Retour NULL en cas d’erreur ou si un appelant n’a pas la permission de vue 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 l’autorisation de l’objet utilisateur, une fonction intégrée émettrice de métadonnées, telle que IDENT_INCR, pourrait retourner NULL. Pour plus d'informations, consultez Metadata Visibility Configuration.

Remarks

La IDENT_INCR fonction n’est pas disponible pour les colonnes d’identité dans Fabric Data Warehouse.

Exemples

R. Retourner la valeur d’incrément pour 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. Retourner la valeur d’incrément provenant 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