SET IDENTITY_INSERT (Transact-SQL)

Область применения:SQL ServerБаза данных SQL AzureУправляемый экземпляр SQL AzureAzure Synapse AnalyticsБаза данных SQL в Microsoft Fabric

Используя это утверждение, вы можете вставлять явные значения в 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.

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.

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

SELECT *
FROM dbo.Tool;
GO

Удалить таблицу инструментов.

DROP TABLE dbo.Tool;
GO

Связанное содержимое

  • Last updated on