DROP SEQUENCE

This page documents the preview version (v2.23). Preview includes features under active development and is for development and testing only. For production, use the stable version (v2024.1). To learn more, see Versioning.

Synopsis

Use the DROP SEQUENCE statement to delete a sequence in the current schema.

Syntax

drop_sequence ::= DROP SEQUENCE [ IF EXISTS ] sequence_name 
                  [ CASCADE | RESTRICT ]

drop_sequence

DROPSEQUENCEIFEXISTSsequence_nameCASCADERESTRICT

Semantics

sequence_name

Specify the name of the sequence.

  • An error is raised if a sequence with that name does not exist in the current schema unless IF EXISTS is specified.
  • An error is raised if any object depends on this sequence unless the CASCADE option is specified.

CASCADE

Remove also all objects that depend on this sequence (for example a DEFAULT value in a table's column).

RESTRICT

Do not remove this sequence if any object depends on it. This is the default behavior even if it's not specified.

Examples

Dropping a sequence that has an object depending on it, fails.

yugabyte=# CREATE TABLE t(k SERIAL, v INT);

CREATE TABLE

\d t

                           Table "public.t"
 Column |  Type   | Collation | Nullable |           Default
--------+---------+-----------+----------+------------------------------
 k      | integer |           | not null | nextval('t_k_seq'::regclass)
 v      | integer |           |          |

yugabyte=#  DROP SEQUENCE t_k_seq;

ERROR:  cannot drop sequence t_k_seq because other objects depend on it
DETAIL:  default for table t column k depends on sequence t_k_seq
HINT:  Use DROP ... CASCADE to drop the dependent objects too.

Dropping the sequence with the CASCADE option solves the problem and also deletes the default value in table t.

yugabyte=# DROP SEQUENCE t_k_seq CASCADE;

NOTICE:  drop cascades to default for table t column k
DROP SEQUENCE

\d t

                 Table "public.t"
 Column |  Type   | Collation | Nullable | Default
--------+---------+-----------+----------+---------
 k      | integer |           | not null |
 v      | integer |           |          |

See also