IDENT_INCR (Transact-SQL)

  • 發行項

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體

傳回建立資料表或檢視的識別欄位時，所指定的遞增值。

Transact-SQL 語法慣例

Syntax

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)