シーケンスの変更

ALTER SEQUENCE文は、TiDB 内のシーケンス オブジェクトを変更します。シーケンスは、 TableおよびViewオブジェクトと同等のデータベース オブジェクトです。シーケンスは、カスタマイズされた方法でシリアル化された ID を生成するために使用されます。

概要

CreateSequenceStmt ::=
    'ALTER' 'SEQUENCE' TableName CreateSequenceOptionListOpt

TableName ::=
    Identifier ('.' Identifier)?

CreateSequenceOptionListOpt ::=
    SequenceOption*

SequenceOptionList ::=
    SequenceOption

SequenceOption ::=
    ( 'INCREMENT' ( '='? | 'BY' ) | 'START' ( '='? | 'WITH' ) | ( 'MINVALUE' | 'MAXVALUE' | 'CACHE' ) '='? ) SignedNum
|   'COMMENT' '='? stringLit
|   'NOMINVALUE'
|   'NO' ( 'MINVALUE' | 'MAXVALUE' | 'CACHE' | 'CYCLE' )
|   'NOMAXVALUE'
|   'NOCACHE'
|   'CYCLE'
|   'NOCYCLE'
|   'RESTART' ( ( '='? | 'WITH' ) SignedNum )?

構文

ALTER SEQUENCE sequence_name
    [ INCREMENT [ BY | = ] increment ]
    [ MINVALUE [=] minvalue | NO MINVALUE | NOMINVALUE ]
    [ MAXVALUE [=] maxvalue | NO MAXVALUE | NOMAXVALUE ]
    [ START [ WITH | = ] start ]
    [ CACHE [=] cache | NOCACHE | NO CACHE]
    [ CYCLE | NOCYCLE | NO CYCLE]
    [table_options]

パラメーター

注記：

START値を変更しても、 ALTER SEQUENCE ... RESTARTを実行するまで生成された値には影響しません。

SEQUENCE機能

次の式関数を使用してシーケンスを制御できます。

• NEXTVALまたはNEXT VALUE FOR

  本質的には、どちらもシーケンス オブジェクトの次の有効な値を取得するNEXTVAL()の関数です。3 NEXTVAL()の関数のパラメーターは、シーケンスのidentifierです。

• LASTVAL

  この関数は、このセッションで最後に使用された値を取得します。値が存在しない場合は、 NULL使用されます。この関数のパラメーターは、シーケンスのidentifierです。

• SETVAL

  この関数は、シーケンスの現在の値の進行を設定します。この関数の最初のパラメーターはシーケンスのidentifierで、2 番目のパラメーターはnumです。

注記：

TiDB でのシーケンスの実装では、 SETVAL関数はこのシーケンスの初期進行またはサイクル進行を変更できません。この関数は、この進行に基づいて次の有効な値を返すだけです。

例

s1という名前のシーケンスを作成します。

CREATE SEQUENCE s1;

Query OK, 0 rows affected (0.15 sec)

次の SQL ステートメントを 2 回実行して、シーケンスから次の 2 つの値を取得します。

SELECT NEXTVAL(s1);

+-------------+
| NEXTVAL(s1) |
+-------------+
|           1 |
+-------------+
1 row in set (0.01 sec)

SELECT NEXTVAL(s1);

+-------------+
| NEXTVAL(s1) |
+-------------+
|           2 |
+-------------+
1 row in set (0.00 sec)

シーケンスの増分を2に変更します。

ALTER SEQUENCE s1 INCREMENT=2;

Query OK, 0 rows affected (0.18 sec)

ここで、シーケンスから次の 2 つの値を再度取得します。

SELECT NEXTVAL(s1);

+-------------+
| NEXTVAL(s1) |
+-------------+
|        1001 |
+-------------+
1 row in set (0.02 sec)

SELECT NEXTVAL(s1);

+-------------+
| NEXTVAL(s1) |
+-------------+
|        1003 |
+-------------+
1 row in set (0.00 sec)

出力からわかるように、 ALTER SEQUENCEステートメントの後に値が 2 増加します。

シーケンスの他のパラメータを変更することもできます。たとえば、シーケンスのMAXVALUE次のように変更できます。

CREATE SEQUENCE s2 MAXVALUE=10;

Query OK, 0 rows affected (0.17 sec)

ALTER SEQUENCE s2 MAXVALUE=100;

Query OK, 0 rows affected (0.15 sec)

SHOW CREATE SEQUENCE s2\G

*************************** 1. row ***************************
       Sequence: s2
Create Sequence: CREATE SEQUENCE `s2` start with 1 minvalue 1 maxvalue 100 increment by 1 cache 1000 nocycle ENGINE=InnoDB
1 row in set (0.00 sec)

MySQL 互換性

このステートメントは TiDB の拡張機能です。実装は MariaDB で利用可能なシーケンスに基づいてモデル化されています。

SETVAL関数を除き、他のすべての関数はMariaDB と同じ進行順序を持ちます。ここでの「進行順序」とは、シーケンス内の数字がシーケンスによって定義された特定の等差数列規則に従うことを意味します。シーケンスの現在の値を設定するにはSETVAL使用できますが、シーケンスのそれ以降の値は元の進行順序規則に従います。

例えば：

1, 3, 5, ...            // The sequence starts from 1 and increments by 2.
SELECT SETVAL(seq, 6)   // Sets the current value of a sequence to 6.
7, 9, 11, ...           // Subsequent values still follow the progression rule.

CYCLEモードでは、最初のラウンドのシーケンスの初期値はSTARTパラメータの値であり、後続のラウンドの初期値はMinValue ( INCREMENT > 0) またはMaxValue ( INCREMENT < 0) の値です。

参照

• シーケンスを作成
• ドロップシーケンス
• 表示シーケンスの作成
• シーケンス関数