CREATE SEQUENCE

CREATE SEQUENCE – 新しいシーケンスジェネレーターを定義します。

サポートされている構文

CREATE SEQUENCE [ IF NOT EXISTS ] name CACHE cache
    [ AS data_type ]
    [ INCREMENT [ BY ] increment ]
    [ MINVALUE minvalue | NO MINVALUE ] [ MAXVALUE maxvalue | NO MAXVALUE ]
    [ [ NO ] CYCLE ]
    [ START [ WITH ] start ]
    [ OWNED BY { table_name.column_name | NONE } ]

where data_type is BIGINT
      and cache = 1 or cache >= 65536

説明

CREATE SEQUENCE は新しいシーケンス番号ジェネレーターを作成します。これには、name という名前の新しい特殊な単一行テーブルの作成と初期化が含まれます。ジェネレーターは、コマンドを発行するユーザーによって所有されます。

スキーマ名が指定されている場合は、指定されたスキーマ内にシーケンスが作成されます。指定しない場合、現在のスキーマに作成されます。シーケンスの名前は、同じスキーマ内の他のリレーション (テーブル、シーケンス、インデックス、ビュー、マテリアライズドビュー、または外部テーブル) の名前とは異なる必要があります。

シーケンスを作成したら、関数 nextval、currval、および setval を使用してシーケンスを操作します。これらの関数については、「シーケンス操作関数」で文書化されています。

シーケンスを直接更新することはできませんが、次のようなクエリを使用できます。

SELECT * FROM name;

シーケンスの一部のパラメータと現在の状態を調べます。特に、シーケンスの last_value フィールドには、任意のセッションによって割り当てられた最後の値が表示されます。(もちろん、他のセッションがアクティブに nextval 呼び出しを実行している場合、この値は出力される時点までに古くなっている可能性があります。) increment や maxvalue などの他のパラメータは、pg_sequences ビューで確認できます。

パラメータ

注意事項

DROP SEQUENCE を使用してシーケンスを削除します。

シーケンスは bigint 算術に基づいているため、範囲は 8 バイト整数の範囲 (-9223372036854775808～9223372036854775807) を超えることはできません。

nextval および setval 呼び出しはロールバックされないため、シーケンス番号の「ギャップレス」割り当てが必要な場合は、シーケンスオブジェクトを使用できません。

各セッションは、シーケンスオブジェクトへの 1 回のアクセス中に連続するシーケンス値を割り当てキャッシュし、それに応じてシーケンスオブジェクトの last_value を増やします。その後、そのセッション内での次の cache-1 の nextval の使用は、シーケンスオブジェクトにアクセスせずに、単純に事前に割り当てられた値を返します。したがって、セッション内で割り当てられたが使用されなかった番号は、そのセッションが終了すると失われ、シーケンスに「ホール」が発生します。

さらに、複数のセッションに個別のシーケンス値が割り当てられることが保証されていますが、すべてのセッションを考慮すると、値が順序どおりに生成されない可能性があります。例えば、cache 設定が 10 の場合、セッション A は値 1..10 を予約して nextval=1 を返し、セッション A が nextval=2 を生成する前に、セッション B が値 11..20 を予約して nextval=11 を返す場合があります。したがって、cache 設定が 1 の場合、nextval 値が順番に生成されると想定しても問題ありません。cache 設定が 1 より大きい場合は、nextval 値がすべて異なる値であることのみを想定する必要があり、純粋に順番に生成されると想定するべきではありません。また、last_value は、nextval によって返されたかどうかにかかわらず、任意のセッションによって予約された最新の値を反映します。

もう 1 つの考慮事項は、このようなシーケンスで実行された setval は、キャッシュされた事前割り当て値を使い切るまで、他のセッションによって認識されないことです。

例

101 から始まる serial という昇順のシーケンスを作成します。

CREATE SEQUENCE serial CACHE 65536 START 101;

このシーケンスから次の番号を選択します。

SELECT nextval('serial');

 nextval
---------
     101

このシーケンスから次の番号を選択します。

SELECT nextval('serial');

 nextval
---------
     102

INSERT コマンドでこのシーケンスを使用します。

INSERT INTO distributors VALUES (nextval('serial'), 'nothing');

setval を使用してシーケンスを特定の値にリセットします。

SELECT setval('serial', 200);
SELECT nextval('serial');

 nextval
---------
     201

互換性

CREATE SEQUENCE は SQL 標準に準拠していますが、以下の例外があります。