COPY es el comando de alto rendimiento de PostgreSQL para carga en lote y exportación de datos — mueve grandes cantidades de datos entre un archivo (o flujo) y una tabla mucho más rápido que las sentencias INSERT individuales. Es la herramienta estándar para importar/exportar grandes conjuntos de datos.
users (name, email, age) (FORMAT csv, HEADER );
users (FORMAT csv, HEADER );
\ users (FORMAT csv, HEADER )
COPY lee/escribe un archivo completo en una sola operación — dramaticamente más rápido que ejecutar miles de INSERTs individuales.
❌ thousands of individual INSERTs:
each is a separate statement → per-statement overhead, possibly per-row transactions,
network round-trips → SLOW for large data (can be 10-100x slower)
✅ COPY:
one bulk operation, minimal overhead, optimized data path → FAST
→ For loading large datasets, COPY is the go-to; INSERTs are for small/individual rows.
COPY (SQL command) → reads/writes files on the SERVER, needs superuser/file privileges
\copy (psql command) → reads/writes files on the CLIENT, no special privileges
→ Use \copy when running from your machine against a remote database.
✓ Use COPY (not INSERTs) for large data
✓ Consider dropping/disabling indexes and constraints during a huge load, then
recreating them after (building an index once is faster than maintaining it per-row)
✓ Load within a single transaction; increase maintenance_work_mem for index rebuilds
✓ For programmatic bulk inserts, use multi-row INSERT or the driver's COPY support
COPY es la herramienta esencial de PostgreSQL para carga y exportación eficiente de datos en lote, y comprenderla es valioso para cualquier escenario que involucre grandes conjuntos de datos — migraciones de datos, ETL, importaciones/exportaciones, inicialización y análisis, que son necesidades comunes en el mundo real.
El valor clave es el rendimiento: cargar grandes cantidades de datos con sentencias INSERT individuales es dramáticamente lento (sobrecarga por sentencia, viajes de ida y vuelta — potencialmente 10-100x más lento), mientras que COPY realiza la carga como una única operación en lote optimizada, convirtiéndola en la opción preferida para importar o exportar grandes conjuntos de datos (miles a millones de filas).
Entender por qué COPY es mucho más rápido (operación en lote vs sobrecarga por fila) aclara cuándo utilizarlo (datos grandes) versus INSERTs (filas pequeñas/individuales).
Conocer la distinción práctica entre COPY (comando SQL del lado servidor, requiere acceso a archivos/privilegios) y \copy (comando del lado cliente de psql, sin privilegios especiales — funciona contra bases de datos remotas desde tu máquina) es importante para utilizarlo en diferentes contextos.
Los consejos de carga en lote (usar COPY sobre INSERTs, descartar/recrear índices alrededor de cargas enormes ya que construir un índice una sola vez es mejor que mantenerlo por fila, cargar en una transacción) son conocimientos de optimización valiosos para importaciones grandes.
Ya que las operaciones de datos en lote (migraciones, importaciones, exportaciones, ETL) son comunes, y ya que COPY es la forma estándar de alto rendimiento para manejarlas en PostgreSQL (superando dramáticamente a INSERTs para datos grandes), entender COPY — su beneficio de rendimiento, la distinción COPY vs \copy, y las mejores prácticas de carga en lote — es conocimiento valioso y prácticamente relevante para mover grandes conjuntos de datos de forma eficiente dentro y fuera de Postgres, una necesidad operacional frecuente donde usar la herramienta correcta (COPY) hace una diferencia importante.