[toc]

1. Creating Sequences

Sequences are created similarly as other database objects with using of the commands:  CREATE SEQUENCE and are removed with the commands: DROP SEQUENCE. The same is true for their change, which is done with ALTER SEQUENCE.

The syntax of the CREATE SEQUENCE command  is as follows:

CREATE SEQUENCE [schema_name . ] sequence_name
    [ AS [ built_in_integer_type | user-defined_integer_type ] ]
    [ START WITH <constant> ]
    [ INCREMENT BY <constant> ]
    [ { MINVALUE [ <constant> ] } | { NO MINVALUE } ]
    [ { MAXVALUE [ <constant> ] } | { NO MAXVALUE } ]
    [ CYCLE | { NO CYCLE } ]
    [ { CACHE [ <constant> ] } | { NO CACHE } ]
    [ ; ]

[schema_name].[sequence_name]

• The same rules apply for the name of a sequence as for other database objects. Sequences always belong to only one database scheme and their name has to be unique within the scheme. Since it is dealing with independent database objects, we can apply security settings equal to the scheme compared to IDENTITY, where no explicit assignment of rights was possible.

AS [ built_in_integer_type | user-defined_integer_type ]

• Each sequence has its own system or user data type and it can only deal with some of these numerical data types:
  • tinyint – from 0 to 255
  • smallint – from -32,768 to 32,767
  • int – from -2,147,483,648 to 2,147,483,647
  • bigint – from -9,223,372,036,854,775,808 to 9,223,372,036,854,775,807
  • decimal and numeric, but only with zero count tenths decimal places
• User data types established on the above mentioned system types.
• The initial data type is bigint. It is good to keep this is mind when creating sequences because in most cases the range of this data type will not be necessary and it is more beneficial to select the lowest data type possible.

START WITH <constant>

• Determines this first value, which the sequence will return. It is an extremely important setting because when it is not used, the first returned value will be the minimum or maximum value of the used data type according to whether it is dealing with an ascending or descending sequence. The value must obviously be within the range of the selected data type.

INCREMENT BY <constant>

• The value determining the size of the increment or decrement upon every calling of the function NEXT VALUE FOR, which obtains another value from the sequence. The value cannot be 0 and the initial setting is 1. The value can also be negative, the same as for IDENTITY.

MINVALUE <constant> | NO MINVALUE

• Determines the minimum value, which will be generated by the given sequence. If it is not determined, the minimum value is always the lowest value of the used data type, possibly 0 for tinyint.

MAXVALUE <constant> | NO MAXVALUE

• Determines the top limit of the sequence. If it is not set, the top limit is the maximum value of the data type.

CYCLE | NO CYCLE

• This characteristic determines whether the sequence should again start generating from the beginning once it has reached the maximum value for an ascending sequence or a minimum value for a descending sequence. The initial setting is NO CYCLE and upon reaching the limit maximum value, an exception is generated. We cannot forget that if a renewal of the cycle takes place, the sequence re-starts from the minimum or maximum values, not from the START WITH values.

CACHE [<constant> ] | NO CACHE

• Serves to optimize speed of generating other sequence values by minimizing the number of disc operations. The initial setting is CACHE and the size is set to 50, even though this value is not officially documented and can later be changed without prior warning. Therefore, it is always better to specify the explicit value.
• The SQL Server does not retain the whole range of individual values in its memory. It only retains two numbers: the current value and the number of free values remaining in the cache. Later, we will see how exactly cache works.

2. Basic Sequence

Little is needed for creating a simple sequence: run the following command: CREATE SEQUENCE with at least the basic setting:

CREATE SEQUENCE dbo.MySequence
	AS INT
    START WITH 1
    INCREMENT BY 1 ;
GO

Our new sequence is the closest to that, which we know as IDENTITY(1,1). The start value is 1 and the increment is also 1. We only determined the data type, INT, because the initial data type, BIGINT, is unnecessarily too large for most scenarios. Therefore, our sequence corresponds with the following use of IDENTITY when defining the columns: ID INT NOT NULL IDENTITY(1,1).

