适用于：
SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsMicrosoft Fabric 中的 SQL 数据库
通过使用这个语句，你可以在表的列中插入显式值 IDENTITY 。
本文及其IDENTITY语法在不同SQL 数据库引擎平台上有所不同。 Microsoft Fabric Data Warehouse时，请在版本下拉列表中选择Fabric Data Warehouse。
语法
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
相关内容
用于SET IDENTITY_INSERT在 Fabric Data Warehouse 的表格列中插入显式值IDENTITY。 当您需要在身份列中插入特定值时使用 SET IDENTITY_INSERT ，比如在数据迁移、灾难恢复或填充维度表中的哨兵值时。
语法
SET IDENTITY_INSERT [ schema_name. ] table_name { ON | OFF }
参数
schema_name
包含该表的模式名称。
table_name
具有标识列的表的名称。
备注
在任何时候，会话中的一个表只能将 IDENTITY_INSERT 属性设置为 ON。 如果一个表已经设置了 ON 该属性，而你为另一个表发出 SET IDENTITY_INSERT ON 了该属性，则错误将识别出该属性已设置的表。
完成显式插入后，回到IDENTITY_INSERTOFF并运行DBCC CHECKIDENT，RESEED以重新对齐身份范围，防止与未来自动生成值发生冲突。
Fabric Data Warehouse 并不保证使用时身份值IDENTITY_INSERT的唯一性。 显式插入的值可能会引入重复，除非你在系统生成更多值前重新 DBCC CHECKIDENT 对齐身份元数据。
权限
你必须拥有这张桌子或获得 ALTER 使用许可。
局限性
SET IDENTITY_INSERT 仅 INSERT 适用于和 COPY INTO 语句。 它不允许你更新现有的身份列值。
示例
A. 将哨兵值插入维度表
最常见的用途 IDENTITY_INSERT 是在数据仓库建立或迁移时，在维度表中填充哨兵值 -1 ，例如“未知”。
-- Create a dimension table with an IDENTITY column
CREATE TABLE dbo.DimCustomer (
CustomerKey BIGINT IDENTITY,
CustomerName VARCHAR(100),
Email VARCHAR(200)
);
-- Enable IDENTITY_INSERT to add sentinel rows
SET IDENTITY_INSERT dbo.DimCustomer ON;
INSERT INTO dbo.DimCustomer (CustomerKey, CustomerName, Email)
VALUES (-1, 'Unknown', 'N/A');
INSERT INTO dbo.DimCustomer (CustomerKey, CustomerName, Email)
VALUES (-2, 'Not Applicable', 'N/A');
SET IDENTITY_INSERT dbo.DimCustomer OFF;
-- Reseed to prevent conflicts with future auto-generated values
DBCC CHECKIDENT('dbo.DimCustomer', RESEED);
B. 在保留现有身份值的同时迁移数据
从SQL Server或Azure Synapse Analytics迁移时，请保留IDENTITY_INSERT现有的身份值并保持引用完整性。
-- Assume dbo.DimProduct has an IDENTITY column named ProductKey
SET IDENTITY_INSERT dbo.DimProduct ON;
INSERT INTO dbo.DimProduct (ProductKey, ProductName, Category, ListPrice)
VALUES (1, 'Widget A', 'Hardware', 19.99),
(2, 'Widget B', 'Hardware', 29.99),
(3, 'Gadget C', 'Electronics', 49.99);
SET IDENTITY_INSERT dbo.DimProduct OFF;
-- Reseed after migration
DBCC CHECKIDENT('dbo.DimProduct', RESEED);
C. 填补身份值的空白
如果从表中删除了行，可以在需要时用来 IDENTITY_INSERT 填补身份序列中的空隙。
CREATE TABLE dbo.Tool (
ID BIGINT IDENTITY,
Name VARCHAR(40) NOT NULL
);
INSERT INTO dbo.Tool (Name)
VALUES ('Screwdriver'), ('Hammer'), ('Saw'), ('Shovel');
-- Delete a row, creating a gap
DELETE FROM dbo.Tool WHERE Name = 'Saw';
-- Fill the gap with an explicit value
SET IDENTITY_INSERT dbo.Tool ON;
INSERT INTO dbo.Tool (ID, Name)
VALUES (3, 'Garden shovel');
SET IDENTITY_INSERT dbo.Tool OFF;
DBCC CHECKIDENT('dbo.Tool', RESEED);
D. 用 COPY INTO 插入显式值
该 COPY INTO 语句支持 IDENTITY_INSERT 在命令中导入显式值的选项。
COPY INTO 选项覆盖了 的 IDENTITY_INSERT会话层级设置。
COPY INTO dbo.Employees (EmployeeID 1, FirstName 2, LastName 3)
FROM 'https://myaccount.blob.core.windows.net/myblobcontainer/folder1/'
WITH (
FILE_TYPE = 'CSV',
IDENTITY_INSERT = 'ON'
);