Menu

Tipos enum en PostgreSQL: CREATE TYPE AS ENUM

Un tipo enum es una lista fija y ordenada de valores permitidos, creada con CREATE TYPE ... AS ENUM. Cómo añadir y renombrar valores, listarlos, ordenarlos y cuándo conviene más una restricción CHECK.

Esta página incluye editores ejecutables: edita, ejecuta y ve el resultado al instante.

Un enum es un tipo de dato cuyos valores salen de una lista fija que declaras tú: CREATE TYPE name AS ENUM ('a', 'b', 'c'). Una columna de ese tipo solo acepta esas etiquetas y las ordena en el orden declarado, no alfabéticamente.

Las filas salen en el orden new, paid, shipped, delivered. Insertar una etiqueta que no está en la lista, como 'lost', falla con invalid input value for enum order_status: "lost".

Comparar y filtrar por posición

Como los valores están ordenados, <, > y BETWEEN comparan posiciones en la lista. "Pagado o cualquier estado posterior" se convierte en una sola condición:

Coinciden los pedidos 1, 3 y 4. min(status) y max(status) también siguen el orden declarado.

Listar los valores de un enum

enum_range(NULL::type) devuelve todas las etiquetas como un array, y unnest lo convierte en filas:

enum_first(NULL::mood) y enum_last(NULL::mood) devuelven la primera y la última etiqueta. En psql, \dT+ mood muestra el tipo con sus valores.

Añadir o renombrar un valor

ALTER TYPE ... ADD VALUE añade una etiqueta al final, o la coloca con BEFORE o AFTER. RENAME VALUE cambia una etiqueta, y todas las filas que la usan la siguen, porque las filas guardan una referencia a la etiqueta y no su texto.

La lista ahora es pending, paid, packed, shipped, delivered. IF NOT EXISTS hace que añadir una etiqueta que ya existe no haga nada.

PostgreSQL no puede quitar un valor ni reordenar los existentes. En su lugar, crea un tipo nuevo, convierte la columna a ese tipo y elimina el viejo:

CREATE TYPE order_status_new AS ENUM ('pending', 'paid', 'shipped');
UPDATE orders SET status = 'shipped' WHERE status = 'delivered';
ALTER TABLE orders
    ALTER COLUMN status DROP DEFAULT,
    ALTER COLUMN status TYPE order_status_new USING status::text::order_status_new;
DROP TYPE order_status;
ALTER TYPE order_status_new RENAME TO order_status;

El valor por defecto se quita primero porque tiene el tipo del enum viejo. Vuelve a ponerlo después.

Enum vs una restricción CHECK

Una columna text con una restricción CHECK da la misma protección, y su lista se puede cambiar con un ALTER TABLE normal:

Aquí el orden es alfabético: new y después paid.

Enumtext + CHECK
OrdenOrden declaradoAlfabético
Almacenamiento4 bytesLongitud del texto
Quitar un valorTipo nuevo y conversión de la columnaReemplazar la restricción
Reutilizar en varias tablasUn solo tipoRepetir la restricción

Elige un enum para una lista corta y estable cuyo orden signifique algo, como estados o tallas. Elige CHECK, o una tabla de referencia con una clave foránea, cuando la lista cambia a menudo o se eliminan valores. El capítulo de enums del manual cubre el resto de los detalles.

Preguntas frecuentes

¿Cómo elimino un valor de un enum en PostgreSQL?

No existe ALTER TYPE ... DROP VALUE. Crea un enum nuevo sin ese valor, convierte la columna con ALTER TABLE ... ALTER COLUMN ... TYPE new_type USING col::text::new_type después de actualizar las filas que lo usan, y luego elimina el tipo viejo.

¿Cuánto espacio ocupa un valor enum?

4 bytes por valor en disco, sea cual sea la longitud de su etiqueta. Las etiquetas distinguen mayúsculas y pueden tener hasta 63 bytes.

¿Puedo usar ALTER TYPE ADD VALUE dentro de una transacción?

Sí, desde PostgreSQL 12. El valor nuevo no se puede usar hasta que esa transacción haga commit.

¿Cómo comparo una columna enum con texto?

Un literal de cadena se convierte al enum automáticamente, así que WHERE status = 'paid' funciona. Una columna o un parámetro de tipo texto necesita una conversión, status = $1::order_status, o compara como texto con status::text = $1.

Ilustración de los lenguajes de programación de Coddy

Aprende a programar con Coddy

Comenzar