SET IDENTITY_INSERT （Transact-SQL）

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsMicrosoft Fabric 中的 SQL 数据库

通过使用这个语句，你可以在表的列中插入显式值 IDENTITY 。

Transact-SQL 语法约定

语法

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的设置。

  • 当increment函数的参数IDENTITY为正，且插入的值大于表当前的身份值时，SQL 数据库引擎 会自动使用新插入的值作为当前的身份值。
  • 当increment函数参数IDENTITY为负，且插入的值小于表当前的身份值时，SQL Server 会自动使用新插入的值作为当前身份值。

SET IDENTITY_INSERT 的设置在执行或运行时设置，而不是在分析时设置。

权限

你必须拥有这张桌子或获得 ALTER 使用许可。

示例

下面的示例将创建一个包含标识列的表，并说明如何使用 SET IDENTITY_INSERT 设置来填充由 DELETE 语句导致的标识值中的空隙。

USE AdventureWorks2022;
GO

创建工具表。

CREATE TABLE dbo.Tool
(
    ID INT IDENTITY NOT NULL PRIMARY KEY,
    Name VARCHAR (40) NOT NULL
);
GO

将值插入产品表中。

INSERT INTO dbo.Tool (Name)
VALUES ('Screwdriver'),
    ('Hammer'),
    ('Saw'),
    ('Shovel');
GO

在标识值中创建空白。

DELETE dbo.Tool
WHERE Name = 'Saw';
GO

SELECT *
FROM dbo.Tool;
GO

尝试插入 3 的显式 ID 值。

INSERT INTO dbo.Tool (ID, Name)
VALUES (3, 'Garden shovel');
GO

前述 INSERT 代码返回以下错误：

An explicit value for the identity column in table 'AdventureWorks2022.dbo.Tool' can only be specified when a column list is used and IDENTITY_INSERT is ON.

将 IDENTITY_INSERT 设置为 ON。

SET IDENTITY_INSERT dbo.Tool ON;
GO

尝试插入 3 的显式 ID 值。

INSERT INTO dbo.Tool (ID, Name)
VALUES (3, 'Garden shovel');
GO

SELECT *
FROM dbo.Tool;
GO

放置工具表。

DROP TABLE dbo.Tool;
GO

相关内容

  • Last updated on