We can view the sequences in Management Studio and if necessary, modify its settings:

After right clicking on Properties, details about the sequence, including the possibility to restart it, will appear:

The same as other objects, sequences also have their own management view (DMV), where we can find their list and configuration details:

SELECT * FROM sys.sequences

The only thing which we are not able to find out from sys.sequences, are the current values of the CACHE setting. It is possible to find these out using the following system tables but only when we connect to the instance as an administrator using a Dedicated Administrator Connection (DAC):

SELECT * FROM sys.sysschobjs WHERE id = OBJECT_ID('dbo.MySequence')
SELECT * FROM sys.sysobjvalues WHERE objid = OBJECT_ID('dbo.MySequence')

To find out how exactly to read the displayed information and to find out more about the internal cache management of sequences, click here.

3. Generating New Values

If we already have a sequence created, it is time to show you how to call it and how to obtain new values for further use.

There are two possibilities of generating new values:

1. If we want to obtain a single value (SELECT NEXT VALUE)
2. If we want to obtain values in a specific range (sys.sp_sequence_get_range)

SELECT NEXT VALUE FOR <sequence>

Using this clause, we will obtain a new value for every calling from the sequence:

SELECT NEXT VALUE FOR dbo.MySequence AS NewSeqValue
SELECT NEXT VALUE FOR dbo.MySequence AS NewSeqValue
SELECT NEXT VALUE FOR dbo.MySequence AS NewSeqValue
SELECT NEXT VALUE FOR dbo.MySequence AS NewSeqValue
SELECT NEXT VALUE FOR dbo.MySequence AS NewSeqValue
GO

We see that for every calling SELECT NEXT VALUE FOR we obtained another value from our sequence.

sys.sp_sequence_get_range

With the aid of the sys.sp_sequence_get_range system procedure, we can ask for more values at once, which can for example be very useful for applications, which process a large amount of data and simultaneously run the insertion of new rows into the database in more threads. Each thread can for example request a calling of a procedure by another 50 sequence values and the range which it obtains does not overlap with ranges, which were generated for other threads.

DECLARE
	@FirstSeqNum SQL_VARIANT, @LastSeqNum SQL_VARIANT, @CycleCount INT,
	@SeqIncr SQL_VARIANT, @SeqMinVal SQL_VARIANT, @SeqMaxVal sql_variant

EXEC sys.sp_sequence_get_range
	@sequence_name = N'dbo.MySequence',
	@range_size = 10,
	@range_first_value = @FirstSeqNum OUTPUT,
	@range_last_value = @LastSeqNum OUTPUT,
	@range_cycle_count = @CycleCount OUTPUT,
	@sequence_increment = @SeqIncr OUTPUT,
	@sequence_min_value = @SeqMinVal OUTPUT,
	@sequence_max_value = @SeqMaxVal OUTPUT

SELECT
	@FirstSeqNum AS FirstVal, @LastSeqNum AS LastVal, @CycleCount AS CycleCount,
	@SeqIncr AS SeqIncrement, @SeqMinVal AS MinSeq, @SeqMaxVal AS MaxSeq
GO 3

Using the GO 3 trick, we called the procedure a total of three times and from the results we can see that we don’t obtain a list of generated values, therefore, 3 * 10 rows but only 3 * one row, which tells us the first and last value of our range (FirstVal, LastVal) and the increment (SeqIncrement), which is sufficient for us to be able to finish calculating the individual values. CycleCount together with MinSeq and MaxSeq provides us with valuable information in case the obtained range appears on the edge, when the sequence automatically restarts from the beginning.

4. Cyclical Sequences

With the CYCLE parameter, we can determine that following the exhaustion of its range, the sequence automatically restarts from the minimum value, which is either the lowest value of the data type or a value determined using the MINVALUE configuration.

The following script illustrates a simple example of cyclical behavior:

CREATE SEQUENCE dbo.MySequence
 AS INT
 START WITH 1
 INCREMENT BY 1
 MINVALUE 1
 MAXVALUE 3
 CYCLE
