IDENT_INCR (Transact-SQL)

Article
12/22/2023

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

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.

Syntaxe

IDENT_INCR ( 'table_or_view' )

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

'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 table Person.Address de la base de données AdventureWorks2022.

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 retourne les tables de la base de données AdventureWorks2022 qui contiennent 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)
DBCC CHECKIDENT (Transact-SQL)
sys.identity_columns (Transact-SQL)