IDENT_INCR (Transact-SQL)

Renvoie la valeur incrémentielle (sous la forme numeric (**@@**MAXPRECISION,0)) spécifiée lors de la création d'une colonne d'identité dans une table ou dans une vue ayant une colonne d'identité.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

IDENT_INCR ( 'table_or_view' )

Arguments

  • 'table_or_view'
    Expression qui spécifie une table ou une vue dont une valeur incrémentielle d'identité valide doit être vérifiée. table_or_view peut être une constante 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 des valeurs renvoyées

numeric

Exceptions

Retourne la valeur NULL en cas d'erreur ou si un appelant n'est pas autorisé à afficher l'objet.

Dans SQL Server, un utilisateur peut voir uniquement les métadonnées des éléments sécurisables qui lui appartiennent ou pour lesquels il dispose d'un droit d'accès. Cela signifie que les fonctions intégrées générant des métadonnées, telles que IDENT_INCR, peuvent retourner la valeur NULL si l'utilisateur ne dispose d'aucune autorisation sur l'objet. Pour plus d'informations, consultez Configuration de la visibilité des métadonnées et Dépannage de la visibilité des métadonnées.

Exemple

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

L'exemple suivant renvoie la valeur incrémentielle pour la table Person.Address de la base de données AdventureWorks.

USE AdventureWorks;
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 AdventureWorks qui contiennent une colonne d'identité avec une valeur d'incrément.

USE AdventureWorks;
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