ALTER SEQUENCE [ IF EXISTS ] name [ INCREMENT [ BY ] increment ] [ MINVALUE minvalue | NO MINVALUE ] [ MAXVALUE maxvalue | NO MAXVALUE ] [ START [ WITH ] start ] [ RESTART [ [ WITH ] restart ] ] [ CACHE cache ] [ [ NO ] CYCLE ] [ OWNED BY { table_name.column_name | NONE } ] ALTER SEQUENCE [ IF EXISTS ] name OWNER TO new_owner ALTER SEQUENCE [ IF EXISTS ] name RENAME TO new_name ALTER SEQUENCE [ IF EXISTS ] name SET SCHEMA new_schema
ALTER SEQUENCEは、既存のシーケンスジェネレータのパラメータを変更します。 ALTER SEQUENCEで指定されなかったパラメータについては、以前の設定が保持されます。
ALTER SEQUENCEを使用するには、シーケンスの所有者でなければなりません。 シーケンスのスキーマを変更するには、新しいスキーマにおけるCREATE権限も持たなければなりません。 所有者を変更するには、新しく所有者となるロールの直接または間接的なメンバでなければなりません。 またそのロールはシーケンスのスキーマ上にCREATE権限を持たなければなりません。 (これらの制限は、シーケンスの削除または再作成によりユーザが実行できないことを、所有者の変更により実行されないことを確実にするためのものです。 しかし、スーパーユーザはすべてのシーケンスの所有者を変更することができます。)
変更するシーケンスの名前です(スキーマ修飾名も可)。
シーケンスが存在しない場合にエラーとしません。 この場合、注意メッセージが発生します。
INCREMENT BY increment句は省略可能です。 正の値が指定された時は昇順のシーケンス、負の値が指定された時は降順のシーケンスを作成します。 指定がない場合、以前の増分値が保持されます。
MINVALUE minvalueはシーケンスジェネレータが生成する最小値を決定します。 NO MINVALUEが指定された場合、昇順の時は1、降順の時は-(263-1)がデフォルトになります。 どちらのオプションも指定されていなければ、現在の最小値が保持されます。
MAXVALUE maxvalueはシーケンスが生成する最大値を決定します。 NO MAXVALUEが指定された場合、昇順の時は263-1、降順の時は-1がデフォルトになります。 どちらのオプションも指定されていなければ、現在の最大値が保持されます。
省略可能なSTART WITH start句は、記録されているシーケンスの開始値を変更します。 これは現在のシーケンス値に影響しません。 単に将来実行されるALTER SEQUENCE RESTARTコマンドが使用する値を設定するだけです。
省略可能なRESTART WITH restart句は、シーケンスの現在値を変更します。
これはis_called = false付きでsetval
関数を呼び出すことと同じです。
指定した値は次のnextval
呼出時に返されます。
restartを付けずにRESTARTと記述することは、CREATE SEQUENCEで記録、または前回ALTER SEQUENCE START WITHで設定された開始値を指定したことと同じです。
CACHE cache句を使用すると、アクセスを高速化するために、シーケンス番号を事前に割り当て、メモリに保存しておくことができます。 最小値は1です(一度に生成する値が1つだけなので、キャッシュがない状態になります)。 指定がなければ、以前のキャッシュ値が保持されます。
CYCLEキーワードを使用すると、シーケンスが限界値(昇順の場合はmaxvalue、降順の場合はminvalue)に達した時、そのシーケンスを周回させることができます。このキーワードは省略可能です。 限界値に達した時、次に生成される番号は、昇順の場合はminvalue、降順の場合はmaxvalueになります。
NO CYCLEキーワードが指定されると、シーケンスの限界値に達した後のnextval
呼び出しは全てエラーとなります。このキーワードは省略可能です。
CYCLEもNO CYCLEも指定されていない場合は、以前の周回動作が保持されます。
OWNED BYオプションにより、シーケンスは指定されたテーブル列に関連付けされ、その列(やテーブル全体)が削除されると、自動的にシーケンスも同様に削除されるようになります。 指定があると、以前に指定されたシーケンスの関連は、指定された関連に置き換えられます。 指定するテーブルは、シーケンスと同一所有者でなければならず、また、同一のスキーマ内に存在しなければなりません。 OWNED BY NONEを指定することで、既存の関連は削除され、シーケンスは"独立"したものになります。
シーケンスの新しい所有者のユーザ名です。
シーケンスの新しい名称です。
シーケンスの新しいスキーマです。
同じシーケンスから番号を取得するトランザクションの同時実行ブロックを防ぐために、シーケンス生成パラメータに関するALTER SEQUENCEの操作はロールバックできません。 ALTER SEQUENCEによる変更は即座に反映され、元に戻すことはできません。 しかし、OWNED BY、OWNER TO、RENAME TOおよびSET SCHEMA句は通常のカタログ更新となり、ロールバックすることができます。
ALTER SEQUENCEは、コマンドを実行したバックエンド以外のバックエンドにおけるnextval
に対しては、すぐには効力を発揮しません。これらのバックエンドは事前に割り当てられた(キャッシュされた)値を持っており、この値を全て使い果たした後に、変更されたシーケンス生成パラメータを検知します。
コマンドを実行したバックエンドには、即座に変更が反映されます。
ALTER SEQUENCEはシーケンスのcurrval
状態には影響しません。
(8.3より前のPostgreSQLでは影響を与える場合がありました。)
歴史的な理由によりALTER TABLEはシーケンスにも使用することができます。 しかし、シーケンスに対して許されるALTER TABLEの構文は、上で示した構文と等価なものだけです。