CREATE SEQUENCE

CREATE SEQUENCE: definir un nuevo generador de secuencias.

Sintaxis admitida

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

Descripción

CREATE SEQUENCE crea un nuevo generador de números de secuencia. Esto implica crear e inicializar una nueva tabla especial de una sola fila con el nombre name. El generador será propiedad del usuario que emita el comando.

Si se proporciona un nombre de esquema, la secuencia se crea en el esquema especificado. En caso contrario, se crea en el esquema actual. El nombre de la secuencia debe ser distinto del nombre de cualquier otra relación (tabla, secuencia, índice, vista, vista materializada o tabla externa) en el mismo esquema.

Una vez creada una secuencia, se utilizan las funciones nextval currval y setval para operar en la secuencia. Estas funciones están documentadas en Funciones de manipulación de secuencias.

Aunque no puede actualizar una secuencia directamente, puede utilizar una consulta como:

SELECT * FROM name;

para examinar algunos de los parámetros y el estado actual de una secuencia. En particular, el campo last_value de la secuencia muestra el último valor asignado por cualquier sesión. (Por supuesto, este valor podría estar obsoleto en el momento de su impresión, si otras sesiones están realizando llamadas de nextval de forma activa). En la vista pg_sequences se pueden observar otros parámetros, como increment y maxvalue.

Parameters

Notas

Use DROP SEQUENCE para eliminar una secuencia.

Las secuencias se basan en la aritmética bigint, por lo que el rango no puede superar el rango de un entero de ocho bytes (-9223372036854775808 a 9223372036854775807).

Dado que las llamadas de nextval y setval nunca se revierten, los objetos de secuencia no se pueden utilizar si se necesita una asignación “sin brechas” de números de secuencia.

Cada sesión asignará y almacenará en caché valores de secuencia sucesivos durante un acceso al objeto de secuencia y aumentará el last_value del objeto de secuencia en consecuencia. A continuación, los siguientes usos de nextval en la caché-1 dentro de esa sesión simplemente devuelven los valores preasignados sin tocar el objeto de secuencia. De este modo, cualquier número asignado pero no utilizado dentro de una sesión se perderá cuando esta finalice, lo que provocará “huecos” en la secuencia.

Además, aunque se garantiza que las sesiones múltiples asignarán valores de secuencia distintos, los valores podrían generarse fuera de secuencia cuando se tienen en cuenta todas las sesiones. Por ejemplo, con una configuración de caché de 10, la sesión A podría reservar los valores 1..10 y devolver nextval=1; a continuación, la sesión B podría reservar los valores 11..20 y devolver nextval=11 antes de que la sesión A genere nextval=2. Por lo tanto, con una configuración de caché de uno, es seguro suponer que los valores nextval se generan de forma secuencial; con una configuración de caché superior a uno, solo se debe suponer que los valores nextval son todos distintos, no que se generan de forma puramente secuencial. Además, last_value reflejará el último valor reservado por cualquier sesión, independientemente de si nextval ya lo ha devuelto.

Otra consideración es que un setval ejecutado en dicha secuencia no será detectado por otras sesiones hasta que hayan agotado los valores preasignados que tienen almacenados en caché.

Ejemplos

Cree una secuencia ascendente llamada de serial, empezando por 101:

CREATE SEQUENCE serial CACHE 65536 START 101;

Seleccione el siguiente número de esta secuencia:

SELECT nextval('serial');

 nextval
---------
     101

Seleccione el siguiente número de esta secuencia:

SELECT nextval('serial');

 nextval
---------
     102

Utilice esta secuencia en un comando INSERT:

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

Restablezca la secuencia a un valor específico usando setval:

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

 nextval
---------
     201

Compatibilidad

CREATE SEQUENCE cumple con el estándar SQL con las siguientes excepciones: