IDENT_INCR (Transact-SQL)IDENT_INCR (Transact-SQL)

Область применения: ДаSQL Server ДаБаза данных SQL Azure НетAzure Synapse Analytics (Хранилище данных SQL) НетParallel Data Warehouse APPLIES TO: YesSQL Server YesAzure SQL Database NoAzure Synapse Analytics (SQL DW) NoParallel Data Warehouse

Возвращает значение приращения, указанное при создании столбца идентификаторов в таблице или представлении.Returns the increment value specified when creating a table or view's identity column.

Значок ссылки на статью Синтаксические обозначения в Transact-SQLArticle link icon Transact-SQL Syntax Conventions

СинтаксисSyntax

IDENT_INCR ( 'table_or_view' )  

АргументыArguments

' table_or_view '' table_or_view '
Выражение, указывающее таблицу или представление для проверки на наличие допустимого значения шага приращения идентификатора.Is an expression specifying the table or view to check for a valid identity increment value. Аргумент table_or_view может быть константой строки символов, заключенной в кавычки.table_or_view can be a character string constant enclosed in quotation marks. Он также может быть переменной, функцией или именем столбца.It can also be a variable, a function, or a column name. Аргумент table_or_view имеет тип char, nchar, varchar или nvarchar.table_or_view is char, nchar, varchar, or nvarchar.

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

numeric(@@MAXPRECISION,0))numeric(@@MAXPRECISION,0))

ИсключенияExceptions

Возвращает значение NULL в случае ошибки или если вызывающий объект не имеет разрешений для просмотра текущего объекта.Returns NULL on error or if a caller doesn't have object view permission.

В SQL ServerSQL Server пользователь может просматривать только метаданные защищаемых объектов, которыми он владеет или для которых у него есть разрешения.In SQL ServerSQL Server, a user can only view the metadata of securables they own or have permissions for. Если у пользователя нет разрешений на объект, встроенная функция, создающая метаданные, например IDENT_INCR, может вернуть значение NULL.Without user object permission, a metadata-emitting, built-in function, such as IDENT_INCR, may return NULL. Дополнительные сведения см. в разделе Metadata Visibility Configuration.For more information, see Metadata Visibility Configuration.

ПримерыExamples

A.A. Возврат значения приращения для указанной таблицыReturning the increment value for a specified table

Следующий пример возвращает значение приращения для таблицы Person.Address в базе данных AdventureWorks2012AdventureWorks2012.The following example returns the increment value for the Person.Address table in the AdventureWorks2012AdventureWorks2012 database.

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

Б.B. Возврат значения приращения из нескольких таблицReturning the increment value from multiple tables

В следующем примере функция возвращает таблицы базы данных AdventureWorks2012AdventureWorks2012, содержащей столбец идентификаторов со значением приращения.The following example returns the tables in the AdventureWorks2012AdventureWorks2012 database that includes an identity column with an increment value.

USE AdventureWorks2012;  
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;  

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

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

См. также:See Also

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