GO

SELECT NEXT VALUE FOR dbo.[MySequence] SeqValue, name
FROM [sys].[sysobjects]
GO

We created a dbo.MySequence sequence and we set a MINVALUE = 1 and MAXVALUE = 3 and ran it with CYCLE. In the test inquiry, we see that the sequence is continuously repeating and therefore, we can for example use it as a similar function NTILE().

It is important to not forget to state the MINVALUE setting because otherwise the sequence will restart from the minimum value of the data type:

CREATE SEQUENCE dbo.[MySequence] 
	AS INT
	START WITH 1
	INCREMENT BY 1
	-- MINVALUE 1
	MAXVALUE 3
	CYCLE
GO

SELECT NEXT VALUE FOR dbo.[MySequence] SeqValue, name
FROM [sys].[sysobjects]
GO

5. Restart Sequence

Apart from the sequence’s automatic restart using CYCLE, we can restart the sequence from the beginning with the following command:

ALTER SEQUENCE dbo.MySequence RESTART WITH 1 
GO

If we assume WITH 1, the sequence will restart from the value determined upon its creation.

6. OVER()

The OVER() clause enables us to determine the order in which the sequence values will be generated in relation to the individual rows of the data set.

CREATE SEQUENCE dbo.MySequence 
    START WITH 1
    INCREMENT BY 1
GO

SELECT NEXT VALUE FOR dbo.MySequence OVER(ORDER BY Name), name
FROM [sys].[sysobjects]
GO

The clause can seem useless but only until we encounter one of the unpleasant limitations of sequences: we cannot use them in queries together with TOP, ORDER and OFFSET, as is illustrated in this example:

SELECT NEXT VALUE FOR dbo.MySequence SeqValue, name
FROM sys.sysobjects
ORDER BY name
GO

7. Transactions

The same as for IDENTITY, sequences are also generated out of the context of the transaction and ROLLBACK leads to loss of the generated values:

SELECT NEXT VALUE FOR dbo.MySequence SeqValue
GO

BEGIN TRAN

	SELECT NEXT VALUE FOR dbo.MySequence SeqValue

ROLLBACK
GO

SELECT NEXT VALUE FOR dbo.MySequence SeqValue
GO

8. Sequence as DEFAULT Value of a column

The NEXT VALUE FOR clause can be used when creating a table as a DEFAULT value of the column, which presents the answer to the question – whether it is possible to replace the traditional use of IDENTITY as a primary table key, with the aid of a sequence. We are simultaneously able to reach a behavior which is not feasible using IDENTITY:

CREATE TABLE dbo.TableA 
(	ID INT DEFAULT NEXT VALUE FOR dbo.MySequence PRIMARY KEY,
	Value NVARCHAR(20)
);

CREATE TABLE dbo.TableB
(	ID INT DEFAULT NEXT VALUE FOR dbo.MySequence PRIMARY KEY,
	Value NVARCHAR(20)
);

INSERT INTO dbo.TableA ( [Value] )
	VALUES ('A'), ('B')

INSERT INTO dbo.TableB ( [Value] )
	VALUES ('C'), ('D')

INSERT INTO dbo.TableA ( [Value] )
	VALUES ('E'), ('F')
GO

SELECT * FROM dbo.TableA
SELECT * FROM dbo.TableB
GO

SELECT * FROM dbo.TableA
UNION ALL
SELECT * FROM dbo.TableB
ORDER BY ID
GO

The highlighted rows in the script indicate that we used our dbo.MySequence sequence as an initial value for the ID column. We used the sequence simultaneously in two tables, which enables us to have two non-overlapping values when inserting data into both tables. Without sequences with similar behavior, it has to either be implemented with the aid of a complicated logic or by a third table, which has an IDENTITY column and is a source of new values.

9. INSERT

We can use the sequences directly in the INSERT command for inserting new values:

CREATE TABLE dbo.TableA 
(	ID INT PRIMARY KEY,
	Value NVARCHAR(20)
);

