IDENT_CURRENT (Transact-SQL)

Применимо к:SQL ServerБаза данных SQL AzureУправляемый экземпляр SQL AzureБаза данных SQL в Microsoft Fabric

Системная функция возвращает последнее тождественное значение, IDENT_CURRENT сгенерированное для заданной таблицы или представления. Последнее созданное значение идентификатора может относиться к любому сеансу и любой области.

Соглашения о синтаксисе Transact-SQL

Синтаксис

IDENT_CURRENT( 'table_or_view' )

Аргументы

table_or_view

Название таблицы или представления, значение которого возвращается в идентичность. Аргумент table_or_view имеет тип varchar и не имеет значения по умолчанию.

Типы возвращаемых данных

numeric(@@MAXPRECISION,0))

Исключения

Возвращает ошибку NULL или если вызывающий объект не имеет разрешения на просмотр объекта.

В SQL Server пользователь может просматривать только метаданные защищаемых объектов, принадлежащих пользователю или которым предоставлено разрешение. Это означает, что встроенные IDENT_CURRENT функции, использующие метаданные, могут возвращаться NULL , если у пользователя нет разрешения на объект. Дополнительные сведения см. в разделе Metadata Visibility Configuration.

Замечания

IDENT_CURRENTпохож на функции SCOPE_IDENTITY идентичности SQL Server 2000 (8.x) и @@IDENTITY. Все три функции возвращают созданными последними значения идентификаторов. Однако эти функции различаются областью действия и сеансом, в соответствии с которыми определяется термин last.

  • IDENT_CURRENT возвращает последнее значение идентичности, сгенерированное для конкретной таблицы в любой сессии и в любой области.
  • @@IDENTITY возвращает последнее значение идентичности, сгенерированное для любой таблицы текущей сессии во всех областях измерения.
  • SCOPE_IDENTITY возвращает последнее значение идентичности, сгенерированное для любой таблицы текущей сессии и текущей области.

Когда IDENT_CURRENT значение равно NULL (поскольку таблица никогда не содержала строки и не была усечена), IDENT_CURRENT функция возвращает начальное значение.

Неудачно завершившиеся инструкции и транзакции могут изменить текущий идентификатор таблицы и создать пропуски в значениях столбца идентификаторов. Для значения идентификатора никогда не производится откат, несмотря на то, что транзакция, пытавшаяся вставить в таблицу значение, не была зафиксирована. Например, если INSERT инструкция завершается ошибкой IGNORE_DUP_KEY из-за нарушения, текущее значение удостоверения таблицы по-прежнему увеличивается.

При использовании IDENT_CURRENT на представлении, содержащем объединения, NULL возвращается. Это не зависит от того, есть ли столбец идентификаторов только в одной или нескольких объединяемых таблицах.

Внимание

Будьте осторожны при IDENT_CURRENT использовании при прогнозировании следующего сгенерированного значения идентичности. Фактическое сгенерированное значение может отличаться от IDENT_CURRENT плюса IDENT_INCR из-за вставок, выполняемых другими сессиями.

Функция IDENT_CURRENT недоступна для тождественных столбцов в Fabric Data Warehouse.

Примеры

А. Вернуть последнее значение идентичности, сгенерированное для заданной таблицы

В следующем примере возвращается последнее значение идентификатора, созданное для таблицы Person.Address в базе данных AdventureWorks2025.

USE AdventureWorks2022;  
GO  
SELECT IDENT_CURRENT ('Person.Address') AS Current_Identity;  
GO

B. Сравните значения идентичности, возвращаемые IDENT_CURRENT, @@IDENTITY и SCOPE_IDENTITY

В следующем примере показаны различные идентификаторы, возвращаемые функциями IDENT_CURRENT, @@IDENTITY и SCOPE_IDENTITY.

USE AdventureWorks2022;  
GO  
IF OBJECT_ID(N't6', N'U') IS NOT NULL   
    DROP TABLE t6;  
GO  
IF OBJECT_ID(N't7', N'U') IS NOT NULL   
    DROP TABLE t7;  
GO  
CREATE TABLE t6(id INT IDENTITY);  
CREATE TABLE t7(id INT IDENTITY(100,1));  
GO  
CREATE TRIGGER t6ins ON t6 FOR INSERT   
AS  
BEGIN  
   INSERT t7 DEFAULT VALUES  
END;  
GO  
--End of trigger definition  

SELECT id FROM t6;  
--IDs empty.  

SELECT id FROM t7;  
--ID is empty.  

--Do the following in Session 1  
INSERT t6 DEFAULT VALUES;  
SELECT @@IDENTITY;  
/*Returns the value 100. This was inserted by the trigger.*/  

SELECT SCOPE_IDENTITY();  
/* Returns the value 1. This was inserted by the   
INSERT statement two statements before this query.*/  

SELECT IDENT_CURRENT('t7');  
/* Returns value inserted into t7, that is in the trigger.*/  

SELECT IDENT_CURRENT('t6');  
/* Returns value inserted into t6. This was the INSERT statement four statements before this query.*/  

-- Do the following in Session 2.  
SELECT @@IDENTITY;  
/* Returns NULL because there has been no INSERT action   
up to this point in this session.*/  

SELECT SCOPE_IDENTITY();  
/* Returns NULL because there has been no INSERT action   
up to this point in this scope in this session.*/  

SELECT IDENT_CURRENT('t7');  
/* Returns the last value inserted into t7.*/

Связанные материалы

  • Last updated on