pg_dumpall - Daring di Awan

PROGRAM:

NAMA

pg_dumpall - ekstrak cluster database PostgreSQL ke dalam file skrip

RINGKASAN

pg_dumpal [koneksi-opsi...] [Option...]

DESKRIPSI

pg_dumpall adalah utilitas untuk menulis ("membuang") semua database PostgreSQL dari sebuah cluster
menjadi satu file skrip. File skrip berisi perintah SQL yang dapat digunakan sebagai input untuk
psql(1) untuk memulihkan database. Ia melakukan ini dengan menelepon hal_dump(1) untuk setiap database di
sebuah cluster. pg_dumpall juga membuang objek global yang umum untuk semua database.
(pg_dump tidak menyimpan objek-objek ini.) Saat ini termasuk informasi tentang database
pengguna dan grup, tablespace, dan properti seperti izin akses yang berlaku untuk
database secara keseluruhan.

Karena pg_dumpall membaca tabel dari semua database, kemungkinan besar Anda harus terhubung sebagai
database superuser untuk menghasilkan dump lengkap. Anda juga akan membutuhkan pengguna super
hak istimewa untuk mengeksekusi skrip yang disimpan agar diizinkan untuk menambahkan pengguna dan grup, dan
untuk membuat database.

Skrip SQL akan ditulis ke output standar. Gunakan opsi [-f|file] atau shell
operator untuk mengarahkannya ke file.

pg_dumpall perlu terhubung beberapa kali ke server PostgreSQL (sekali per database). Jika
Anda menggunakan otentikasi kata sandi itu akan meminta kata sandi setiap kali. Nyaman untuk
memiliki ~/.pgpass file dalam kasus seperti itu. Lihat Bagian 31.15, “File Kata Sandi”, di
dokumentasi untuk informasi lebih lanjut.

PILIHAN

Opsi baris perintah berikut mengontrol konten dan format output.

-a
--hanya data
Buang hanya data, bukan skema (definisi data).

-c
--membersihkan
Sertakan perintah SQL untuk membersihkan (menjatuhkan) database sebelum membuatnya kembali. DROP perintah
untuk peran dan tablespace juga ditambahkan.

-f nama file
--berkas=nama file
Kirim output ke file yang ditentukan. Jika ini dihilangkan, output standar digunakan.

-g
--khusus global
Buang hanya objek global (peran dan tablespace), tanpa database.

-o
--oids
Buang pengidentifikasi objek (OID) sebagai bagian dari data untuk setiap tabel. Gunakan opsi ini jika
aplikasi Anda mereferensikan kolom OID dalam beberapa cara (misalnya, dalam kunci asing
paksaan). Jika tidak, opsi ini tidak boleh digunakan.

-O
--tidak ada pemilik
Jangan mengeluarkan perintah untuk mengatur kepemilikan objek agar sesuai dengan database asli. Oleh
default, masalah pg_dumpall MENGUBAH PEMILIK or SET SIDANG OTORISASI pernyataan untuk mengatur
kepemilikan elemen skema yang dibuat. Pernyataan-pernyataan ini akan gagal ketika skripnya
dijalankan kecuali jika dimulai oleh pengguna super (atau pengguna yang sama yang memiliki semua objek
dalam naskah). Untuk membuat skrip yang dapat dipulihkan oleh pengguna mana pun, tetapi akan memberikannya
kepemilikan pengguna atas semua objek, tentukan -O.

-r
--role-only
Buang hanya peran, tidak ada database atau tablespace.

-s
--skema-saja
Buang hanya definisi objek (skema), bukan data.

-S nama pengguna
--pengguna super=nama pengguna
Tentukan nama pengguna super untuk digunakan saat menonaktifkan pemicu. Ini hanya relevan
if --disable-trigger digunakan. (Biasanya, lebih baik tinggalkan ini, dan sebagai gantinya
mulai skrip yang dihasilkan sebagai pengguna super.)

-t
--tablespaces-saja
Buang hanya tablespace, tidak ada database atau peran.

-v
--bertele-tele
Menentukan mode verbose. Ini akan menyebabkan pg_dumpall menampilkan waktu mulai/berhenti ke
dump file, dan pesan kemajuan ke kesalahan standar. Ini juga akan mengaktifkan keluaran verbose
di pg_dump.

-V
--Versi: kapan
Cetak versi pg_dumpall dan keluar.

-x
--tanpa hak istimewa
--tidak-acl
Cegah dumping hak akses (perintah hibah/cabut).

