Menu

Tipos de datos en PostgreSQL: cuál usar en cada columna

Los tipos de datos de PostgreSQL que vas a usar en casi todas las columnas: enteros, numeric, text, boolean, timestamptz, uuid, jsonb, arrays y enums, y cuándo elegir cada uno.

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

Cada columna de PostgreSQL tiene un tipo fijo, definido en CREATE TABLE. La mayoría de las tablas solo necesitan unos pocos: bigint o integer para números enteros, numeric para dinero, text para cadenas, boolean, timestamptz para momentos en el tiempo y jsonb para documentos. pg_typeof() te dice el tipo de cualquier valor.

Los tipos principales y cuándo usar cada uno

TipoGuardaÚsalo para
integer (int)Enteros hasta unos 2100 millones, 4 bytesConteos, cantidades, ids pequeños
bigintEnteros hasta unos 9,2 trillones, 8 bytesClaves primarias, todo lo que pueda crecer
smallintHasta 32767, 2 bytesCasi nunca compensa
numeric(p, s)Decimales exactosDinero, tasas, todo lo que se suma
real, double precisionComa flotante binariaMediciones, valores científicos
textCadenas de cualquier longitudNombres, emails, descripciones
varchar(n)Cadenas con límite de longitudCuando el límite es una regla
booleantrue, false o NULLIndicadores
dateUn día del calendarioCumpleaños, fechas de vencimiento
timestamptzUn momento en el tiempoFechas de creación y actualización
intervalUna duración'2 hours', '30 days'
uuidIdentificador de 128 bitsIds públicos o distribuidos
jsonbJSON ya analizadoDatos sin una forma fija
text[], int[]Arrays de cualquier tipoListas cortas, etiquetas
byteaBytes en brutoValores binarios pequeños

Las decisiones más grandes tienen su propia página: timestamp vs timestamptz, tipos enum, jsonb y arrays. Los ids (serial, columnas identity, uuid) se explican en claves primarias.

numeric vs double precision

numeric guarda los decimales de forma exacta. real y double precision guardan fracciones binarias, así que valores como 0.1 son aproximaciones y las sumas pueden desviarse:

La suma numeric es 0.3. La suma en coma flotante es 0.30000000000000004, y la comparación de igualdad da false. Usa numeric para el dinero: numeric(10, 2) admite 10 dígitos en total, 2 después del punto, y redondea los decimales de más al insertar.

Dividir un entero entre otro entero descarta la parte decimal:

7 / 2 devuelve 3. Haz que uno de los lados sea numeric (un literal con punto decimal o una conversión) para obtener 3.5.

text vs varchar(n) vs char(n)

Los tres se guardan igual y ninguno es más rápido. varchar(n) rechaza los valores más largos al insertar, lo que solo ayuda cuando el límite es una regla de tus datos. char(n) rellena con espacios y no tiene uso en tablas nuevas. Una conversión explícita a varchar(n) trunca en lugar de fallar.

La conversión devuelve Post. El valor char(5) ocupa 5 bytes, pero length ignora el relleno y devuelve 2.

Valores boolean y NULL

Una columna boolean acepta true, false, 't', 'yes', 'on', '1' y sus opuestos, y siempre devuelve true o false. Un valor que falta es NULL, que no es ninguno de los dos, así que WHERE NOT active se salta las filas donde active es NULL.

Usa IS TRUE, IS NOT TRUE o COALESCE(active, false) cuando NULL deba contar como falso.

Preguntas frecuentes

¿Hay diferencia de rendimiento entre text y varchar en PostgreSQL?

No. text, varchar y varchar(n) se guardan igual. varchar(n) solo añade una comprobación de longitud, así que usa text salvo que el límite sea una regla real de tus datos.

¿Debo usar el tipo money en PostgreSQL?

Normalmente no. Su entrada y salida dependen del ajuste lc_monetary, y el valor no guarda su moneda. Guarda los importes en numeric(12,2) y la moneda en su propia columna.

¿Cuál es el equivalente de DATETIME en PostgreSQL?

timestamptz (timestamp with time zone) para momentos concretos, o timestamp para una hora de reloj sin zona. PostgreSQL no tiene un tipo DATETIME.

¿Cómo veo el tipo de un valor o de una columna en PostgreSQL?

SELECT pg_typeof(expression) devuelve el tipo de cualquier expresión, incluida una columna. En psql, \d table_name lista cada columna con su tipo.

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

Aprende a programar con Coddy

Comenzar