pg_receivexlog - Online di Cloud

PROGRAM:

NAMA

pg_receivexlog - streaming log transaksi dari server PostgreSQL

RINGKASAN

pg_receivexlog [Option...]

DESKRIPSI

pg_receivexlog digunakan untuk mengalirkan log transaksi dari cluster PostgreSQL yang sedang berjalan.
Log transaksi dialirkan menggunakan protokol replikasi streaming, dan ditulis
ke direktori lokal file. Direktori ini dapat digunakan sebagai lokasi arsip untuk
melakukan pemulihan menggunakan pemulihan point-in-time (lihat Bagian 24.3, “Pengarsipan Berkelanjutan dan
Pemulihan Point-in-Time (PITR)”, dalam dokumentasi).

pg_receivexlog mengalirkan log transaksi secara real time saat dibuat di
server, dan tidak menunggu segmen selesai seperti yang dilakukan archive_command. Untuk ini
alasannya, tidak perlu mengatur archive_timeout saat menggunakan pg_receivexlog.

Tidak seperti penerima WAL dari server siaga PostgreSQL, pg_receivexlog secara default memerah
Data WAL hanya jika file WAL ditutup. Pilihan --sinkronis harus ditentukan untuk
menyiram data WAL secara real time.

Log transaksi dialirkan melalui koneksi PostgreSQL biasa dan menggunakan
protokol replikasi. Koneksi harus dilakukan dengan superuser atau pengguna yang memiliki
Izin REPLICASI (lihat Bagian 20.2, “Atribut Peran”, dalam dokumentasi), dan
pg_hba.conf harus mengizinkan koneksi replikasi. Server juga harus dikonfigurasi
dengan max_wal_senders disetel cukup tinggi untuk menyisakan setidaknya satu sesi yang tersedia untuk
aliran.

Jika koneksi terputus, atau jika awalnya tidak dapat dibuat, dengan non-fatal
kesalahan, pg_receivexlog akan mencoba kembali koneksi tanpa batas, dan memulai kembali streaming sebagai
secepatnya. Untuk menghindari perilaku ini, gunakan parameter -n.

PILIHAN

-D direktori
--direktori=direktori
Direktori untuk menulis output.

Parameter ini wajib diisi.

--jika-tidak-ada
Jangan sampai error saat --buat-slot ditentukan dan slot dengan yang ditentukan
nama sudah ada.

-n
--tidak ada putaran
Jangan mengulang kesalahan koneksi. Sebaliknya, keluar segera dengan kesalahan.

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

-S nama slot
--slot=nama slot
Mewajibkan pg_receivexlog untuk menggunakan slot replikasi yang ada (lihat Bagian 25.2.6,
"Slot Replikasi", dalam dokumentasi). Saat opsi ini digunakan, pg_receivexlog
akan melaporkan posisi flush ke server, yang menunjukkan kapan setiap segmen telah
disinkronkan ke disk sehingga server dapat menghapus segmen itu jika bukan sebaliknya
dibutuhkan.

Ketika klien replikasi pg_receivexlog dikonfigurasi di server sebagai
siaga sinkron, kemudian menggunakan slot replikasi akan melaporkan posisi flush ke
server, tetapi hanya ketika file WAL ditutup. Oleh karena itu, konfigurasi itu akan
menyebabkan transaksi di primer menunggu lama dan efektif tidak berfungsi
memuaskan. Opsi --synchronous (lihat di bawah) harus ditentukan sebagai tambahan untuk
membuat ini bekerja dengan benar.

--sinkronis
Siram data WAL ke disk segera setelah diterima. Kirim juga statusnya
paket kembali ke server segera setelah pembilasan, terlepas dari --status-interval.

Opsi ini harus ditentukan jika klien replikasi pg_receivexlog adalah
dikonfigurasi di server sebagai siaga sinkron, untuk memastikan bahwa umpan balik tepat waktu
dikirim ke server.

-v
--bertele-tele
Mengaktifkan mode verbose.

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

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

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

pg_receivexlog dapat melakukan salah satu dari dua tindakan berikut untuk mengontrol fisik
slot replikasi:

--buat-slot
Buat slot replikasi fisik baru dengan nama yang ditentukan di --slot, lalu keluar.

--jatuhkan-slot
Jatuhkan slot replikasi dengan nama yang ditentukan dalam --slot, lalu keluar.

Pilihan lain juga tersedia:

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

-?
--membantu
Tampilkan bantuan tentang argumen baris perintah pg_receivexlog, 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

Saat menggunakan pg_receivexlog alih-alih archive_command sebagai metode pencadangan WAL utama, ini adalah
sangat disarankan untuk menggunakan slot replikasi. Jika tidak, server bebas untuk mendaur ulang atau
hapus file log transaksi sebelum dicadangkan, karena tidak ada
informasi, baik dari archive_command atau slot replikasi, tentang seberapa jauh WAL
aliran telah diarsipkan. Namun, perhatikan bahwa slot replikasi akan mengisi server
ruang disk jika penerima tidak mengikuti pengambilan data WAL.

CONTOH

Untuk melakukan streaming log transaksi dari server di mydbserver dan menyimpannya di lokal
direktori /usr/local/pgsql/arsip:

$ pg_receivexlog -h serverd saya -D /usr/local/pgsql/arsip

Gunakan pg_receivexlog online menggunakan layanan onworks.net