IDENT_INCR (Transact-SQL)

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例

返回在创建表或视图的标识列时指定的递增值。

Transact-SQL 语法约定

语法

IDENT_INCR ( 'table_or_view' )

注意

若要查看 SQL Server 2014 (12.x) 及更早版本的 Transact-SQL 语法，请参阅早期版本文档。

自变量

'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。

示例

A. 返回指定表的增量值

以下示例返回 AdventureWorks2022 数据库中 Person.Address 表的增量值。

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)