SQL - IDENT_INCR() Function

---

---

The increment is a value that is added to the specified identity column, and the column number is incremented by the specified number as the records have been inserted.

The SQL IDENT_INCR() function returns the Increment value of the identity column. The increment value should be specified when we are creating the identity column.

for example −

In this case, we've added an identity column like

IDENTITY(SEED, INCREMENT) == IDENTITY(1, 2)

So, 2 is the increment value of the identity column.

This function returns the numeric value, and the range of the numeric data type is (38, 0).

Syntax

Following is the syntax of the SQL IDENT_INCR() function −

SELECT IDENT_INCR('table_or_view');

where table_or_view is the name of the table or view whose identity increment value is returned. table_or_view can be a character string constant enclosed in quotation marks.

Example

Let's look at the example of SQL IDENT_INCR() function in

To demonstrate this, we are creating two tables using a CREATE statement named "TBL_AAA" and "TBL_BBB", both of which contain an identity column, as shown below.

CREATE TABLE TBL_AAA(
   ID INT IDENTITY(1, 2),
   NAME VARCHAR(30)
   );

CREATE TABLE TBL_BBB(
   ID INT IDENTITY(1, 3),
   NAME VARCHAR(30)
   );

Now, we have to show the created table using the SELECT statement.

-- TBL_AAA Table -
SELECT * FROM TBL_AAA;

-- TBL_BBB Table -
SELECT * FROM TBL_BBB;

Let's see the increment value of the identity column of these tables before inserting any records using the IDENT_INCR function.

Following is the queries −

-- TBL_AAA Table -
SELECT IDENT_INCR('TBL_AAA') AS Increment_Value;

-- TBL_BBB Table -
SELECT IDENT_INCR('TBL_BBB') AS Increment_Value;

Output

Following is the output of the above queries, which shows the increment value of identity column, that is 2 for TBL_AAA and 3 for TBL_BBB

 TBL_AAA Table −
+---------------------+
|    Increment_Value  |
+---------------------+
|                  2  |
+---------------------+

 TBL_BBB Table −
+---------------------+
|    Increment_Value  |
+---------------------+
|                  3  |
+---------------------+

Example

In the following example, we are inserting some values in both tables and showing the increment value of the identity column of these tables.

Let's insert record into these tables using the INSERT statement

-- TBL_AAA Table -
INSERT INTO TBL_AAA (NAME) VALUES('tutorialspoint');
INSERT INTO TBL_AAA (NAME) VALUES('Sarika Singh');

-- TBL_BBB Table -
INSERT INTO TBL_BBB (NAME) VALUES('tutorix');
INSERT INTO TBL_BBB (NAME) VALUES('Aman');
INSERT INTO TBL_BBB (NAME) VALUES('Vivek');

Let's display the inserted records using the SELECT statement

-- TBL_AAA Table -
SELECT * FROM TBL_AAA;

-- TBL_BBB Table -
SELECT * FROM TBL_BBB;

Following is the detail of the TBL_AAA table, where each ID value is incremented by 2 −

+----+-----------------+
| ID |  NAME           |
+----+-----------------+
|  1 |  tutorialspoint |
+----+-----------------+
|  3 |	Sarika Singh   |
+----+-----------------+

Following is the detail of the TBL_BBB table, where each ID value is incremented by 3 −

+----+-----------+
| ID |  NAME     |
+----+-----------+
|  1 |  tutorix  |
+----+-----------+
|  4 |	Aman     |
+----+-----------+
|  7 |  Vivek    |
+----+-----------+

Let's see the increment value of the identity column after the insertion of records using the IDENT_INCR function.

following is the query −

-- TBL_AAA Table -
SELECT IDENT_INCR('TBL_AAA') AS Increment_Value;

-- TBL_BBB Table -
SELECT IDENT_INCR('TBL_BBB') AS Increment_Value;

Output

Following is the output of the above query, which shows the increment value of the identity column of both tables −

 TBL_AAA Table −
+---------------------+
|    Increment_Value  |
+---------------------+
|                  2  |
+---------------------+

 TBL_BBB Table −
+---------------------+
|    Increment_Value  |
+---------------------+
|                  3  |
+---------------------+