The set identity_insert Command in SQL Server

The set identity_insert Command in SQL Server

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…

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.

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.

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

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.

I’m curious; have you encountered cases where you needed to use the set identity_insert command in SQL Server? Feel free to comment!

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!

 

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

Loading...

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

© 2018 SQLNetHub

 

Artemakis Artemiou
Artemakis Artemiou is a Senior SQL Server and Software Architect, Author, and a 9 Times Microsoft Data Platform MVP (2009-2018). He has over 15 years of experience in the IT industry in various roles. Artemakis is the founder of SQLNetHub and TechHowTos.com. Artemakis is the creator of the well-known software tools Snippets Generator and DBA Security Advisor. Also, he is the author of many eBooks on SQL Server. Artemakis currently serves as the President of the Cyprus .NET User Group (CDNUG) and the International .NET Association Country Leader for Cyprus (INETA). Artemakis's official website can be found at aartemiou.com.