Conceptos básicos de tipos de datos

10 ejemplos para empezar con los tipos de datos de PostgreSQL: 7 básicos y 3 intermedios.

Prerrequisitos

Conectado a PostgreSQL 18 con privilegio CREATE en un esquema temporal.

# Desarrollo local con Docker (PostgreSQL 18)
docker run -d --name pg18 -e POSTGRES_PASSWORD=dev -p 5432:5432 postgres:18
psql postgres://postgres:dev@localhost:5432/postgres

Ejemplos básicos

1. Familia de enteros

bigint para IDs; int para recuentos; smallint para enums como enteros.

CREATE TABLE app.counts (
  id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
  score int NOT NULL CHECK (score BETWEEN 0 AND 100)
);

• bigint evita el desbordamiento de int en IDs de Snowflake
• CHECK aplica el rango sin validación solo de la aplicación
• Los tipos más pequeños estrechan los índices

2. Texto vs varchar

text no tiene penalización de rendimiento frente a varchar(n) en PostgreSQL.

CREATE TABLE app.labels (
  code text NOT NULL UNIQUE,
  title text NOT NULL
);

• Usa varchar(n) cuando el estándar exija una longitud máxima
• text es el predeterminado para cadenas arbitrarias
• La intercalación afecta el orden de clasificación

3. Booleano

Tres valores si es anulable; prefiere NOT NULL con un valor predeterminado.

ALTER TABLE app.customers ADD COLUMN is_active boolean NOT NULL DEFAULT true;

• Evita el triestado booleano a menos que NULL signifique desconocido
• Los índices parciales a menudo filtran is_active = true

4. Numérico para dinero

numeric(p,s) para aritmética decimal exacta.

CREATE TABLE app.payments (
  id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
  amount numeric(12,2) NOT NULL CHECK (amount >= 0)
);

• Nunca uses float para moneda
• La escala se fija en la definición del tipo
• SUM y AVG se mantienen exactos

5. timestamptz

Almacena instantes en UTC.

CREATE TABLE app.events (
  id bigint GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
  occurred_at timestamptz NOT NULL DEFAULT now()
);

• Session TimeZone solo afecta la visualización
• Evita timestamp without time zone para eventos reales
• Las consultas de rango se benefician de btree en occurred_at

6. Claves UUID

Tipo uuid con gen_random_uuid().

CREATE EXTENSION IF NOT EXISTS pgcrypto;
CREATE TABLE app.tokens (
  id uuid PRIMARY KEY DEFAULT gen_random_uuid()
);

• Los UUID aleatorios fragmentan ligeramente los índices
• Considera uuidv7 en la capa de aplicación para el orden temporal
• Más pequeño que las cadenas UUID de texto

7. Documentos jsonb

JSON binario con operadores de indexación.

CREATE TABLE app.profiles (
  user_id bigint PRIMARY KEY,
  attrs jsonb NOT NULL DEFAULT '{}'::jsonb
);
INSERT INTO app.profiles VALUES (1, '{"tier":"pro"}');

• jsonb elimina claves duplicadas y las descompone
• Los índices GIN aceleran las consultas de contención
• No dupliques todos los campos relacionales en JSON

Ejemplos intermedios

8. Tipo Enum

Conjunto cerrado de etiquetas almacenado como OIDs.

CREATE TYPE app.plan_tier AS ENUM ('free','pro','enterprise');
ALTER TABLE app.customers ADD COLUMN tier app.plan_tier NOT NULL DEFAULT 'free';

• Comparaciones rápidas y salida legible
• Agregar valores requiere disciplina de migración
• Las tablas de búsqueda son más flexibles para cambios frecuentes

9. Columna de Array

Arrays de Postgres para etiquetas (úsalo con cuidado).

ALTER TABLE app.customers ADD COLUMN tags text[] NOT NULL DEFAULT '{}';
CREATE INDEX customers_tags_gin ON app.customers USING gin (tags);

• GIN soporta la contención @>
• Evita el crecimiento ilimitado del array
• Normaliza cuando los elementos se convierten en entidades

10. Envoltorio de Dominio

Reglas CHECK reutilizables sobre un tipo base.

CREATE DOMAIN app.email AS text
  CHECK (VALUE ~* '^[^@]+@[^@]+\.[^@]+$');
ALTER TABLE app.customers ALTER COLUMN email TYPE app.email USING email::app.email;

• Definición única para reglas repetidas
• Los errores hacen referencia al nombre del dominio
• Funciona con NOT NULL y UNIQUE

Versiones de la pila: Esta página se escribió para PostgreSQL 18.4 (estable 18, mantenimiento 17), pgvector 0.8+, PgBouncer 1.x, Patroni 3.x y PostGIS 3.5+.