Menu

CREATE TABLE en PostgreSQL: sintaxis y ejemplos

CREATE TABLE define las columnas, los tipos y las restricciones de una tabla. Incluye claves identity, NOT NULL, DEFAULT, UNIQUE, CHECK, IF NOT EXISTS, CREATE TABLE AS y LIKE.

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

CREATE TABLE name (column type constraints, ...) crea una tabla. Cada columna lleva un nombre y un tipo de dato, y después restricciones opcionales como PRIMARY KEY, NOT NULL, DEFAULT, UNIQUE o CHECK.

La columna id se numera sola, plan toma 'free' cuando el insert no la incluye, y created_at guarda la hora del insert. La página de tipos de datos enumera los tipos de columna más comunes.

Restricciones de columna

RestricciónEfecto
PRIMARY KEYÚnica y no nula; una por tabla
NOT NULLLa columna tiene que tener un valor
DEFAULT exprValor que se usa cuando un insert omite la columna
UNIQUEDos filas no pueden compartir un valor (se permiten varios NULLs)
CHECK (expr)Rechaza las filas donde la expresión es falsa
REFERENCES t (col)Clave foránea a otra tabla

Desde PostgreSQL 15, UNIQUE NULLS NOT DISTINCT trata los NULLs como iguales, así que solo una fila puede tener NULL en esa columna.

Reglas que abarcan varias columnas

Una restricción sobre más de una columna va en su propia línea, después de las columnas. Darle nombre con CONSTRAINT name hace que los mensajes de error se entiendan y te permite eliminarla por nombre más adelante.

La consulta lista las tres restricciones. Las que no tenían nombre recibieron nombres generados, bookings_guests_check y bookings_pkey.

Crear una tabla solo si no existe

IF NOT EXISTS convierte el segundo CREATE TABLE en un aviso en lugar de un error. Solo comprueba el nombre. Si ya existe una tabla llamada logs con otras columnas, no cambia nada.

Crear una tabla a partir de una consulta o de otra tabla

CREATE TABLE ... AS crea una tabla con el resultado de un SELECT, con las columnas y los tipos de ese resultado. LIKE copia la definición de otra tabla sin sus filas, e INCLUDING ALL trae también sus valores por defecto, restricciones, identity e índices.

big_orders tiene una fila. orders_archive tiene las columnas y restricciones de orders y ninguna fila.

Columnas generadas

Una columna generada se calcula a partir de otras columnas de la misma fila, y los inserts no pueden escribirla. En PostgreSQL 17 tiene que ser STORED: el valor se calcula al escribir y se guarda en disco.

Los totales son 13.5 y 20.

Tablas temporales y unlogged

CREATE TEMP TABLE crea una tabla que solo ve la sesión actual y que se elimina cuando la sesión termina. Sirve para resultados intermedios en un script largo. CREATE UNLOGGED TABLE se salta el registro de escritura anticipada (WAL), así que las escrituras son más rápidas. La tabla se vacía tras una caída y no se copia a las réplicas, así que úsala solo para datos que puedas reconstruir.

CREATE TEMP TABLE import_batch (line text);
CREATE UNLOGGED TABLE page_views_staging (path text, seen_at timestamptz);

Para cambiar una tabla que ya existe, usa ALTER TABLE. Todas las opciones están en la referencia de CREATE TABLE.

Preguntas frecuentes

¿Los nombres de tabla distinguen mayúsculas en PostgreSQL?

Los nombres sin comillas se pasan a minúsculas, así que CREATE TABLE Users crea users. Un nombre entre comillas como "Users" conserva sus mayúsculas y luego hay que ponerlo entre comillas en cada consulta; por eso lo normal son nombres en minúsculas con snake_case.

¿Cómo veo la estructura de una tabla en PostgreSQL?

En psql, \d table_name muestra las columnas, los tipos, los valores por defecto, los índices y las restricciones. Desde SQL, consulta information_schema.columns WHERE table_name = 'table_name'.

¿Cómo copio una tabla en PostgreSQL?

CREATE TABLE copy AS TABLE original; copia las columnas y las filas, pero no las restricciones ni los índices. CREATE TABLE copy (LIKE original INCLUDING ALL); copia la estructura con valores por defecto, restricciones e índices, pero sin filas.

¿Cómo borro una tabla en PostgreSQL?

DROP TABLE table_name; elimina la tabla y sus datos. DROP TABLE IF EXISTS table_name; evita el error cuando no existe, y CASCADE elimina también las vistas y claves foráneas que dependen de ella.

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

Aprende a programar con Coddy

Comenzar