pg_basebackup - Online di Cloud

PROGRAM:

NAMA

pg_basebackup - ambil cadangan dasar dari cluster PostgreSQL

RINGKASAN

pg_basebackup [Option...]

DESKRIPSI

pg_basebackup digunakan untuk mengambil backup dasar dari cluster database PostgreSQL yang sedang berjalan. Ini
diambil tanpa mempengaruhi klien lain ke database, dan dapat digunakan baik untuk
pemulihan point-in-time (lihat Bagian 24.3, “Pengarsipan Berkelanjutan dan Pemulihan Point-in-Time
(PITR)”, dalam dokumentasi) dan sebagai titik awal untuk pengiriman atau streaming log
replikasi server siaga (lihat Bagian 25.2, “Server Siaga Pengiriman Log”, di
dokumentasi).

pg_basebackup membuat salinan biner dari file cluster database, sambil memastikan
sistem dimasukkan dan keluar dari mode cadangan secara otomatis. Cadangan selalu diambil dari
seluruh klaster basis data; tidak mungkin untuk mencadangkan basis data atau basis data individual
objek. Untuk backup database individu, alat seperti: hal_dump(1) harus digunakan.

Pencadangan dilakukan melalui koneksi PostgreSQL biasa, dan menggunakan replikasi
protokol. Koneksi harus dilakukan dengan superuser atau pengguna yang memiliki REPLICATION
izin (lihat Bagian 20.2, “Atribut Peran”, dalam dokumentasi), dan pg_hba.conf
harus secara eksplisit mengizinkan koneksi replikasi. Server juga harus dikonfigurasi dengan
max_wal_senders disetel cukup tinggi untuk menyisakan setidaknya satu sesi yang tersedia untuk cadangan.

Mungkin ada banyak pg_basebackups berjalan pada saat yang sama, tetapi lebih baik dari a
sudut pandang kinerja untuk mengambil hanya satu cadangan, dan menyalin hasilnya.

pg_basebackup dapat membuat cadangan dasar tidak hanya dari master tetapi juga dari standby. Ke
ambil cadangan dari siaga, atur siaga agar dapat menerima replikasi
koneksi (yaitu, set max_wal_senders dan hot_standby, dan konfigurasikan berbasis host
autentikasi). Anda juga harus mengaktifkan full_page_writes pada master.

Perhatikan bahwa ada beberapa batasan dalam pencadangan online dari standby:

· File riwayat pencadangan tidak dibuat di cluster basis data yang dicadangkan.

· Tidak ada jaminan bahwa semua file WAL yang diperlukan untuk pencadangan diarsipkan di
akhir cadangan. Jika Anda berencana menggunakan cadangan untuk pemulihan arsip dan ingin
untuk memastikan bahwa semua file yang diperlukan tersedia pada saat itu, Anda perlu menyertakan
mereka ke dalam cadangan dengan menggunakan opsi -x.

· Jika standby dipromosikan ke master selama pencadangan online, pencadangan gagal.

· Semua catatan WAL yang diperlukan untuk pencadangan harus berisi penulisan halaman penuh yang cukup,
yang mengharuskan Anda untuk mengaktifkan penulisan_halaman_penuh pada master dan tidak menggunakan alat seperti
pg_compresslog sebagai arsip_perintah untuk menghapus penulisan satu halaman penuh dari file WAL.

PILIHAN

Opsi baris perintah berikut mengontrol lokasi dan format output.

-D direktori
--pgdata=direktori
Direktori untuk menulis output. pg_basebackup akan membuat direktori dan apapun
direktori induk jika perlu. Direktori mungkin sudah ada, tetapi ini adalah kesalahan
jika direktori sudah ada dan tidak kosong.

Ketika cadangan dalam mode tar, dan direktori ditentukan sebagai - (tanda hubung), tar
file akan ditulis ke stdout.

Opsi ini diperlukan.

-F format
--format=format
Memilih format untuk output. format dapat berupa salah satu dari berikut ini:

p
polos
Tulis output sebagai file biasa, dengan tata letak yang sama dengan data saat ini
direktori dan tablespace. Ketika cluster tidak memiliki tablespace tambahan,
seluruh database akan ditempatkan di direktori target. Jika cluster berisi
tablespace tambahan, direktori data utama akan ditempatkan di target
direktori, tetapi semua tablespace lainnya akan ditempatkan di jalur absolut yang sama dengan
mereka miliki di server.

Ini adalah format default.

t
ter
Tulis output sebagai file tar di direktori target. Direktori data utama
akan ditulis ke file bernama base.tar, dan semua tablespace lainnya akan diberi nama
setelah tablespace OID.

Jika nilai - (tanda hubung) ditetapkan sebagai direktori target, konten tar akan menjadi
ditulis ke output standar, cocok untuk pemipaan misalnya gzip. Hanya ini
mungkin jika cluster tidak memiliki tablespace tambahan.

