シーケンスの作成

OceanBaseデータベースにおいて、シーケンス（Sequence）とは、一定のルールに基づいてデータベースが生成する自動インクリメントの数字シーケンス番号であり、通常は間隔を置いた一連の値（数値型）です。シーケンスは自動インクリメントの特性を持つため、通常は主キーや一意キーとして使用されます。

CREATE SEQUENCE ステートメントを使用してシーケンスを作成できます。シーケンスには、現在のシーケンス値と次のシーケンス値を返すための2つの擬似列 CURRVAL と NEXTVAL が提供されます。NEXTVAL を照会するたびに、CURRVAL の値が進みます。

SQL構文は以下のとおりです：

CREATE SEQUENCE [IF NOT EXISTS] [database_name.]sequence_name
[MINVALUE int_value | NOMINVALUE]
[MAXVALUE int_value | NOMAXVALUE]
[START WITH int_value]
[INCREMENT BY int_value]
[CACHE int_value | NOCACHE]
[ORDER | NOORDER]
[CYCLE | NOCYCLE];

ステートメントの使用方法：

• このステートメントを実行するユーザーには CREATE 権限が付与されている必要があります。

• IF NOT EXISTS：オプション。作成対象のシーケンスが既に存在し、IF NOT EXISTS が指定されていない場合、システムはエラーを報告します。

• database_name.：オプション。シーケンスが属するデータベースを指定するために使用されます。database_name. を指定しない場合、デフォルトでは現在ログインしているデータベースのシーケンスが作成されます。

• MINVALUE int_value | NOMINVALUE：シーケンスの最小値を指定するために使用されます。値の範囲は [-10²⁷ ~ (10²⁷-1)] です。

  NOMINVALUE と指定した場合、昇順時の最小値は1、降順時の最小値は -(10²⁷-1) となります。

  MINVALUE を指定しない場合、デフォルトは NOMINVALUE となります。

• MAXVALUE int_value | NOMAXVALUE：シーケンスの最大値を指定するために使用されます。値の範囲は [(-10²⁷+1) ~ (10²⁸-1)] です。

  NOMAXVALUE と指定した場合、昇順時の最大値は (10²⁸-1)、降順時の最大値は -1 となります。

  MAXVALUE を指定しない場合、デフォルトは NOMAXVALUE となります。

• START WITH：シーケンスの開始値を指定するために使用されます。この値は MAXVALUE 以下かつ MINVALUE 以上である必要があります。指定しない場合、昇順時のデフォルト値は最小値、降順時のデフォルト値は最大値となります。

• INCREMENT BY：シーケンスの自動インクリメントのステップ数を指定するために使用されます。この値は 0 にすることはできません。正の数を指定した場合、シーケンスは昇順になります。負の数を指定した場合、シーケンスは降順になります。指定しない場合、デフォルト値は 1 となります。

• CACHE：メモリ内で事前に割り当てる自動インクリメント値の数を指定するために使用されます。デフォルトは 20 です。

• ORDER | NOORDER：シーケンスの値が順序どおりに生成されるかどうかを指定するために使用されます。ORDER は順序どおりに生成されることを意味し、NOORDER は順序どおりに生成されないことを意味します。デフォルトは NOORDER です。

• CYCLE | NOCYCLE：シーケンスの値が繰り返し生成されるかどうかを指定するために使用されます。CYCLE は繰り返し生成されることを意味し、NOCYCLE は繰り返し生成されないことを意味します。デフォルトは NOCYCLE です。

シーケンス seq1 を作成し、自動インクリメントのステップ数を 2 と指定する例は以下のとおりです：

obclient> CREATE SEQUENCE seq1 START WITH 1 MINVALUE 1 MAXVALUE 10 INCREMENT BY 2 NOCYCLE NOORDER CACHE 30;

CREATE SEQUENCE ステートメントの詳細については、CREATE SEQUENCEを参照してください。

関連ドキュメント

シーケンスに関するその他の操作については、以下のドキュメントを参照してください：

• シーケンスの確認

• シーケンスのインポート

• シーケンスの変更

• シーケンスの削除