--peningkatan biner
Opsi ini untuk digunakan oleh utilitas peningkatan di tempat. Penggunaannya untuk tujuan lain adalah
tidak direkomendasikan atau didukung. Perilaku opsi dapat berubah di rilis mendatang
tanpa pemberitahuan.

--sisipan-kolom
--atribut-insert
Buang data sebagai MEMASUKKAN perintah dengan nama kolom eksplisit (INSERT INTO tabel (kolom,
...) NILAI ...). Ini akan membuat pemulihan menjadi sangat lambat; itu terutama berguna untuk membuat
dump yang dapat dimuat ke dalam database non-PostgreSQL.

--disable-dolar-quoting
Opsi ini menonaktifkan penggunaan kuotasi dolar untuk badan fungsi, dan memaksa mereka untuk
dikutip menggunakan sintaks string standar SQL.

--disable-trigger
Opsi ini hanya relevan saat membuat dump data saja. Ini menginstruksikan pg_dumpall
untuk memasukkan perintah untuk menonaktifkan sementara pemicu pada tabel target saat
data dimuat ulang. Gunakan ini jika Anda memiliki pemeriksaan integritas referensial atau pemicu lainnya
pada tabel yang tidak ingin Anda panggil saat memuat ulang data.

Saat ini, perintah yang dikeluarkan untuk --disable-trigger harus dilakukan sebagai superuser. Jadi,
Anda juga harus menentukan nama pengguna super dengan -S, atau sebaiknya berhati-hati untuk memulai
skrip yang dihasilkan sebagai pengguna super.

--jika-ada
Gunakan perintah bersyarat (yaitu menambahkan klausa IF EXISTS) untuk membersihkan database dan lainnya
objek. Opsi ini tidak valid kecuali --membersihkan juga ditentukan.

--sisipan
Buang data sebagai MEMASUKKAN perintah (daripada COPY). Ini akan membuat pemulihan menjadi sangat lambat;
ini terutama berguna untuk membuat dump yang dapat dimuat ke dalam database non-PostgreSQL.
Perhatikan bahwa pemulihan mungkin gagal sama sekali jika Anda telah mengatur ulang urutan kolom. NS
--sisipan-kolom pilihan lebih aman, meskipun lebih lambat.

--lock-tunggu-waktu habis=batas waktu
Jangan menunggu selamanya untuk mendapatkan kunci meja bersama di awal dump.
Sebaliknya, gagal jika tidak dapat mengunci tabel dalam yang ditentukan batas waktu. Batas waktu mungkin
ditentukan dalam format apa pun yang diterima oleh SET pernyataan_waktu habis. Nilai yang diizinkan
bervariasi tergantung pada versi server tempat Anda membuang, tetapi bilangan bulat dari
milidetik diterima oleh semua versi sejak 7.3. Opsi ini diabaikan ketika
dumping dari server pra-7.3.

--tanpa-keamanan-label
Jangan membuang label keamanan.

--tidak ada spasi tabel
Jangan mengeluarkan perintah untuk membuat tablespace atau memilih tablespace untuk objek. Dengan
opsi ini, semua objek akan dibuat di tablespace mana pun yang menjadi default selama
memulihkan.

--no-unlog-table-data
Jangan membuang konten tabel yang tidak dicatat. Opsi ini tidak berpengaruh pada apakah atau
bukan definisi tabel (skema) yang dibuang; itu hanya menekan membuang meja
Data.

--kutipan-semua-pengidentifikasi
Memaksa mengutip semua pengidentifikasi. Ini mungkin berguna saat membuang database untuk
migrasi ke versi mendatang yang mungkin telah memperkenalkan kata kunci tambahan.

--gunakan-set-sesi-otorisasi
Keluaran standar SQL SET SIDANG OTORISASI perintah alih-alih MENGUBAH PEMILIK perintah
untuk menentukan kepemilikan objek. Ini membuat dump lebih kompatibel dengan standar, tapi
tergantung pada sejarah objek di dump, mungkin tidak memulihkan dengan benar.

-?
--membantu
Tampilkan bantuan tentang argumen baris perintah pg_dumpall, dan keluar.

Opsi baris perintah berikut mengontrol parameter koneksi database.

-d kontrol
--namadb=kontrol
Menentukan parameter yang digunakan untuk terhubung ke server, sebagai string koneksi. Lihat
Bagian 31.1.1, “Connection Strings”, dalam dokumentasi untuk informasi lebih lanjut.

