IDENT_INCR (Transact-SQL)

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

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

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

Синтаксис

IDENT_INCR ( 'table_or_view' )

Аргументы

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.

Remarks

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

Примеры

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

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

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

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

Следующий пример возвращает таблицы в базе данных AdventureWorks2025, содержащие столбец идентичности с значением увеличения.

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