适用于:
允许将显式值插入到表的标识列中。
语法
SET IDENTITY_INSERT [ [ database_name . ] schema_name . ] table_name { ON | OFF }
参数
参数名 | 简要说明 |
---|---|
database_name | 指定的表所在的数据库的名称。 |
schema_name | 表所属架构的名称。 |
table_name | 包含标识列的表的名称。 |
备注
任何时候,一个会话中只有一个表的 IDENTITY_INSERT
属性可以设置为 ON
。 如果某个表已将此属性设置为 ON
,则对另一个表发出 SET IDENTITY_INSERT ON
语句时,SQL Server 将返回一个错误信息,指出 SET IDENTITY_INSERT
已设置为 ON
,并报告已将其属性设置为 ON
的表。
如果插入值大于表的当前标识值,则 SQL Server 自动将新插入值作为当前标识值使用。
SET IDENTITY_INSERT
的设置是在执行或运行时设置的,而不是在分析时设置的。
权限
用户必须拥有表,或对表具有 ALTER
权限。
示例
下面的示例将创建一个包含标识列的表,并说明如何使用 SET IDENTITY_INSERT
设置来填充由 DELETE
语句导致的标识值中的空隙。
USE AdventureWorks2012;
GO
-- Create tool table.
CREATE TABLE dbo.Tool(
ID INT IDENTITY NOT NULL PRIMARY KEY,
Name VARCHAR(40) NOT NULL
);
GO
-- Inserting values into products table.
INSERT INTO dbo.Tool(Name)
VALUES ('Screwdriver')
, ('Hammer')
, ('Saw')
, ('Shovel');
GO
-- Create a gap in the identity values.
DELETE dbo.Tool
WHERE Name = 'Saw';
GO
SELECT *
FROM dbo.Tool;
GO
-- Try to insert an explicit ID value of 3;
-- should return an error:
-- An explicit value for the identity column in table 'AdventureWorks2012.dbo.Tool' can only be specified when a column list is used and IDENTITY_INSERT is ON.
INSERT INTO dbo.Tool (ID, Name) VALUES (3, 'Garden shovel');
GO
-- SET IDENTITY_INSERT to ON.
SET IDENTITY_INSERT dbo.Tool ON;
GO
-- Try to insert an explicit ID value of 3.
INSERT INTO dbo.Tool (ID, Name) VALUES (3, 'Garden shovel');
GO
SELECT *
FROM dbo.Tool;
GO
-- Drop products table.
DROP TABLE dbo.Tool;
GO