本節ではシーケンスオブジェクトに対し演算を行う関数について説明します。 シーケンスオブジェクトは、シーケンスジェネレータ、あるいは単にシーケンスとも呼ばれます。 シーケンスオブジェクトは特殊な一行だけのテーブルで、CREATE SEQUENCEで作成されます。 シーケンスオブジェクトは一般的にテーブルの行に一意の識別子を生成するために使用されます。 表 9.50に列挙されているシーケンス関数は、シーケンスオブジェクトから連続したシーケンス値を取得するための、簡易でマルチユーザに対応した関数です。
表9.50 シーケンス関数
関数 説明 |
---|
シーケンスを次の値に進めてその値を返します。
これは自動的に行われます。複数のセッションが
この関数はシーケンスオブジェクトの |
シーケンスオブジェクトの現在の値をセットします。オプションで SELECT setval('myseq', 42); 次の
この関数はシーケンスの |
現在のセッションでこのシーケンスに対して直近の
この関数はシーケンスの |
現在のセッションでこのシーケンスに対して直近の
この関数はシーケンスの |
同一のシーケンスから数値を取得する同時実行トランザクション同士のブロックを防止するため、nextval
で得られる値は、呼び出しているトランザクションが後でアボートした際に再利用目的での回収は行われません。
これは、トランザクションのアボートあるいはデータベースのクラッシュによって、割り当てられるシーケンスの値に欠番ができることがある、ということを意味します。
これはトランザクションのアボートがなくても起こります。
例えばON CONFLICT
句のあるINSERT
では、挿入される予定のタプルについて、必要となるすべてのnextval
の呼び出しも含めて計算し、その後でON CONFLICT
のルールを代わりに使用することになる競合について検知します。
従って、PostgreSQLのシーケンスオブジェクトは「欠番のない」シーケンスを得るために使うことはできません。
同様に、setval
が行ったシーケンス状態の変更は直ちに他のトランザクションから可視になり、トランザクションがロールバックしても元には戻りません。
nextval
やsetval
の呼び出しを含むトランザクションがコミットする前にデータベースクラスタがクラッシュすると、そのシーケンスの状態は永続的な記憶装置に格納されないかもしれず、クラスタが再起動した後にそのシーケンスが元の状態のままなのか、更新された状態になっているのかは定かではありません。
コミットされていないトランザクションは可視ではないので、これはデータベース内のシーケンスの利用に関して言えば無害です。
しかし、シーケンス値をデータベースの外での永続的な利用を目的として使う場合は、nextval
の呼び出しが確実にコミットされてから利用してください。
シーケンス関数により操作されるシーケンスはregclass
引数で指定されますが、それはpg_class
システムカタログ内にある、そのシーケンスの単なるOIDです。
しかしながら、手作業でOIDを検索する必要はなく、regclass
データ型の入力変換器が代わってその作業を行ってくれます。
詳細は8.19を見てください。