NEXT VALUE FOR (Transact-SQL)

  • [アーティクル]

適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance

指定したシーケンス オブジェクトからシーケンス番号を生成します。

シーケンスの作成と使用の詳細については、「シーケンス番号」を参照してください。 シーケンス番号の範囲を生成するには、sp_sequence_get_range を使用します。

Transact-SQL 構文表記規則

構文

NEXT VALUE FOR [ database_name . ] [ schema_name . ]  sequence_name  
   [ OVER (<over_order_by_clause>) ]

引数

database_name
シーケンス オブジェクトを含むデータベースの名前を指定します。

schema_name
シーケンス オブジェクトを含むスキーマの名前を指定します。

sequence_name
番号を生成するシーケンス オブジェクトの名前を指定します。

over_order_by_clause
シーケンス値がパーティション内の行に割り当てられる順序を決定します。 詳細については、OVER 句 (Transact-SQL) に関する記事を参照してください。

戻り値の型

シーケンスの型を使用して数値を返します。

解説

NEXT VALUE FOR 関数は、ストアド プロシージャやトリガーで使用できます。

ときに、 NEXT VALUE FOR 関数を使用するクエリや既定の制約で同じシーケンス オブジェクトが 2 回以上使用するかどうか、同じシーケンス オブジェクトは、または両方で使用される、値を提供するステートメントでと、結果セット内の行で同じシーケンスを参照するすべての列に対して実行されている既定の制約で同じ値が返されます。

NEXT VALUE FOR 関数は、非決定的であり、生成されるシーケンス値の数が定義されているコンテキストでのみ使用します。 特定のステートメントにおいて、参照されている各シーケンス オブジェクトに使用される値の数の定義を以下に示します。

  • SELECT -参照されているシーケンス オブジェクトごとに、新しい値が 1 回生成、ステートメントの結果内の行ごとです。

  • INSERT ...VALUES -参照されているシーケンス オブジェクトごとに、新しい値が 1 回生成、ステートメントで挿入された行はごとです。

  • UPDATE -各参照されているシーケンス オブジェクトに対して、ステートメントによって更新された各行の新しい値が生成されます。

  • 手続き型ステートメント (DECLARE、SET など) - 参照されている各シーケンス オブジェクトに対して、ステートメントごとに新しい値が生成されます。

制限事項と制約事項

NEXT VALUE FOR 関数は、次のような状況では使用できません。

  • データベースが読み取り専用モードの場合。

  • テーブル値関数の引数として使用する場合。

  • 集計関数の引数として使用する場合。

  • 共通テーブル式および派生テーブルを含むサブクエリ内で使用する場合。

  • ビュー、ユーザー定義関数、または計算列内で使用する場合。

  • ステートメントを使用して、DISTINCT, UNION, UNION ALL, EXCEPT or INTERSECT 演算子。

  • ORDER BY 句を使用するステートメン内で使用する場合。ただし、NEXT VALUE FOR ...OVER (ORDER BY ...) が使用されている場合を除く。

  • 次の句で: FETCH, OVER, OUTPUT, ON, PIVOT, UNPIVOT, GROUP BY, HAVING, COMPUTE, COMPUTE BY, or FOR XMLです。

  • 使用して条件付きの式で CASE, CHOOSE, COALESCE, IIF, ISNULL, or NULLIFです。

  • VALUES 句がない場合の一部では、 INSERT ステートメントです。

  • CHECK 制約の定義で使用する場合。

  • ルールまたは既存のオブジェクトの定義で使用する場合 (既定の制約では使用できます)。

  • 既定では、ユーザー定義テーブル型で使用します。

  • ステートメントを使用して、 TOP, 、OFFSET, 、または、 ROWCOUNT オプションを設定します。

  • WHERE 、ステートメントの句。

  • MERGE ステートメントです。 (する場合を除く、 NEXT VALUE FOR 関数は、対象のテーブルの既定の制約で使用してで既定値が使用される、 CREATE のステートメント、 MERGE ステートメントです)。

既定の制約でのシーケンス オブジェクトの使用

