COPY je PostgreSQL-ova naredba visokih performansi za masovno učitavanje i izvoz podataka — prebacivanje velikih količina podataka između datoteke (ili toka) i tablice mnogo brže nego s individualnim INSERT naredbama. To je standardni alat za uvoz/izvoz velikih skupova podataka.
users (name, email, age) (FORMAT csv, HEADER );
users (FORMAT csv, HEADER );
\ users (FORMAT csv, HEADER )
COPY čita/piše cijelu datoteku u jednoj operaciji — dramatično brže nego pokretanje tisuća individualnih INSERT-a.
❌ 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 je osnovni PostgreSQL-ov alat za efikasno masovno učitavanje i izvoz podataka, a razumijevanje tog alata dragocjeno je za svaki scenarij koji uključuje velike skupove podataka — migracije podataka, ETL, uvozе/izvozе, inicijalizacija i analitiku, što su česta realna potreba.
Ključna vrijednost je performansa: učitavanje velikih količina podataka s individualnim INSERT naredbama je dramatično spora (overhead po naredbi, povratne veze — potencijalno 10-100 puta spora), dok COPY provodi učitavanje kao jednu optimiziranu masovnu operaciju, što ga čini prvim izborom za uvoz ili izvoz velikih skupova podataka (od tisuća do milijuna redaka).
Razumijevanje zašto je COPY toliko brži (masovna operacija vs overhead po redaku) pojašnjava kada ga koristiti (veliki podaci) nasuprot INSERT-ima (mali/individualni redaci).
Znanje praktične razlike između COPY (serverska SQL naredba, trebaju pristup datotekama/dozvole) i \copy (psql klijentska naredba, nema posebnih dozvola — radi s udaljenim bazama podataka sa vašeg računala) važno je za stvarnu primjenu u različitim kontekstima.
Savjeti za masovno učitavanje (korištenje COPY-ja umjesto INSERT-a, ispuštanje/ponovno stvaranje indeksa oko ogromnih učitavanja jer je gradnja indeksa jednom bolja nego održavanje po redaku, učitavanje u transakciji) dragocjeno su znanje o optimizaciji za velike uvozе.
Budući da su masovne operacije s podacima (migracije, uvozе, izvozе, ETL) česte, i budući da je COPY standardni, brz način rukovanja njima u PostgreSQL-u (vastly bolji od INSERT-a za velike podatke), razumijevanje COPY-ja — njegova performansa, razlika između COPY-ja i \copy-ja, te najbolje prakse za masovno učitavanje — dragocjeno je, praktično-relevantno znanje za efikasno prebacivanje velikih skupova podataka iz i u Postgres, česta operativna potreba gdje korištenje pravog alata (COPY) čini veliku razliku.