COPY är PostgreSQLs högpresterande kommando för bulk-inläsning och export av data — det flyttar stora mängder data mellan en fil (eller stream) och en tabell mycket snabbare än enskilda INSERT-satser. Det är standardverktyget för import/export av stora dataset.
users (name, email, age) (FORMAT csv, HEADER );
users (FORMAT csv, HEADER );
\ users (FORMAT csv, HEADER )
COPY läser/skriver en hel fil i en operation — dramatiskt snabbare än att köra tusentals enskilda INSERTs.
❌ 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 är PostgreSQLs väsentliga verktyg för effektiv bulk-inläsning och export av data, och att förstå det är värdefullt för alla scenario som involverar stora dataset — datamigrering, ETL, import/export, seeding och analys, vilket är vanliga verkliga behov.
Huvudnyttan är prestanda: att ladda stora mängder data med enskilda INSERT-satser är dramatiskt långsamt (per-sats overhead, round-trips — potentiellt 10-100x långsammare), medan COPY utför inläsningen som en optimerad bulk-operation, vilket gör det till förstahandsverktyget för import eller export av stora dataset (tusentals till miljoner rader).
Att förstå varför COPY är så mycket snabbare (bulk-operation vs per-rad overhead) klargör när man ska använd det (stora dataset) kontra INSERTs (små/enskilda rader).
Att känna till den praktiska skillnaden mellan COPY (server-sid SQL-kommando, behöver filåtkomst/behörigheter) och \copy (psql klient-sid kommando, ingen särskild behörighet — fungerar mot fjärrdatabaser från din maskin) är viktigt för att faktiskt kunna använda det i olika sammanhang.
De bulk-inläsningstipsen (använd COPY över INSERTs, ta bort/återskapa index runt enorma inläsningar eftersom att bygga ett index en gång är bättre än att underhålla det per rad, ladda i en transaktion) är värdefull optimeringskunskap för stora importer.
Eftersom bulk-dataoperationer (migrering, import, export, ETL) är vanliga, och eftersom COPY är standardmetoden för högprestanda-hantering av dem i PostgreSQL (överträffar drastiskt INSERTs för stora dataset), är det värdefullt, praktiskt relevant kunskap att förstå COPY — dess prestandabenefit, COPY vs \copy-skillnaden och bulk-inläsningsbästa praxis — för effektiv förflyttning av stora dataset in i och ut från Postgres, ett vanligt operativt behov där att använda rätt verktyg (COPY) gör en stor skillnad.