INSERT INTO dbo.TableA ( [ID], [Value] )
	VALUES	(NEXT VALUE FOR dbo.MySequence, 'A'),
			(NEXT VALUE FOR dbo.MySequence, 'B')

GO

INSERT INTO dbo.TableA ( [ID], [Value] )
	SELECT NEXT VALUE FOR dbo.MySequence, 'C'
GO

SELECT * FROM dbo.TableA
GO

10. Limitations

For using sequences, a number of limitations exist. Even though the majority of them can be avoided by another syntax record or the query logic, they are not always pleasant and it is necessary to keep them in mind.

Sequences cannot be used:

• in view, functions and calculated columns
• as a parameter table-valued function
• as an argument of aggregate functions (SUM(), …)
• in conditional expressions when using CASE, CHOOSE, COALESCE, IIF, ISNULL, or NULLIF
• in FETCH, OVER, OUTPUT, ON, PIVOT, UNPIVOT, GROUP BY, HAVING, COMPUTE, COMPUTE BY, or FOR XML clauses
• if the database is in the read-only mode
• in subqueries including common table expressions and derived tables
• in the MERGE command (except if it is inserted into tables using MERGE, where the sequence is used as a DEFAULT)
• as a check or as a rule
• as a default in the user table type
• in row-constructor (VALUES), if it is not directly a part of INSERT
• in the WHERE clause
• together with TOP, OFFSET, ORDER clauses

Examples:

UNION (ALL)

SELECT NEXT VALUE FOR dbo.MySequence, * FROM sys.[columns]
UNION ALL
SELECT NEXT VALUE FOR dbo.MySequence, * FROM sys.[columns]
GO

We can avoid an Error using this alternative syntax.

SELECT NEXT VALUE FOR dbo.MySequence SEQ, *
FROM (
	SELECT * FROM sys.[columns]
	UNION ALL
	SELECT * FROM sys.[columns]
	) a
GO

ISNULL()

DECLARE @i INT
SELECT ISNULL(@i,(NEXT VALUE FOR dbo.MySequence))
GO

Alternative syntax:

DECLARE @i INT
DECLARE @SEQ INT

SET @SEQ = NEXT VALUE FOR dbo.[MySequence]

SELECT ISNULL(@i, @SEQ)
GO

11. Bugs

The KB3011465 error is known and worth mentioning. This is where the generation of duplicate sequence values can occur in the SQL Server 2012 and 2014 versions. This can occur if instance is currently working under memory pressure.

12. Links

• MSDN
• SQL Server SEQUENCE Basics – Simple Talk
• SEQUENCE IN SQL SERVER 2012 (SqlHints.com)

1. Vytváření sekvencí

Sekvence se vytvářejí podobně jako jiné databázové objekty pomocí příkazu CREATE SEQUENCE a odstraňují se příkazem DROP SEQUENCE. Stejně je tomu i jejich změnou, která se provádí pomocí ALTER SEQUENCE.

Syntaxe příkazu CREATE SEQUENCE je následující:

CREATE SEQUENCE [schema_name . ] sequence_name
    [ AS [ built_in_integer_type | user-defined_integer_type ] ]
    [ START WITH <constant> ]
    [ INCREMENT BY <constant> ]
    [ { MINVALUE [ <constant> ] } | { NO MINVALUE } ]
    [ { MAXVALUE [ <constant> ] } | { NO MAXVALUE } ]
    [ CYCLE | { NO CYCLE } ]
    [ { CACHE [ <constant> ] } | { NO CACHE } ]
    [ ; ]

[schema_name].[sequence_name]

• Pro název sekvencí platí stejná pravidla jako pro jiné databázové objekty. Sekvence patři vždy pouze jednomu databázovému schématu a v rámci schématu musí být její název unikátní. Protože se jedná o samostatné databázové objekty, můžeme pro ně aplikovat nastavení bezpečnosti na rovni schématu na rozdíl o IDENTITY, kde žádné explicitní přiřazení práv možné nebylo.

AS [ built_in_integer_type | user-defined_integer_type ]

