Descripción

CREATE SEQUENCE crea un nuevo generador de números de secuencia. Esto implica la creación e inicialización de una nueva tabla especial de una sola fila con el nombre especificado. El generador será propiedad del usuario que ejecute el comando.

Si se proporciona un nombre de esquema, la secuencia se crea en el esquema especificado. De lo contrario, se crea en el esquema actual. Las secuencias temporales existen en un esquema especial, por lo que no se puede proporcionar un nombre de esquema al crear una secuencia temporal. El nombre de la secuencia debe ser distinto del nombre de cualquier otra relación (tabla, secuencia, índice, vista, vista materializada o tabla foránea) en el mismo esquema.

Después de crear una secuencia, utilizas las funciones nextval, currval y setval para operar sobre ella. Estas funciones están documentadas en la Section 9.17.

Aunque no puedes actualizar una secuencia directamente, puedes usar una consulta como:

SELECT * FROM nombre;

para examinar los parámetros y el estado actual de la secuencia. En particular, el campo last_value de la secuencia muestra el último valor asignado por cualquier sesión. (Por supuesto, este valor puede estar obsoleto para el momento en que se imprima, si otras sesiones están realizando activamente llamadas a nextval).

Parámetros

Notas

Utiliza DROP SEQUENCE para eliminar una secuencia.

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

Debido a que las llamadas a nextval y setval nunca se revierten (rollback), los objetos de secuencia no se pueden usar si se necesita una asignación de números de secuencia “sin huecos” (gapless). Es posible construir una asignación sin huecos utilizando un bloqueo exclusivo de una tabla que contenga un contador; pero esta solución es mucho más costosa que los objetos de secuencia, especialmente si muchas transacciones necesitan números de secuencia concurrentemente.

Se pueden obtener resultados inesperados si se utiliza una configuración de caché mayor que uno para un objeto de secuencia que será usado concurrentemente por múltiples sesiones. Cada sesión asignará y almacenará en caché valores de secuencia sucesivos durante un acceso al objeto de secuencia e incrementará el last_value del objeto de secuencia en consecuencia. Luego, los siguientes caché-1 usos de nextval dentro de esa sesión simplemente devolverán los valores preasignados sin tocar el objeto de secuencia. Por lo tanto, cualquier número asignado pero no utilizado dentro de una sesión se perderá cuando esa sesión termine, lo que dará lugar a “huecos” en la secuencia.

Además, aunque se garantiza que múltiples sesiones asignarán valores de secuencia distintos, los valores pueden generarse desordenados cuando se consideran 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, luego la sesión B podría reservar los valores 11..20 y devolver nextval=11 antes de que la sesión A haya generado nextval=2. Por lo tanto, con una configuración de caché de uno es seguro asumir que los valores de nextval se generan secuencialmente; con una configuración de caché mayor que uno solo debes asumir que los valores de nextval son todos distintos, no que se generan puramente de forma secuencial. Además, last_value reflejará el último valor reservado por cualquier sesión, se haya devuelto o no todavía por nextval.

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

Ejemplos

Crea una secuencia ascendente llamada serial, comenzando en 101:

CREATE SEQUENCE serial START 101;

Selecciona el siguiente número de esta secuencia:

SELECT nextval('serial');

 nextval
---------
     101

Selecciona el siguiente número de esta secuencia:

SELECT nextval('serial');

 nextval
---------
     102

Usa esta secuencia en un comando INSERT:

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

Actualiza el valor de la secuencia después de un COPY FROM:

BEGIN;
COPY distributors FROM 'input_file';
SELECT setval('serial', max(id)) FROM distributors;
END;

Compatibilidad

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

Consulte también