COPY ialah perintah PostgreSQL berprestasi tinggi untuk pemuatan dan pengeksportan pukal data — memindahkan sejumlah besar data antara fail (atau strim) dan jadual jauh lebih pantas daripada penyataan INSERT individu. Ia merupakan alat standard untuk mengimport/mengeksport set data besar.
users (name, email, age) (FORMAT csv, HEADER );
users (FORMAT csv, HEADER );
\ users (FORMAT csv, HEADER )
COPY membaca/menulis keseluruhan fail dalam satu operasi — jauh lebih pantas daripada menjalankan ribuan INSERT individu.
❌ 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 ialah alat PostgreSQL penting untuk pemuatan dan pengeksportan data pukal yang cekap, dan memahaminya berharga untuk sebarang senario yang melibatkan set data besar — migrasi data, ETL, import/eksport, seeding, dan analitik, yang merupakan keperluan dunia sebenar yang biasa.
Nilai utamanya ialah prestasi: memuatkan sejumlah besar data dengan penyataan INSERT individu adalah amat lambat (overhead setiap penyataan, round-trip — berpotensi 10-100x lebih lambat), manakala COPY melaksanakan pemuatan sebagai satu operasi pukal yang dioptimumkan, menjadikannya pilihan utama untuk mengimport atau mengeksport set data besar (ribuan hingga jutaan baris).
Memahami mengapa COPY jauh lebih pantas (operasi pukal berbanding overhead setiap baris) menjelaskan bila hendak menggunakannya (data besar) berbanding INSERT (baris kecil/individu).
Mengetahui perbezaan praktikal antara COPY (perintah SQL server-side, memerlukan akses fail/keistimewaan) dan \copy (perintah psql client-side, tiada keistimewaan khas — berfungsi terhadap pangkalan data jauh dari mesin anda) adalah penting untuk benar-benar menggunakannya dalam konteks yang berbeza.
Petua pemuatan pukal (menggunakan COPY berbanding INSERT, men-drop/mencipta semula indeks sekitar pemuatan besar kerana membina indeks sekali mengatasi mengekalkannya setiap baris, memuatkan dalam transaksi) ialah pengetahuan pengoptimuman yang berharga untuk import besar.
Memandangkan operasi data pukal (migrasi, import, eksport, ETL) adalah biasa, dan memandangkan COPY ialah cara standard berprestasi tinggi untuk mengendalikannya dalam PostgreSQL (jauh mengatasi INSERT untuk data besar), memahami COPY — manfaat prestasinya, perbezaan COPY vs \copy, dan amalan terbaik pemuatan pukal — ialah pengetahuan yang berharga dan relevan secara praktikal untuk memindahkan set data besar masuk dan keluar Postgres dengan cekap, satu keperluan operasi yang kerap di mana menggunakan alat yang betul (COPY) membuat perbezaan besar.