使用する場合、 NEXT VALUE FOR 関数既定の制約では、次の規則が適用されます。

  • 複数のテーブル内の既定の制約から 1 つのシーケンス オブジェクトを参照できます。

  • テーブルとシーケンス オブジェクトは同じデータベースに置く必要があります。

  • 既定の制約を追加するユーザーには、シーケンス オブジェクトに対する REFERENCES 権限が必要です。

  • 既定の制約を削除する前に、既定の制約から参照されているシーケンス オブジェクトを削除することはできません。

  • 複数の既定の制約で同じシーケンス オブジェクトを使用する場合、または値を提供するステートメントと実行中の既定の制約の両方で同じシーケンス オブジェクトを使用する場合、行内のすべての列に対して同じシーケンス番号が返されます。

  • 参照、 NEXT VALUE FOR 既定の制約で関数が指定することはできません、 OVER 句。

  • 既定の制約で参照されているシーケンス オブジェクトは変更できます。

  • INSERT ... SELECT ステートメントまたは INSERT ... EXEC ステートメントで、挿入されるデータを ORDER BY 句を使用してクエリから取得する場合、NEXT VALUE FOR 関数によって返される値は、ORDER BY 句で指定された順序で生成されます。

OVER ORDER BY 句でのシーケンス オブジェクトの使用

NEXT VALUE FOR 関数は、適用することで並べ替えられたシーケンス値の生成をサポートしています、 OVER 句を NEXT VALUE FOR 呼び出します。 OVER 句を使用することにより、返される値が OVER 句の ORDER BY サブ句の順序で生成されることが保証されます。 次の追加のルールの適用を使用する場合、 NEXT VALUE FOR で動作、 OVERで 句。

  • 複数回呼び出す、 NEXT VALUE FOR 関数の 1 つのステートメントで同じシーケンス ジェネレーター必要がありますすべてを使用してください、同じ OVER 句の定義。

  • 複数回呼び出す、 NEXT VALUE FOR 関数の 1 つのステートメントで異なるシーケンス ジェネレーターの参照を別に持つことができる OVER 句の定義。

  • OVER 句に適用される、 NEXT VALUE FOR 関数がサポートされていません、 PARTITION BY サブ句。

  • 呼び出しはすべての場合、 NEXT VALUE FOR で機能、 をSELECT ステートメントを指定、 OVERで 句、 ORDER BY 句で使用できる、 をSELECT ステートメントです。

  • SELECT ステートメントまたは INSERT ... SELECT ... ステートメントでは、NEXT VALUE FOR 関数と共に OVER 句を使用できます。 UPDATE ステートメントまたは MERGE ステートメントでは、NEXT VALUE FOR 関数で OVER 句は使用できません。

  • 別のプロセスが同時にシーケンス オブジェクトにアクセスしている場合は、非連続的な番号が返される可能性があります。

メタデータ

シーケンスに関する情報を取得するには、sys.sequences カタログ ビューに対してクエリを実行します。

セキュリティ

アクセス許可

必要があります 更新 シーケンス オブジェクトまたはシーケンスのスキーマに対するアクセスを許可します。 権限を付与する例については、後の例 F を参照してください。

所有権の継承

シーケンス オブジェクトでは、所有権の継承をサポートしています。 シーケンス オブジェクトの所有者が、(既定の制約としてシーケンス オブジェクトを所有する) 呼び出し元のストアド プロシージャ、トリガー、またはテーブルと同じ場合、シーケンス オブジェクトに対する権限チェックは必要ありません。 シーケンス オブジェクトの所有者が、呼び出し元のストアド プロシージャ、トリガー、またはテーブルと異なる場合、シーケンス オブジェクトに対する権限チェックが必要です。

ときに、 NEXT VALUE FOR テーブル内の既定値として関数を使用すると、ユーザーには、両方が必要とする INSERT 、テーブルに対する権限と UPDATE を既定値を使用してデータを挿入する、シーケンスのオブジェクトに対するアクセスを許可します。

  • 既定の制約の所有者がシーケンス オブジェクトと同じ場合、既定の制約を呼び出す際に、シーケンス オブジェクトに対する権限は必要ありません。

  • 既定の制約の所有者がシーケンス オブジェクトと異なる場合、既定の制約を使用してシーケンス オブジェクトを呼び出す際にも、シーケンス オブジェクトに対する権限が必要です。

Audit

NEXT VALUE FOR 関数を監査するには、SCHEMA_OBJECT_ACCESS_GROUP を監視します。

例

シーケンスの作成と、NEXT VALUE FOR 関数を使用したシーケンス番号の生成の両方の使用例については、「シーケンス番号」を参照してください。

次の例では、CountBy1 という名前のスキーマの Test という名前のシーケンスを使用します。 次のステートメントを実行して、Test.CountBy1 シーケンスを作成します。 例 C および E では、AdventureWorks2022 データベースを使用します。そのため、CountBy1 シーケンスはそのデータベースに作成されます。

