Edit

IDENT_INCR (Transact-SQL)

Applies to: SQL Server Azure SQL Database Azure SQL Managed Instance SQL database in Microsoft Fabric

The IDENT_INCR system function returns the increment value specified when creating a table or view's identity column.

Transact-SQL syntax conventions

Syntax

IDENT_INCR ( 'table_or_view' )

Arguments

table_or_view

An expression specifying the table or view to check for a valid identity increment value. table_or_view can be a character string constant enclosed in quotation marks. It can also be a variable, a function, or a column name. table_or_view is char, nchar, varchar, or nvarchar.

Return types

numeric(@@MAXPRECISION,0))

Exceptions

Returns NULL on error or if a caller doesn't have object view permission.

In SQL Server, a user can only view the metadata of securables they own or have permissions for. Without user object permission, a metadata-emitting, built-in function, such as IDENT_INCR, might return NULL. For more information, see Metadata Visibility Configuration.

Remarks

The IDENT_INCR function is not available for identity columns in Fabric Data Warehouse.

Examples

A. Return the increment value for a specified table

The following example returns the increment value for the Person.Address table in the AdventureWorks2025 database.

Note

In Azure SQL Database and SQL database in Microsoft Fabric, the USE statement isn't available. Instead, connect directly to intended database and run the rest of the code sample.

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

B. Return the increment value from multiple tables

The following example returns the tables in the AdventureWorks2025 database that includes an identity column with an increment value.

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;

Here is a partial result set.

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

Related content

  • Last updated on