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

適用対象: yesSQL Server yesAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

テーブルまたはビューの ID 列を作成するときに指定された増分値を返します。Returns the increment value specified when creating a table or view's identity column.

記事リンク アイコン Transact-SQL 構文表記規則Article link icon Transact-SQL Syntax Conventions

構文Syntax

IDENT_INCR ( 'table_or_view' )  

引数Arguments

' table_or_view '' table_or_view '
有効な ID 増分値を確認するためのテーブルまたはビューを表すを指定します。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_viewcharncharvarchar、または 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

次の例では、AdventureWorks2012AdventureWorks2012 データベース内の Person.Address テーブルの増分値を返します。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.B. 複数のテーブルの増分値を返すReturning the increment value from multiple tables

次の例では、増分値を持つ ID 列を含む、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)