-r tarif
--tingkat maksimum=tarif
Kecepatan transfer maksimum data yang ditransfer dari server. Nilai dalam kilobyte
per detik. Gunakan akhiran M untuk menunjukkan megabyte per detik. Akhiran k juga
diterima, dan tidak berpengaruh. Nilai yang valid adalah antara 32 kilobyte per detik dan 1024
megabyte per detik.

Tujuannya adalah untuk membatasi dampak pg_basebackup pada server yang sedang berjalan.

Opsi ini selalu mempengaruhi transfer direktori data. Transfer file WAL adalah
hanya terpengaruh jika metode pengumpulan diambil.

-R
--tulis-pemulihan-conf
Tulis recovery.conf minimal di direktori output (atau ke dalam file arsip dasar
saat menggunakan format tar) untuk memudahkan pengaturan server siaga.

-T olddir=direktori baru
--pemetaan tablespace=olddir=direktori baru
Pindahkan tablespace di direktori olddir untuk direktori baru selama pencadangan. Menjadi
efektif, olddir harus sama persis dengan spesifikasi jalur tablespace sebagaimana adanya
saat ini didefinisikan. (Tapi itu bukan kesalahan jika tidak ada tablespace di olddir
terkandung dalam cadangan.) Keduanya olddir dan direktori baru harus jalur absolut. Jika sebuah jalan
kebetulan mengandung tanda =, hindari dengan garis miring terbalik. Opsi ini dapat ditentukan
beberapa kali untuk beberapa tablespace. Lihat contoh di bawah.

Jika tablespace dipindahkan dengan cara ini, tautan simbolik di dalam data utama
direktori diperbarui untuk menunjuk ke lokasi baru. Jadi direktori data baru sudah siap
untuk digunakan untuk instance server baru dengan semua tablespace di lokasi yang diperbarui.

--xlogdir=xlogdir
Menentukan lokasi untuk direktori log transaksi. xlogdir harus mutlak
jalur. Direktori log transaksi hanya dapat ditentukan saat cadangannya polos
mode.

-x
--xlog
Menggunakan opsi ini sama dengan menggunakan -X dengan metode fetch.

-X metode
--xlog-metode=metode
Termasuk file log transaksi yang diperlukan (file WAL) dalam cadangan. Ini akan
sertakan semua log transaksi yang dihasilkan selama pencadangan. Jika opsi ini ditentukan,
dimungkinkan untuk memulai postmaster langsung di direktori yang diekstraksi tanpa
perlu berkonsultasi dengan arsip log, sehingga menjadikannya sebagai cadangan yang sepenuhnya mandiri.

Metode berikut untuk mengumpulkan log transaksi didukung:

f
mengambil
File log transaksi dikumpulkan di akhir pencadangan. Oleh karena itu,
diperlukan agar parameter wal_keep_segments disetel cukup tinggi sehingga log
tidak dihapus sebelum akhir pencadangan. Jika log telah diputar saat itu
waktu untuk mentransfernya, cadangan akan gagal dan tidak dapat digunakan.

s
aliran
Streaming log transaksi saat cadangan dibuat. Ini akan terbuka sebentar
koneksi ke server dan mulai streaming log transaksi secara paralel sambil
menjalankan cadangan. Oleh karena itu, ini akan menggunakan dua koneksi yang dikonfigurasi oleh
parameter max_wal_senders. Selama klien dapat mengikuti log transaksi
diterima, menggunakan mode ini tidak memerlukan log transaksi tambahan untuk disimpan di
menguasai.

-z
--gzip
Mengaktifkan kompresi gzip dari keluaran file tar, dengan tingkat kompresi default.
Kompresi hanya tersedia saat menggunakan format tar.

-Z tingkat
--kompres=tingkat
Mengaktifkan kompresi gzip dari keluaran file tar, dan menentukan tingkat kompresi (1
melalui 9, 9 menjadi kompresi terbaik). Kompresi hanya tersedia saat menggunakan tar
Format.

Opsi baris perintah berikut mengontrol pembuatan cadangan dan menjalankan
program.

-c cepat|menyebar
--pos pemeriksaan=cepat|menyebar
Menyetel mode pos pemeriksaan ke cepat atau menyebar (default) (lihat Bagian 24.3.3, “Membuat Basis
Cadangkan Menggunakan API Tingkat Rendah”, dalam dokumentasi).

-l label
--label=label
Menetapkan label untuk cadangan. Jika tidak ada yang ditentukan, nilai default “pg_basebackup
cadangan dasar” akan digunakan.

