シーケンスの変更

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

概要

CreateSequenceStmt
ALTERSEQUENCETableNameCreateSequenceOptionListOpt
TableName
Identifier.Identifier
CreateSequenceOptionListOpt
SequenceOption
SequenceOptionList
SequenceOption
SequenceOption
INCREMENT=BYSTART=WITHMINVALUEMAXVALUECACHE=SignedNumCOMMENT=stringLitNOMINVALUENOMINVALUEMAXVALUECACHECYCLENOMAXVALUENOCACHECYCLENOCYCLERESTART=WITHSignedNum

構文

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]

パラメーター

パラメーターデフォルト値説明
INCREMENT1シーケンスの増分を指定します。正または負の値により、シーケンスの成長方向を制御できます。
MINVALUE1または-9223372036854775807シーケンスの最小値を指定します。 INCREMENT > 0の場合、デフォルト値は1です。 INCREMENT < 0の場合、デフォルト値は-9223372036854775807です。
MAXVALUE9223372036854775806または-1シーケンスの最大値を指定します。 INCREMENT > 0の場合、デフォルト値は9223372036854775806です。 INCREMENT < 0の場合、デフォルト値は-1です。
STARTMINVALUEまたはMAXVALUEシーケンスの初期値を指定します。 INCREMENT > 0の場合、デフォルト値はMINVALUEです。 INCREMENT < 0の場合、デフォルト値はMAXVALUEです。
CACHE1000TiDB 内のシーケンスのローカル キャッシュ サイズを指定します。
CYCLENO CYCLEシーケンスが最小値(降順シーケンスの場合は最大値)から再開するかどうかを指定します。 INCREMENT > 0の場合、デフォルト値はMINVALUEです。 INCREMENT < 0の場合、デフォルト値はMAXVALUEです。

注記:

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) の値です。

参照

このページは役に立ちましたか?