• Každá sekvence má svůj systémový nebo uživatelský datový typ a může se jednat pouze o některý z těchto číselných datových typů:
  • tinyint – od 0 do 255
  • smallint – od -32,768 do 32,767
  • int – od -2,147,483,648  do 2,147,483,647
  • bigint – od -9,223,372,036,854,775,808 do 9,223,372,036,854,775,807
  • decimal a numeric, ale pouze s nulovým počtem desetinných míst
  • uživatelské datové typy založené na výše uvedených systémových typech
• Výchozím datovým typem je bigint a je dobré na to při vytváření sekvencí pamatovat, protože pro většinu případů nebude rozsah tohoto datového typu potřeba a je vhodnější zvolit co nejmenší možný datový typ.

START WITH <constant>

• Určuje první hodnotu, kterou bude sekvence vracet. Je to nesmírně důležité nastavení, protože bez jejího použití bude první vrácenou hodnotou minimální nebo maximální hodnota použitého datového typu, a to podle toho, zda jde o sekvenci vzestupnou nebo sestupnou. Hodnota musí být samozřejmě v rozsahu zvoleného datového typu.

INCREMENT BY <constant>

• Hodnota určující velikost ikrementu nebo dekrementu při každém volání funkce NEXT VALUE FOR, která získává se sekvence další hodnotu. Hodnota nemůže být 0 a výchozí nastavení je 1. Hodnota může být pochopitelně i záporná, podobně jako u IDENTITY.

MINVALUE <constant> | NO MINVALUE

• Určuje minimální hodnotu, která bude vygenerována danou sekvencí. Pokud není určena, je minimální hodnotou vždy nejnižší hodnota použitého datového typu, případně 0 pro tinyint.

MAXVALUE <constant> | NO MAXVALUE

• Určuje horní hranici sekvence. Není-li nastavena, je horní hranicí maximální hodnota datového typu.

CYCLE | NO CYCLE

• Tato vlastnost určuje, zda se po dosažení maximální hodnoty pro vzestupné sekvence či minimální hodnoty pro sestupné sekvence má začít sekvence opět generovat od začátku. Výchozí nastavení je NO CYCLE a při dosažení hraniční maximální hodnoty je vygenerována výjimka. Nesmíme zapomenout na to, že pokud dojde k obnově cyklu, je sekvence restartována od minimální nebo maximální hodnoty, nikoliv od START WITH hodnoty.

CACHE [<constant> ] | NO CACHE

• Slouží k optimalizaci rychlosti generování dalších hodnot sekvence tím, že minimalizuje počet diskových operací. Výchozí nastavení je CACHE a velikost je nastavena na 50, i když tato hodnota není oficiálně zdokumentována a může být později změněna bez předchozího upozornění. Je tedy vždy lepší specifikovat explicitní hodnotu.
• SQL Serve si nedrží v paměti celý rozsah jednotlivých hodnot, ale pouze dvě čísla: aktuální hodnotu a počet zbývající volných hodnot v cache. Jak přesně cachování pracuje si ukážeme dále.

2. Základní sekvence

K vytvoření jednoduché sekvence nám stačí opravdu málo: spustit příkaz CREATE SEQUENCE s minimem základní nastavení:

CREATE SEQUENCE dbo.MySequence
	AS INT
    START WITH 1
    INCREMENT BY 1 ;
GO

Naše nová sekvence je nejblíže tomu, co známe jako IDENTITY(1,1). Startovní hodnota je 1 a inkrement také 1. Pouze jsme určili datový typ INT, protože výchozí datový type BIGINT je pro většinu scénářů zbytečně velký. Naše sekvence tedy odpovídá následujícímu použití IDENTITY při definici sloupce: ID INT NOT NULL IDENTITY(1,1).

Sekvenci si můžeme prohlédnout pomocí Management Studia a upravit případně její nastavení:

Po kliknutí pravým tlačítkem -> Properties se zobrazí podrobnosti o sekvenci včetně možnosti provést její restart:

Podobně jako jiné objekty mají i sekvence své vlastní management view (DMV), kde najdeme jejich seznam a podrobnosti konfigurace:

