NEXT VALUE FOR(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed Instance

지정한 시퀀스 개체에서 시퀀스 번호를 생성합니다.

시퀀스를 만들고 사용하는 방법에 대한 자세한 내용은 시퀀스 번호를 참조하세요. 시퀀스 번호의 범위를 생성하려면 sp_sequence_get_range를 사용합니다.

Transact-SQL 구문 표기 규칙

Syntax

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

참고 항목

SQL Server 2014(12.x) 및 이전 버전에 대한 Transact-SQL 구문을 보려면 이전 버전 설명서를 참조 하세요.

인수

database_name
시퀀스 개체가 있는 데이터베이스의 이름입니다.

schema_name
시퀀스 개체가 있는 스키마의 이름입니다.

sequence_name
번호를 생성하는 시퀀스 개체의 이름입니다.

over_order_by_clause
파티션에서 시퀀스 값이 행에 할당되는 순서를 결정합니다. 자세한 내용은 OVER 절(Transact-SQL)을 참조하세요.

반환 형식

시퀀스 형식을 사용하여 숫자를 반환합니다.

설명

NEXT VALUE FOR 함수는 저장 프로시저 및 트리거에 사용할 수 있습니다.

NEXT VALUE FOR 함수를 쿼리 또는 기본 제약 조건에 사용하면 같은 시퀀스 개체가 두 번 이상 사용되거나 값을 제공하는 문과 현재 실행 중인 기본 제약 조건 둘 다에서 사용되는 경우 결과 집합의 한 행 내에서 같은 시퀀스를 참조하는 모든 열에 대해 동일한 값이 반환됩니다.

NEXT VALUE FOR 함수는 비결정적이므로 생성되는 시퀀스 값 수가 제대로 정의된 컨텍스트에서만 허용됩니다. 다음은 지정된 문에서 참조되는 각 시퀀스 개체에 사용할 값 수를 정의합니다.

  • SELECT - 참조되는 각 시퀀스 개체에 대해 새 값이 문의 결과 행당 한 번 생성됩니다.

  • INSERT... VALUES - 참조되는 각 시퀀스 개체에 대해 새 값이 문의 삽입된 각 행당 한번 생성됩니다.

  • UPDATE - 참조되는 각 시퀀스 개체에 대해 새 값이 문에서 업데이트 중인 각 행당 한 번 생성됩니다.

  • 절차 문(예: DECLARE, SET 등) - 참조되는 각 시퀀스 개체에 대해 새 값이 각 문당 생성됩니다.

제한 사항

다음과 같은 경우에는 NEXT VALUE FOR 함수를 사용할 수 없습니다.

  • 데이터베이스가 읽기 전용 모드인 경우

  • 테이블 반환 함수의 인수로 사용할 경우

  • 집계 함수의 인수로 사용할 경우

  • 공통 테이블 식 및 파생 테이블을 포함하는 하위 쿼리에 사용할 경우

  • 뷰, 사용자 정의 함수 또는 계산 열에 사용할 경우

  • DISTINCT, UNION, UNION ALL, EXCEPT 또는 INTERSECT 연산자를 사용하는 문에서 사용할 경우

  • NEXT VALUE FOR...없이 ORDER BY 절을 사용하는 명령문에서 사용할 경우 OVER(ORDER BY...)를 사용할 경우

  • FETCH, OVER, OUTPUT, ON, PIVOT, UNPIVOT, GROUP BY, HAVING, COMPUTE, COMPUTE BY 또는 FOR XML 절에서 사용할 경우

  • CASE, CHOOSE, COALESCE, IIF, ISNULL 또는 NULLIF를 사용하는 조건식에서 사용할 경우

  • INSERT 문의 일부가 아닌 VALUES 절에 사용할 경우

  • CHECK 제약 조건을 정의하는 데 사용할 경우

  • 규칙 또는 기본 개체를 정의하는 데 사용할 경우(기본 제약 조건에는 사용할 수 있음)

  • 사용자 정의 테이블 형식에서 기본값으로 사용할 경우

  • TOP, OFFSET을 사용하는 문에서 사용할 경우 또는 ROWCOUNT 옵션이 설정된 경우

  • 문의 WHERE 절에 사용할 경우

  • MERGE 문에 사용할 경우 (NEXT VALUE FOR 함수가 대상 테이블의 기본 제약 조건에서 사용되는 경우를 제외하고, CREATE 문의 MERGE 문에는 기본값이 사용됩니다.)

기본 제약 조건에 시퀀스 개체 사용

기본 제약 조건에 NEXT VALUE FOR 함수를 사용하는 경우 다음 규칙이 적용됩니다.

  • 여러 테이블의 기본 제약 조건에서 단일 시퀀스 개체를 참조할 수 있습니다.

  • 테이블과 시퀀스 개체가 동일한 데이터베이스에 있어야 합니다.

  • 기본 제약 조건을 추가하는 사용자에게 시퀀스 개체에 대한 REFERENCES 권한이 있어야 합니다.

  • 기본 제약 조건에서 참조하는 시퀀스 개체를 삭제하려면 먼저 기본 제약 조건을 삭제해야 합니다.

  • 여러 기본 제약 조건에서 같은 시퀀스 개체를 사용하거나 값을 제공하는 문과 현재 실행 중인 기본 제약 조건 둘 다에서 같은 시퀀스 개체를 사용하는 경우 행의 모든 열에 대해 동일한 시퀀스 번호가 반환됩니다.

  • 기본 제약 조건의 NEXT VALUE FOR 함수에 대한 참조는 OVER 절을 지정할 수 없습니다.

  • 기본 제약 조건에서 참조하는 시퀀스 개체를 변경할 수 있습니다.

  • ORDER BY 절을 사용하여 쿼리에서 삽입할 데이터를 가져오는 INSERT ... SELECT 또는 INSERT ... EXEC 문의 경우 NEXT VALUE FOR 함수에서 반환되는 값이 ORDER BY 절에 지정된 순서대로 생성됩니다.

OVER ORDER BY 절에서 시퀀스 개체 사용

NEXT VALUE FOR 함수는 NEXT VALUE FOR 호출에 OVER 절을 적용하여 정렬된 시퀀스 값의 생성을 지원합니다. OVER 절을 사용하면 반환되는 값이 OVER 절의 ORDER BY 하위 절 순서대로 생성됩니다. NEXT VALUE FOR 함수를 OVER 절과 함께 사용하는 경우 다음 추가 규칙이 적용됩니다.

  • 단일 문의 동일한 시퀀스 생성기에 대해 NEXT VALUE FOR 함수를 여러 번 호출하는 경우 모두 같은 OVER 절 정의를 사용해야 합니다.

  • 단일 문의 서로 다른 시퀀스 생성기를 참조하는 NEXT VALUE FOR 함수를 여러 번 호출하는 경우 OVER 절 정의가 서로 다를 수 있습니다.

  • NEXT VALUE FOR 함수에 적용된 OVER 절은 PARTITION BY 하위 절을 지원하지 않습니다.

  • SELECT 문의 NEXT VALUE FOR 함수에 대한 모든 호출에서 OVER 절을 지정한 경우 SELECT 문에 ORDER BY 절을 사용할 수 있습니다.

  • SELECT 문 또는 INSERT ... SELECT ... 문에 사용하는 경우 NEXT VALUE FOR 함수에 OVER 절을 사용할 수 있습니다. NEXT VALUE FOR 함수로 OVER 절을 사용하는 것은 UPDATE 또는 MERGE 문에서 허용되지 않습니다.

  • 다른 프로세스에서 시퀀스 개체에 동시에 액세스할 경우 반환되는 번호에 간격이 생길 수 있습니다.

메타데이터

시퀀스에 대한 자세한 내용을 보려면 sys.sequences 카탈로그 뷰를 쿼리하세요.

보안

사용 권한

시퀀스 개체 또는 시퀀스의 스키마에 대한 UPDATE 권한이 필요합니다. 사용 권한을 부여하는 방법에 대한 예는 이 항목의 뒷부분에 나오는 예 7을 참조하십시오.

소유권 체인

시퀀스 개체는 소유권 체인을 지원합니다. 시퀀스 개체의 소유자가 호출하는 저장 프로시저, 트리거 또는 테이블(기본 제약 조건으로 시퀀스 개체 사용)의 소유자와 같은 경우에는 시퀀스 개체에 대한 권한 확인이 필요 없습니다. 호출하는 저장 프로시저, 트리거 또는 테이블의 소유자가 시퀀스 개체를 소유하지 않은 경우에는 시퀀스 개체에 대한 권한 확인이 필요합니다.

NEXT VALUE FOR 함수를 테이블의 기본값으로 사용하는 경우 사용자가 기본값을 사용하여 데이터를 삽입하려면 테이블에 대한 INSERT 권한과 시퀀스 개체에 대한 UPDATE 권한이 둘 다 있어야 합니다.

  • 기본 제약 조건의 소유자가 시퀀스 개체의 소유자와 같은 경우에는 기본 제약 조건을 호출할 때 시퀀스 개체에 대한 권한이 필요 없습니다.

  • 기본 제약 조건과 시퀀스 개체의 소유자가 다른 경우에는 기본 제약 조건을 통해 호출하는 경우에도 시퀀스 개체에 대한 권한이 필요합니다.

감사

NEXT VALUE FOR 함수를 감사하려면 SCHEMA_OBJECT_ACCESS_GROUP을 모니터링합니다.

예제

시퀀스를 만들고 NEXT VALUE FOR 함수를 사용하여 시퀀스 번호를 생성하는 방법에 대한 예는 시퀀스 번호를 참조하세요.

다음 예에서는 CountBy1라는 스키마의 Test이라는 시퀀스를 사용합니다. Test.CountBy1 시퀀스를 만들려면 다음 문을 실행합니다. 예 3과 4에서는 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. 변수를 다음 시퀀스 값으로 설정

다음 예에서는 변수를 시퀀스 번호의 다음 값으로 설정하는 세 가지 방법을 보여 줍니다.

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를 사용하는 예는 시퀀스 번호의 예 C를 참조하세요. 다음 예에서는 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 실행 권한 부여

다음 예에서는 AdventureWorks\Larry라는 사용자에게 Test.CounterSeq 시퀀스를 사용하여 NEXT VALUE FOR를 실행할 수 있는 UPDATE 권한을 부여합니다.

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

참고 항목

CREATE SEQUENCE(Transact-SQL)
ALTER SEQUENCE(Transact-SQL)
시퀀스 번호