-P
--kemajuan
Mengaktifkan pelaporan kemajuan. Mengaktifkan ini akan memberikan perkiraan kemajuan
laporan selama pencadangan. Karena database dapat berubah selama pencadangan, ini adalah
hanya perkiraan dan mungkin tidak berakhir tepat 100%. Khususnya, ketika log WAL adalah
termasuk dalam cadangan, jumlah total data tidak dapat diperkirakan sebelumnya, dan
dalam hal ini perkiraan ukuran target akan meningkat setelah melewati perkiraan total
tanpa WA.

Saat ini diaktifkan, pencadangan akan dimulai dengan menghitung ukuran keseluruhan
database, dan kemudian kembali dan mengirim konten yang sebenarnya. Ini dapat membuat pencadangan berlangsung
sedikit lebih lama, dan khususnya akan memakan waktu lebih lama sebelum data pertama dikirim.

-v
--bertele-tele
Mengaktifkan mode verbose. Akan menampilkan beberapa langkah tambahan selama startup dan shutdown, seperti
serta tunjukkan nama file persis yang sedang diproses jika ada kemajuan
pelaporan juga diaktifkan.

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_basebackup tidak terhubung ke database tertentu di cluster,
nama database dalam string koneksi akan diabaikan.

-h tuan rumah
--tuan rumah=tuan rumah
Menentukan nama host dari mesin yang menjalankan server. Jika nilai
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.

-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.

-s selang
--interval status=selang
Menentukan jumlah detik antara paket status yang dikirim kembali ke server. Ini
memungkinkan pemantauan kemajuan yang lebih mudah dari server. Nilai nol menonaktifkan
pembaruan status berkala sepenuhnya, meskipun pembaruan akan tetap dikirim ketika
diminta oleh server, untuk menghindari pemutusan batas waktu. Nilai default adalah 10 detik.

-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_basebackup untuk meminta kata sandi sebelum menghubungkan ke database.

Opsi ini tidak pernah penting, karena pg_basebackup akan secara otomatis meminta a
kata sandi jika server meminta otentikasi kata sandi. Namun, pg_basebackup akan
buang upaya koneksi untuk mengetahui bahwa server menginginkan kata sandi. Dalam beberapa kasus
itu layak untuk diketik -W untuk menghindari upaya koneksi ekstra.

Pilihan lain juga tersedia:

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

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

LINGKUNGAN

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

CATATAN

Cadangan akan mencakup semua file di direktori data dan tablespace, termasuk:
file konfigurasi dan file tambahan apa pun yang ditempatkan di direktori oleh pihak ketiga. Tetapi
hanya file dan direktori biasa yang disalin. Tautan simbolis (selain yang digunakan untuk
tablespace) dan file perangkat khusus dilewati. (Lihat Bagian 50.3, “Streaming
Protokol Replikasi”, dalam dokumentasi untuk detail yang tepat.)

Ruang tabel akan dalam format biasa secara default dicadangkan ke jalur yang sama dengan yang mereka miliki di
server, kecuali opsi --tablespace-mapping digunakan. Tanpa opsi ini, menjalankan a
pencadangan basis format biasa pada host yang sama dengan server tidak akan berfungsi jika tablespaces
sedang digunakan, karena cadangan harus ditulis ke lokasi direktori yang sama dengan
tablespace asli.

Saat mode format tar digunakan, pengguna bertanggung jawab untuk membongkar setiap file tar
sebelum memulai server PostgreSQL. Jika ada tablespace tambahan, file tar
bagi mereka harus dibongkar di lokasi yang benar. Dalam hal ini tautan simbolik untuk
tablespace tersebut akan dibuat oleh server sesuai dengan isi dari
file tablespace_map yang disertakan dalam file base.tar.

pg_basebackup bekerja dengan server dengan versi utama yang sama atau lebih lama, hingga 9.1.
Namun, mode streaming WAL (-X stream) hanya berfungsi dengan server versi 9.3 dan yang lebih baru, dan
mode format tar (--format=tar) dari versi saat ini hanya berfungsi dengan server versi 9.5
atau nanti.

CONTOH

Untuk membuat cadangan dasar server di mydbserver dan menyimpannya di direktori lokal
/usr/lokal/pgsql/data:

$ pg_basebackup -h serverd saya -D /usr/local/pgsql/data

Untuk membuat cadangan server lokal dengan satu file tar terkompresi untuk setiap tablespace,
dan simpan di cadangan direktori, menunjukkan laporan kemajuan saat menjalankan:

$ pg_basebackup -D backup -Ft -z -P

Untuk membuat cadangan dari database lokal satu tablespace dan mengompresnya dengan bzip2:

$ pg_basebackup -D - -Ft | bzip2 > cadangan.tar.bz2

(Perintah ini akan gagal jika ada beberapa tablespace dalam database.)

Untuk membuat cadangan database lokal tempat tablespace di /opt/ts dipindahkan ke
./cadangan/ts:

$ pg_basebackup -D cadangan/data -T /opt/ts=$(pwd)/cadangan/ts

Gunakan pg_basebackup online menggunakan layanan onworks.net