SELECT * FROM sys.sequences

Jedinou věc, kterou nedokážeme ze sys.sequences zjistit jsou aktuální hodnoty nastavení CACHE. Ty je možné zjistit z následujících systémových tabulek, ale pouze tehdy, pokud se k instanci připojíme jako administrátoři pomocí dedikovaného připojení (DAC):

SELECT * FROM sys.sysschobjs WHERE id = OBJECT_ID('dbo.MySequence')
SELECT * FROM sys.sysobjvalues WHERE objid = OBJECT_ID('dbo.MySequence')

Jak přesně zobrazené informace číst a více o interním cache managementu sekvencí najdete zde.

3. Generování nových hodnot

Pokud již máme vytvořenou sekvenci, je čas si ukázat, jak ji budeme volat a získávat nové hodnoty pro další použití.

Existují dvě možnosti, jak můžeme generovat nového hodnoty

a) chceme získávat jedinou hodnotu (SELECT NEXT VALUE)

b) chceme získat hodnoty v určitém rozsahu (sys.sp_sequence_get_range)

SELECT NEXT VALUE FOR <sequence>

Pomocí této klauzule získáme ze sekvence novou hodnotu a to pro každé volání:

SELECT NEXT VALUE FOR dbo.MySequence AS NewSeqValue
SELECT NEXT VALUE FOR dbo.MySequence AS NewSeqValue
SELECT NEXT VALUE FOR dbo.MySequence AS NewSeqValue
SELECT NEXT VALUE FOR dbo.MySequence AS NewSeqValue
SELECT NEXT VALUE FOR dbo.MySequence AS NewSeqValue
GO

Vidíme, že pro každé volání SELECT NEXT VALUE FOR jsme získali z naší sekvence další hodnotu.

sys.sp_sequence_get_range

Pomocí systémové procedury sys.sp_sequence_get_range můžeme požádat o více hodnot zároveň, což může být velmi užitečné např. pro aplikace, které zpracovávají ve více vláknech velké množství dat a provádí souběžně vkládání nových řádků do databáze. Každé vlákno si může požádat voláním procedury např. o dalších 50 hodnot sekvence a rozsah, který obdrží, se nekryje s rozsahy, které byly vygenerovány pro ostatní vlákna.

DECLARE
	@FirstSeqNum SQL_VARIANT, @LastSeqNum SQL_VARIANT, @CycleCount INT,
	@SeqIncr SQL_VARIANT, @SeqMinVal SQL_VARIANT, @SeqMaxVal sql_variant

EXEC sys.sp_sequence_get_range
	@sequence_name = N'dbo.MySequence',
	@range_size = 10,
	@range_first_value = @FirstSeqNum OUTPUT,
	@range_last_value = @LastSeqNum OUTPUT,
	@range_cycle_count = @CycleCount OUTPUT,
	@sequence_increment = @SeqIncr OUTPUT,
	@sequence_min_value = @SeqMinVal OUTPUT,
	@sequence_max_value = @SeqMaxVal OUTPUT

SELECT
	@FirstSeqNum AS FirstVal, @LastSeqNum AS LastVal, @CycleCount AS CycleCount,
	@SeqIncr AS SeqIncrement, @SeqMinVal AS MinSeq, @SeqMaxVal AS MaxSeq
GO 3

Pomocí GO 3 jsme zavolali proceduru celkem třikrát a z výsledků vidíme, že nedostáváme seznam vygenerovaných hodnot, tedy 3 * 10 řádků, ale pouze 3 * jeden řádek, který nám říká, jaké je první a poslední hodnota našeho rozsahu (FirstVal, LastVal) a jaký je inkrement (SeqIncrement), což nám stačí k tomu, abychom si dokázali jednotlivé hodnoty dopočítat. CycleCount spolu s MinSeq a MaxSeq nám poskytují cenné informace pro případ, že získaný rozsah se vyskytuje na hranici, kdy se sekvence automaticky restartuje od začátku.

4. Cyklické sekvence

