Menu

ALTER TABLE en PostgreSQL: agregar, renombrar y cambiar tipo

ALTER TABLE cambia una tabla que ya existe: agregar, renombrar y eliminar columnas, cambiar el tipo de una columna con USING, poner valores por defecto y NOT NULL, y añadir restricciones.

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

ALTER TABLE cambia una tabla que ya existe. Las formas que más vas a usar son ADD COLUMN, RENAME COLUMN ... TO, DROP COLUMN y ALTER COLUMN ... TYPE. Puedes poner varias acciones en una sola sentencia, separadas por comas.

Las filas existentes reciben 'free' en plan y NULL en signed_up. Desde PostgreSQL 11, agregar una columna con un valor por defecto constante no reescribe la tabla, así que es rápido incluso en tablas grandes. Un valor por defecto volátil como clock_timestamp() sigue reescribiendo todas las filas.

Renombrar una columna o una tabla

Renombrar es instantáneo y conserva los datos, los índices y las restricciones. Las vistas siguen funcionando, porque apuntan al id interno de la tabla y no a su nombre. Los nombres escritos como texto en otros sitios no se actualizan: los cuerpos de funciones PL/pgSQL y las consultas de tu aplicación siguen usando el nombre viejo, así que búscalo antes de renombrar.

Eliminar una columna

DROP COLUMN elimina la columna y sus datos. Falla si una vista o una clave foránea depende de la columna. CASCADE elimina también esos objetos, y IF EXISTS evita el error cuando la columna ya no existe.

Aquí PostgreSQL no reescribe la tabla. Marca la columna como eliminada, y el espacio se recupera a medida que se actualizan las filas o cuando la tabla se reescribe.

Cambiar el tipo de una columna

ALTER COLUMN ... TYPE convierte todos los valores. Cuando no hay una conversión automática del tipo viejo al nuevo, añade USING con una expresión que calcule el valor nuevo:

Sin USING, esta sentencia falla con column "price" cannot be cast automatically to type numeric. Si un solo valor no se puede convertir, toda la sentencia falla y la tabla queda igual.

La mayoría de los cambios de tipo reescriben la tabla. Algunos no: alargar un varchar(n) o pasar de varchar a text.

Poner o quitar un valor por defecto y NOT NULL

SET NOT NULL recorre la tabla y falla si alguna fila tiene un NULL, así que rellena los huecos primero:

DROP DEFAULT y DROP NOT NULL los quitan. Un valor por defecto nuevo solo se aplica a las inserciones futuras. Las filas existentes conservan sus valores.

Añadir una restricción

ALTER TABLE orders ADD CONSTRAINT total_positive CHECK (total > 0);
ALTER TABLE orders DROP CONSTRAINT total_positive;

Añadir un CHECK o una clave foránea recorre toda la tabla para validarla. En una tabla grande y con mucho tráfico, añádela primero con NOT VALID, que solo comprueba las filas nuevas. Después ejecuta ALTER TABLE orders VALIDATE CONSTRAINT total_positive;. Esto revisa las filas antiguas con un bloqueo más débil que deja seguir leyendo y escribiendo. La página de claves foráneas usa el mismo patrón, y la referencia de ALTER TABLE enumera cada forma y su bloqueo.

Preguntas frecuentes

¿Puedo cambiar el orden de las columnas en PostgreSQL?

No. ALTER TABLE no puede mover una columna, y las columnas nuevas siempre se añaden al final. Escribe las columnas en el orden que quieras en tu SELECT, o crea una tabla nueva con ese orden y copia los datos.

¿ALTER TABLE bloquea la tabla en PostgreSQL?

La mayoría de las formas toman un bloqueo ACCESS EXCLUSIVE, que impide lecturas y escrituras hasta que termina la sentencia. Los cambios rápidos (renombrar, eliminar una columna, agregar una columna con un valor por defecto constante) lo mantienen muy poco tiempo. Un cambio de tipo que reescribe la tabla lo mantiene durante toda la reescritura.

¿Cómo agrego varias columnas a la vez en PostgreSQL?

Separa las acciones con comas en una sola sentencia: ALTER TABLE users ADD COLUMN phone text, ADD COLUMN city text;. Todas las acciones de un mismo ALTER TABLE se ejecutan juntas, con un único bloqueo.

¿Se puede deshacer un ALTER TABLE en PostgreSQL?

Sí. En PostgreSQL el DDL es transaccional, así que un ALTER TABLE dentro de BEGIN ... ROLLBACK se deshace por completo.

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

Aprende a programar con Coddy

Comenzar