Opsi ini disebut --dbname untuk konsistensi dengan aplikasi klien lain, tetapi
karena pg_dumpall perlu terhubung ke banyak database, nama database dalam koneksi
string akan diabaikan. Gunakan opsi -l untuk menentukan nama database yang digunakan untuk membuang
objek global dan untuk menemukan database lain apa yang harus dibuang.

-h tuan rumah
--tuan rumah=tuan rumah
Menentukan nama host dari mesin yang menjalankan server database. jika
value dimulai dengan garis miring, digunakan sebagai direktori untuk soket domain Unix. NS
default diambil dari PGHOST variabel lingkungan, jika disetel, jika tidak, domain Unix
koneksi soket dicoba.

-l nama db
--basis data=nama db
Menentukan nama database yang akan disambungkan untuk membuang objek global dan
menemukan database lain apa yang harus dibuang. Jika tidak ditentukan, postgres
database akan digunakan, dan jika tidak ada, template1 akan digunakan.

-p pelabuhan
--pelabuhan=pelabuhan
Menentukan port TCP atau ekstensi file soket domain Unix lokal tempat server
sedang mendengarkan koneksi. Default untuk PGPORT variabel lingkungan, jika disetel, atau
default yang dikompilasi.

-U nama pengguna
--nama pengguna=nama pengguna
Nama pengguna untuk terhubung sebagai.

-w
--tanpa kata sandi
Jangan pernah mengeluarkan prompt kata sandi. Jika server memerlukan otentikasi kata sandi dan a
kata sandi tidak tersedia dengan cara lain seperti file .pgpass, koneksi
usaha akan gagal. Opsi ini dapat berguna dalam pekerjaan batch dan skrip di mana tidak ada pengguna
hadir untuk memasukkan kata sandi.

-W
--kata sandi
Paksa pg_dumpall untuk meminta kata sandi sebelum menghubungkan ke database.

Opsi ini tidak pernah penting, karena pg_dumpall akan secara otomatis meminta a
kata sandi jika server meminta otentikasi kata sandi. Namun, pg_dumpall akan sia-sia
upaya koneksi mencari tahu bahwa server menginginkan kata sandi. Dalam beberapa kasus itu adalah
layak mengetik -W untuk menghindari upaya koneksi ekstra.

Perhatikan bahwa prompt kata sandi akan muncul lagi untuk setiap database yang akan dibuang.
Biasanya, lebih baik untuk mengatur ~/.pgpass file daripada mengandalkan entri kata sandi manual.

--peran=nama peran
Menentukan nama peran yang akan digunakan untuk membuat dump. Opsi ini menyebabkan pg_dumpall menjadi
masalah a SET PERAN nama peran perintah setelah terhubung ke database. Ini berguna ketika
pengguna yang diautentikasi (ditentukan oleh -U) tidak memiliki hak istimewa yang dibutuhkan oleh pg_dumpall, tapi
dapat beralih ke peran dengan hak yang diperlukan. Beberapa instalasi memiliki kebijakan
terhadap masuk secara langsung sebagai pengguna super, dan penggunaan opsi ini memungkinkan dump menjadi
dibuat tanpa melanggar kebijakan.

LINGKUNGAN

PGHOST
PGOPSI
PGPORT
PGUSER
Parameter koneksi default

Utilitas ini, seperti kebanyakan utilitas PostgreSQL lainnya, juga menggunakan variabel lingkungan
didukung oleh libpq (lihat Bagian 31.14, “Variabel Lingkungan”, dalam dokumentasi).

CATATAN

Karena pg_dumpall memanggil pg_dump secara internal, beberapa pesan diagnostik akan merujuk ke pg_dump.

Setelah dipulihkan, adalah bijaksana untuk lari ANALISIS pada setiap database sehingga pengoptimal memiliki manfaat
statistik. Anda juga bisa berlari vakumdb -a -z untuk menganalisis semua database.

pg_dumpall mengharuskan semua direktori tablespace yang diperlukan ada sebelum pemulihan;
jika tidak, pembuatan database akan gagal untuk database di lokasi non-default.

CONTOH

Untuk membuang semua database:

$ pg_dumpal > db.keluar

Untuk memuat ulang basis data dari file ini, Anda dapat menggunakan:

$ psql -f db.keluar postgres

(Tidak penting ke database mana yang Anda hubungkan di sini karena file skrip dibuat oleh
pg_dumpall akan berisi perintah yang sesuai untuk membuat dan menghubungkan ke yang disimpan
database.)

Gunakan pg_dumpall online menggunakan layanan onworks.net