Pomocí CYCLE můžeme určit, že sekvence se po vyčerpání svého rozsahu automaticky restartuje od minimální hodnoty, kterou je buď nejmenší hodnota datového typu nebo hodnota určená pomocí MINVALUE konfigurace.

Jednoduchý příklad cyklického chování si ukážeme v následujícím skriptu:

CREATE SEQUENCE dbo.MySequence
 AS INT
 START WITH 1
 INCREMENT BY 1
 MINVALUE 1
 MAXVALUE 3
 CYCLE
GO

SELECT NEXT VALUE FOR dbo.[MySequence] SeqValue, name
FROM [sys].[sysobjects]
GO

Vytvořili jsme sekvenci dbo.MySequence a nastavili jí MINVALUE = 1 a MAXVALUE = 3 a zapnuli CYCLE. V testovacím dotazu vidíme, že sekvence se stále opakuje a může ji tak použít např. jako obdobu funkce NTILE().

Důležité je nezapomenout uvést MINVALUE nastavení, protože jinak se sekvence restartuje od minimálního hodnoty datového typu:

CREATE SEQUENCE dbo.[MySequence] 
	AS INT
	START WITH 1
	INCREMENT BY 1
	-- MINVALUE 1
	MAXVALUE 3
	CYCLE
GO

SELECT NEXT VALUE FOR dbo.[MySequence] SeqValue, name
FROM [sys].[sysobjects]
GO

5. Restart sekvence

Kromě automatického restartování sekvence pomocí CYCLE můžeme sekvence restartovat od začátku pomocí následujícího příkazu:

ALTER SEQUENCE dbo.MySequence RESTART WITH 1 
GO

Pokud vynecháme WITH 1, restartuje se sekvence od hodnoty určené při jejím vytvoření.

6. OVER()

Klauze OVER() nám umožňuje určit v rámci dotazu pořadí, v jakém budou hodnoty sekvence generovány vůči jednotlivým řádkům datového setu.

CREATE SEQUENCE dbo.MySequence 
    START WITH 1
    INCREMENT BY 1
GO

SELECT NEXT VALUE FOR dbo.MySequence OVER(ORDER BY Name), name
FROM [sys].[sysobjects]
GO

Klauzule se může zdát zbytečná, ale jen to té chvíle, než narazíme na jedno z nepříjemných omezení sekvencí: Nelze je použít v dotazu společně s TOP, ORDER a OFFSET, jak ukazuje tento příklad:

SELECT NEXT VALUE FOR dbo.[MySequence] SeqValue, name
FROM [sys].[sysobjects]
ORDER BY name
GO

7. Transakce

Stejně jako IDENTITY i sekvence jsou generovány mimo kontext transakce a ROLLBACK vede ke ztrátě vygenerované hodnoty:

SELECT NEXT VALUE FOR dbo.MySequence SeqValue
GO

BEGIN TRAN

	SELECT NEXT VALUE FOR dbo.MySequence SeqValue

ROLLBACK
GO

SELECT NEXT VALUE FOR dbo.MySequence SeqValue
GO

8. Sekvence jako DEFAULT hodnota sloupce

Klauzuli NEXT VALUE FOR můžeme použít při vytváření tabulky jako DEFAULT hodnotu sloupce, což představuje odpověď na otázku, zda lze pomocí sekvencí nahradit klasické použití IDENTITY jako primárního klíče tabulky. Zároveň jsme schopni dosáhnout chování, které je pomocí IDENTITY nerealizovatelné:

CREATE TABLE dbo.TableA 
(	ID INT DEFAULT NEXT VALUE FOR dbo.MySequence PRIMARY KEY,
	Value NVARCHAR(20)
);

CREATE TABLE dbo.TableB
(	ID INT DEFAULT NEXT VALUE FOR dbo.MySequence PRIMARY KEY,
	Value NVARCHAR(20)
);

INSERT INTO [dbo].[TableA] ( [Value] )
	VALUES ('A'), ('B')

INSERT INTO [dbo].[TableB] ( [Value] )
	VALUES ('C'), ('D')

