IDENT_INCR (Transact-SQL)

Статья
12/22/2023

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

Возвращает значение приращения, указанное при создании столбца идентификаторов в таблице или представлении.

Синтаксис

IDENT_INCR ( 'table_or_view' )

Примечание.

Сведения о синтаксисе Transact-SQL для SQL Server 2014 (12.x) и более ранних версиях см . в документации по предыдущим версиям.

Аргументы

'table_or_view'
Выражение, указывающее таблицу или представление для проверки на наличие допустимого значения шага приращения идентификатора. Аргумент table_or_view может быть константой строки символов, заключенной в кавычки. Он также может быть переменной, функцией или именем столбца. Аргумент table_or_view имеет тип char, nchar, varchar или nvarchar.

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

numeric(@@MAXPRECISION,0))

Исключения

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

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

Примеры

А. Возврат значения приращения для указанной таблицы

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

USE AdventureWorks2022;  
GO  
SELECT IDENT_INCR('Person.Address') AS Identity_Increment;  
GO

B. Возврат значения приращения из нескольких таблиц

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

USE AdventureWorks2022;  
GO  
SELECT TABLE_SCHEMA, TABLE_NAME,   
   IDENT_INCR(TABLE_SCHEMA + '.' + TABLE_NAME) AS IDENT_INCR  
FROM INFORMATION_SCHEMA.TABLES  
WHERE IDENT_INCR(TABLE_SCHEMA + '.' + TABLE_NAME) IS NOT NULL;

Здесь приводится частичный результирующий набор.

TABLE_SCHEMA        TABLE_NAME                IDENT_INCR  
------------        ------------------------  ----------  
Person              Address                            1  
Production          ProductReview                      1  
Production          TransactionHistory                 1  
Person              AddressType                        1  
Production          ProductSubcategory                 1  
Person              vAdditionalContactInfo             1  
dbo                 AWBuildVersion                     1  
Production          BillOfMaterials                    1

См. также

Выражения (Transact-SQL)
Системные функции (Transact-SQL)
IDENT_CURRENT (Transact-SQL)
IDENT_SEED (Transact-SQL)
DBCC CHECKIDENT (Transact-SQL)
sys.identity_columns (Transact-SQL)