USE AdventureWorks2022;  
GO  
  
CREATE SCHEMA Test;  
GO  
  
CREATE SEQUENCE Test.CountBy1  
    START WITH 1  
    INCREMENT BY 1 ;  
GO

A. SELECT ステートメントでシーケンスを使用する

次の例では、使用されるたびに 1 つずつ増加する CountBy1 という名前のシーケンスを作成します。

SELECT NEXT VALUE FOR Test.CountBy1 AS FirstUse;  
SELECT NEXT VALUE FOR Test.CountBy1 AS SecondUse;

結果セットは次のとおりです。

FirstUse  
1  
 
SecondUse  
2

B. 変数に次のシーケンス値を設定する

次の例では、変数にシーケンス番号の次の値を設定する 3 つの方法を示します。

DECLARE @myvar1 BIGINT = NEXT VALUE FOR Test.CountBy1  
DECLARE @myvar2 BIGINT ;  
DECLARE @myvar3 BIGINT ;  
SET @myvar2 = NEXT VALUE FOR Test.CountBy1 ;  
SELECT @myvar3 = NEXT VALUE FOR Test.CountBy1 ;  
SELECT @myvar1 AS myvar1, @myvar2 AS myvar2, @myvar3 AS myvar3 ;  
GO

C. 順位付け関数と共にシーケンスを使用する

USE AdventureWorks2022;  
GO  
  
SELECT NEXT VALUE FOR Test.CountBy1 OVER (ORDER BY LastName) AS ListNumber,  
    FirstName, LastName  
FROM Person.Contact ;  
GO

D. 既定の制約の定義で NEXT VALUE FOR 関数を使用する

使用して、 NEXT VALUE FOR 関数は、既定の制約の定義ではサポートされています。 CREATE TABLE ステートメントでの NEXT VALUE FOR の使用例については、「シーケンス番号」を参照してください。 次の例では、ALTER TABLE を使用して、シーケンスを既定値として現在のテーブルに追加します。

CREATE TABLE Test.MyTable  
(  
    IDColumn NVARCHAR(25) PRIMARY KEY,  
    name VARCHAR(25) NOT NULL  
) ;  
GO  
  
CREATE SEQUENCE Test.CounterSeq  
    AS INT  
    START WITH 1  
    INCREMENT BY 1 ;  
GO  
  
ALTER TABLE Test.MyTable  
    ADD   
        DEFAULT N'AdvWorks_' +   
        CAST(NEXT VALUE FOR Test.CounterSeq AS NVARCHAR(20))   
        FOR IDColumn;  
GO  
  
INSERT Test.MyTable (name)  
VALUES ('Larry') ;  
GO  
  
SELECT * FROM Test.MyTable;  
GO

E. INSERT ステートメントで NEXT VALUE FOR 関数を使用する

次の例では、TestTable という名前のテーブルを作成した後、NEXT VALUE FOR 関数を使用して、行を挿入します。

CREATE TABLE Test.TestTable  
     (CounterColumn INT PRIMARY KEY,  
    Name NVARCHAR(25) NOT NULL) ;   
GO  
  
INSERT Test.TestTable (CounterColumn,Name)  
    VALUES (NEXT VALUE FOR Test.CountBy1, 'Syed') ;  
GO  
  
SELECT * FROM Test.TestTable;   
GO

E. SELECT ... INTO と共に NEXT VALUE FOR 関数を使用するINTO

次の例では、SELECT ... INTO ステートメントを使用して Production.NewLocation という名前のテーブルを作成し、NEXT VALUE FOR 関数を使用して各行に番号を付けます。

USE AdventureWorks2022;   
GO  
  
SELECT NEXT VALUE FOR Test.CountBy1 AS LocNumber, Name   
    INTO Production.NewLocation  
    FROM Production.Location ;  
GO  
  
SELECT * FROM Production.NewLocation ;  
GO

F. NEXT VALUE FOR を実行する権限を付与する

次の例では、Test.CounterSeq シーケンスを使用して、NEXT VALUE FOR を実行できるように、 という名前のユーザーに UPDATEAdventureWorks\Larry権限を付与します。

GRANT UPDATE ON OBJECT::Test.CounterSeq TO [AdventureWorks\Larry] ;

参照

CREATE SEQUENCE (Transact-SQL)
ALTER SEQUENCE (Transact-SQL)
シーケンス番号