SQLNetHub: SQL Server software tools, articles, eBooks and more!

The set identity_insert Command in SQL Server

by

In this article, we will be discussing about the set identity_insert command in SQL Server.

 

About the “set identity_insert” Command in SQL Server

The set identity_insert command in SQL Server, as the name implies, allows the user to insert explicit values into the identity column of a table. Now, someone might wonder, “why on Earth would somebody want to do that?!”

Oh well, you know, there is always a good reason! 🙂 I can give you some reasons below:

  • Inserting portions of data from the original database to a schema-only copy copy of the same database and you want to maintain the same values for the table’s identity column.
  • Performing a “data-rescue” operation, that is you are trying to fix the data in a corrupted table.
  • etc…

 

Let’s See an Example of  “set identity_insert”

So, as always, an explanation is not enough. you want examples, I want examples, everybody wants examples to fully understand something. Therefore, consider the below simple example.

Let’s say we have the below temporary table named “#myTable“:

CREATE TABLE #myTable
    (
        id INT PRIMARY KEY IDENTITY(1, 1) ,
        code VARCHAR(50) ,
        descr VARCHAR(150)
    );
GO

As you can see, our table’s primary key is the column “id” which is an identity column which started with value 1 and with each new insert is increased by 1.

Now, for some reason, let’s consider that the there was “some problem” during certain operations and the table ended up having the below data:

The set identity_insert command in SQL Server - SQLNetHub Blog

 

As you can see, based on the table’s data logic, there is a record missing, that is the table should contain a record with id=3, code=’code3′ and descr=’descr3′.

Within the context of our example, you are the Database Developer (or DBA in some cases where there is not a segregation of duties, which is wrong) and you are asked to fix this data-related problem by inserting into the table the missing record.

 

Reproducing the error message

If you are a little bit inexperienced, the first thing you would try, would be to directly insert the missing record. However, since “id” is an identity column, this action would result to an error message as shown below:

The set identity_insert command in SQL Server - SQLNetHub Blog

As you can see in the screenshot, you get the error message: Cannot insert explicit value for identity column in table ‘#myTable’ when IDENTITY_INSERT is set to OFF.

 

Using the “set identity_insert” command for resolving the issue

So, here’s where the use of the “set identity_insert” comes in handy. So, you can consider modifying this example’s code as below:

SET IDENTITY_INSERT #myTable ON;
GO	

INSERT INTO #myTable ( id ,
                       code ,
                       descr )
VALUES ( 3, 'code3', 'descr3' );
GO

SET IDENTITY_INSERT #myTable OFF;
GO

After running the above piece of code, as you can see below, you were finally allowed to insert the record with explicitly defining the identity column’s value (in this case id=3):

The set identity_insert command in SQL Server - SQLNetHub Blog

 

Considerations

You need to be careful with identity_insert and use it with caution, because if you make misuse of this command there is always the risk to create data quality issues.

 

 

Strengthen you SQL Server Development Skills – Enroll to our Online Course!

Check our online course titled “Essential SQL Server Development Tips for SQL Developers”
(special limited-time discount included in link).

Via the course, you will sharpen your SQL Server database programming skills via a large set of tips on T-SQL and database development techniques. The course, among other, features over than 30 live demonstrations!

Essential SQL Server Development Tips for SQL Developers - Online Course
(Lifetime Access/ Live Demos / Downloadable Resources and more!)

Enroll Now with Discount!

 

 

Did you find this article useful and interesting? Find hundreds of useful SQL Server programming/development articles in my eBook: “Developing with SQL Server (Second Edition“.

Check our other related SQL Server Development articles.

Check out our latest software releases!

Subscribe to our newsletter and stay up to date!

 

Featured Online Courses:

 

Check our Related SQL Server Development Articles:

 

Rate this article: 1 Star2 Stars3 Stars4 Stars5 Stars (5 votes, average: 4.80 out of 5)

Loading...

Reference: SQLNetHub.com (https://www.sqlnethub.com)

© SQLNetHub



Views: 11,107