適用対象:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceMicrosoft Fabric の SQL データベース
IDENT_INCRシステム関数は、テーブルやビューの同一列を作成する際に指定されたインクリメント値を返します。
構文
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の単位列には利用できません。
例
A. 指定されたテーブルのインクリメント値を返します
以下の例は、AdventureWorks2025データベースの Person.Address テーブルのインクリメント値を返します。
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