COPY est la commande hautement performante de PostgreSQL pour charger et exporter des données en masse — déplacer de grandes quantités de données entre un fichier (ou flux) et une table bien plus rapidement que des instructions INSERT individuelles. C'est l'outil standard pour importer/exporter de grands ensembles de données.
users (name, email, age) (FORMAT csv, HEADER );
users (FORMAT csv, HEADER );
\ users (FORMAT csv, HEADER )
COPY lit/écrit un fichier entier en une seule opération — dramatiquement plus rapide qu'exécuter des milliers d'INSERT individuels.
❌ 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 est l'outil PostgreSQL essentiel pour charger et exporter efficacement des données en masse, et le comprendre est précieux pour tout scénario impliquant de grands ensembles de données — migrations de données, ETL, imports/exports, initialisation et analytique, qui sont des besoins courants du monde réel.
La valeur clé est la performance : charger de grandes quantités de données avec des instructions INSERT individuelles est dramatiquement lent (surcharge par instruction, allers-retours — potentiellement 10 à 100 fois plus lent), tandis que COPY effectue le chargement en tant qu'une seule opération en masse optimisée, ce qui en fait l'approche de référence pour importer ou exporter de grands ensembles de données (des milliers à des millions de lignes).
Comprendre pourquoi COPY est tellement plus rapide (opération en masse vs surcharge par ligne) clarifie quand l'utiliser (données volumineuses) par rapport aux INSERT (petites données/lignes individuelles).
Connaître la distinction pratique entre COPY (commande SQL côté serveur, nécessite l'accès/les privilèges de fichier) et \copy (commande côté client psql, pas de privilèges spéciaux — fonctionne contre les bases de données distantes depuis votre machine) est important pour l'utiliser réellement dans différents contextes.
Les conseils de chargement en masse (utiliser COPY plutôt que INSERT, supprimer/recréer les index autour de très gros chargements puisque construire un index une seule fois bat le maintenir par ligne, charger dans une transaction) sont des connaissances d'optimisation précieuses pour les gros imports.
Puisque les opérations de données en masse (migrations, imports, exports, ETL) sont courantes, et puisque COPY est la façon standard et hautement performante de les gérer dans PostgreSQL (surpassant massivement les INSERT pour de grandes données), comprendre COPY — son avantage de performance, la distinction COPY vs \copy, et les meilleures pratiques de chargement en masse — est une connaissance précieuse et pratiquement pertinente pour déplacer efficacement de grands ensembles de données dans et hors de Postgres, un besoin opérationnel fréquent où utiliser le bon outil (COPY) fait une grande différence.