INSERT INTO [dbo].[TableA] ( [Value] )
	VALUES ('E'), ('F')
GO

SELECT * FROM dbo.[TableA]
SELECT * FROM dbo.[TableB]
GO

SELECT * FROM dbo.[TableA]
UNION ALL
SELECT * FROM dbo.[TableB]
ORDER BY ID
GO

Zvýrazněné řádky ve skriptu ukazují, že jsme naši sekvenci dbo.MySequence použili jako výchozí hodnotu pro sloupec ID. Sekvenci jsme použili zároveň ve dvou tabulkách, což nám umožňuje při vkládání dat do obou tabulek mít ID hodnoty, které se nebudou překrývat. Bez sekvencí se podobné chování musí implementovat buď pomocí složité logiky nebo nebo třetí tabulky, která má sloupec IDENTITY a je zdrojem nových hodnot.

9. INSERT

Sekvence můžeme použít přímo v INSERT příkazu pro vkládání nových hodnot:

CREATE TABLE dbo.TableA 
(	ID INT PRIMARY KEY,
	Value NVARCHAR(20)
);

INSERT INTO dbo.TableA ( [ID], [Value] )
	VALUES	(NEXT VALUE FOR dbo.MySequence, 'A'),
			(NEXT VALUE FOR dbo.MySequence, 'B')

GO

INSERT INTO dbo.TableA ( [ID], [Value] )
	SELECT NEXT VALUE FOR dbo.MySequence, 'C'
GO

SELECT * FROM dbo.TableA
GO

10. Omezení

Pro použití sekvencí existuje řada omezení, a i když lze většinu z nich obejít jiným syntaktickým zápisem nebo logikou dotazu, nejsou vždy příjemná a je třeba na ně myslet.

Sekvence nelze použít:

• v pohledech, funkcích a vypočítaných sloupcích
• jako parametr table-valued funkce
• jako argument agregačních funkcí (SUM(), …)
• ve podmínkových výrazech s použitím CASE, CHOOSE, COALESCE, IIF, ISNULL, or NULLIF
• v klauzulích FETCH, OVER, OUTPUT, ON, PIVOT, UNPIVOT, GROUP BY, HAVING, COMPUTE, COMPUTE BY, or FOR XML
• pokud je databáze v read-only režimu
• ve vnořených dotazech včetně common table expressions a odvozených tabulek
• v MERGE příkazu (kromě toho, je-li pomocí MERGE vkládáno do tabulky, kde je sekvence použita jako DEFAULT)
• jako check omezení nebo rule
• jako default v uživatelském tabulkovém typu
• v row-konstruktoru (VALUES), pokud není přímo součástí INSERTu
• ve WHERE klauzuli
• společně s TOP, OFFSET, ORDER klauzulemi

Příklady:

UNION (ALL)

SELECT NEXT VALUE FOR dbo.MySequence, * FROM sys.[columns]
UNION ALL
SELECT NEXT VALUE FOR dbo.MySequence, * FROM sys.[columns]
GO

Error obejdeme pomocí tohoto alternativního zápisu:

SELECT NEXT VALUE FOR dbo.MySequence SEQ, *
FROM (
	SELECT * FROM sys.[columns]
	UNION ALL
	SELECT * FROM sys.[columns]
	) a
GO

ISNULL()

DECLARE @i INT
SELECT ISNULL(@i,(NEXT VALUE FOR dbo.MySequence))
GO

Alternativní zápis:

DECLARE @i INT
DECLARE @SEQ INT

SET @SEQ = NEXT VALUE FOR dbo.[MySequence]

SELECT ISNULL(@i, @SEQ)
GO

11. Chyby a KB

Ze známých chyb stojí za zmínku KB3011465, kdy ve verzích SQL Server 2012 a 2014 může dojít k vygenerování duplicitních hodnot sekvencí, pokud je instance aktuálně pracuje pod nedostatkem paměti

12. Odkazy

• MSDN
• SQL Server SEQUENCE Basics – Simple Talk
• SEQUENCE IN SQL SERVER 2012 (SqlHints.com)