pgbouncer - Dalam talian di Awan

JADUAL:

NAMA

pgbouncer - pengumpul sambungan ringan untuk PostgreSQL

SINOPSIS

pgbouncer [-d][-R][-v][-u pengguna]
pgbouncer -V|-h

Pada komputer Windows, pilihannya ialah:

pgbouncer.exe [-v][-u pengguna]
pgbouncer.exe -V|-h

Pilihan tambahan untuk menyediakan perkhidmatan Windows:

pgbouncer.exe --regservice
pgbouncer.exe --unregservice

DESCRIPTION

pgbouncer ialah pengumpul sambungan PostgreSQL. Sebarang aplikasi sasaran boleh disambungkan
pgbouncer seolah-olah ia adalah pelayan PostgreSQL, dan pgbouncer akan membuat sambungan ke
pelayan sebenar, atau ia akan menggunakan semula salah satu sambungan sedia ada.

Tujuan pgbouncer adalah untuk mengurangkan kesan prestasi membuka sambungan baharu kepada
PostgreSQL.

Untuk tidak menjejaskan semantik transaksi untuk pengumpulan sambungan, pgbouncer
menyokong beberapa jenis pengumpulan apabila sambungan berputar:

Sesi pengumpulan
Kaedah paling sopan. Apabila pelanggan menyambung, sambungan pelayan akan diberikan kepada
ia sepanjang tempoh pelanggan kekal berhubung. Apabila pelanggan memutuskan sambungan,
sambungan pelayan akan dimasukkan semula ke dalam kolam. Ini adalah kaedah lalai.

Transaksi pengumpulan
Sambungan pelayan diberikan kepada pelanggan hanya semasa transaksi. Bila
PgBouncer menyedari bahawa transaksi telah tamat, sambungan pelayan akan diletakkan semula
ke dalam kolam.

Penyata pengumpulan
Kaedah yang paling agresif. Sambungan pelayan akan dimasukkan semula ke dalam pool
serta-merta selepas pertanyaan selesai. Urus niaga berbilang penyata tidak dibenarkan masuk
mod ini kerana mereka akan pecah.

Antara muka pentadbiran bagi pgbouncer terdiri daripada beberapa yang baru SHOW arahan tersedia
apabila disambungkan ke pangkalan data 'maya' khas pgbouncer.

PERMULAAN PANTAS

Persediaan asas dan penggunaan seperti berikut.

1. Cipta fail pgbouncer.ini. Butiran dalam pgbouncer(5). Contoh mudah:

[pangkalan data]
template1 = hos=127.0.0.1 port=5432 dbname=template1

[pgbouncer]
listen_port = 6543
listen_addr = 127.0.0.1
jenis_auth = md5
fail_auth = pengguna.txt
fail log = pgbouncer.log
pidfile = pgbouncer.pid
admin_users = sesetengah pengguna

2. Buat users.txt fail yang mengandungi pengguna yang dibenarkan dalam:

"sesetengah pengguna" "sama_kata laluan_seperti_dalam_pelayan"

3. Pelancaran pgbouncer:

$ pgbouncer -d pgbouncer.ini

4. Minta permohonan anda (atau psql pelanggan) menyambung kepada pgbouncer bukannya terus ke
Pelayan PostgreSQL:

$ psql -p 6543 -U someuser template1

5. Urus pgbouncer dengan menyambung ke pangkalan data pentadbiran khas pgbouncer and
mengeluarkan Menunjukkan bantuan; untuk memulakan:

$ psql -p 6543 -U someuser pgbouncer
pgbouncer=# tunjukkan bantuan;
NOTIS: Penggunaan konsol
BUTIRAN:
TUNJUKKAN [BANTUAN|CONFIG|PANGKALAN DATA|FDS|POOL|PELANGGAN|PELAYANG|SOKET|SENARAI|VERSI]
Kunci SET = arg
Reload
PAUSE
GANTUNG
RESUME
SHUTDOWN

6. Jika anda membuat perubahan pada fail pgbouncer.ini, anda boleh memuatkannya semula dengan:

pgbouncer=# MUAT SEMULA;

COMMAND LINE PAKAIAN

-d Jalankan di latar belakang. Tanpa itu proses akan berjalan di latar depan. Nota: Tidak
bekerja pada Windows, pgbouncer perlu dijalankan sebagai perkhidmatan di sana.

-R Lakukan permulaan semula dalam talian. Ini bermakna menyambung kepada proses yang sedang berjalan, memuatkan
buka soket daripadanya, dan kemudian gunakannya. Jika tiada proses aktif, but
biasalah. Nota: Berfungsi hanya jika OS menyokong soket Unix dan unix_socket_dir is
tidak dilumpuhkan dalam konfigurasi. Tidak berfungsi pada mesin Windows. Tidak berfungsi dengan TLS
sambungan, mereka digugurkan.

-u pengguna
Beralih kepada pengguna yang diberikan semasa permulaan.

-v Tingkatkan verbositi. Boleh digunakan beberapa kali.

-q Diam - jangan log masuk ke stdout. Ambil perhatian bahawa ini tidak menjejaskan verbositi pembalakan, sahaja
stdout itu tidak boleh digunakan. Untuk digunakan dalam skrip init.d.

-V Tunjukkan versi.

-h Tunjukkan bantuan singkat.

--regservice
Win32: Daftar pgbouncer untuk dijalankan sebagai perkhidmatan Windows. The nama_perkhidmatan config
nilai parameter digunakan sebagai nama untuk mendaftar di bawah.

--nyahregi perkhidmatan
Win32: Nyahdaftar perkhidmatan Windows.

ADMIN CONSOLE

Konsol tersedia dengan menyambung seperti biasa ke pangkalan data pgbouncer:

$ psql -p 6543 pgbouncer

Hanya pengguna yang disenaraikan dalam parameter konfigurasi admin_users or statistik_pengguna dibenarkan untuk
log masuk ke konsol. (Kecuali apabila auth_mode=mana-mana, maka mana-mana pengguna dibenarkan masuk sebagai a
stats_user.)

Selain itu, nama pengguna pgbouncer dibenarkan untuk log masuk tanpa kata laluan, jika log masuk
datang melalui soket Unix dan pelanggan mempunyai uid pengguna Unix yang sama seperti proses yang sedang berjalan.

Tunjuk arahan
. SHOW arahan output maklumat. Setiap arahan diterangkan di bawah.

SHOW STAT;
Menunjukkan statistik.

pangkalan data
Statistik dibentangkan setiap pangkalan data.

jumlah_permintaan
Jumlah bilangan permintaan SQL dikumpulkan oleh pgbouncer.

total_received
Jumlah volum dalam bait trafik rangkaian yang diterima oleh pgbouncer.

jumlah_hantar
Jumlah volum dalam bait trafik rangkaian yang dihantar oleh pgbouncer.

total_query_time
Jumlah bilangan mikrosaat yang dibelanjakan oleh pgbouncer apabila disambungkan secara aktif
PostgreSQL.

avg_req
Purata permintaan sesaat dalam tempoh statistik terakhir.

avg_recv
Purata yang diterima (daripada pelanggan) bait sesaat.

avg_sent
Purata bait yang dihantar (kepada pelanggan) sesaat.

avg_query
Purata tempoh pertanyaan dalam mikrosaat.

SHOW PELAYAN;
jenis S, untuk pelayan.

pengguna Nama pengguna pgbouncer digunakan untuk menyambung ke pelayan.

pangkalan data
Nama pangkalan data.

adalah Keadaan sambungan pelayan pgbouncer, salah satu daripada aktif, digunakan or terbiar.

addr Alamat IP pelayan PostgreSQL.

pelabuhan Pelabuhan pelayan PostgreSQL.

local_addr
Alamat mula sambungan pada mesin tempatan.

local_port
Port permulaan sambungan pada mesin tempatan.

connect_time
Apabila sambungan dibuat.

masa_permintaan
Apabila permintaan terakhir dikeluarkan.

ptr Alamat objek dalaman untuk sambungan ini. Digunakan sebagai ID unik.

pautan Alamat sambungan klien yang dipasangkan dengan pelayan.

remote_pid
Pid proses pelayan bahagian belakang. Sekiranya sambungan dibuat melalui soket unix dan OS
menyokong mendapatkan maklumat ID proses, ia adalah pid OS. Jika tidak ia diekstrak daripada
batalkan pelayan paket dihantar, yang sepatutnya PID sekiranya pelayan adalah Postgres, tetapi ia
nombor rawak sekiranya pelayan itu PgBouncer yang lain.

SHOW PELANGGAN;
jenis C, untuk pelanggan.

pengguna Pengguna yang disambungkan pelanggan.

pangkalan data
Nama pangkalan data.

adalah Keadaan sambungan pelanggan, salah satu daripada aktif, digunakan, menunggu or terbiar.

addr Alamat IP pelanggan.

pelabuhan Pelanggan port disambungkan ke.

local_addr
Alamat tamat sambungan pada mesin tempatan.

local_port
Port hujung sambungan pada mesin tempatan.

connect_time
Cap masa masa sambungan.

masa_permintaan
Cap masa permintaan pelanggan terkini.

ptr Alamat objek dalaman untuk sambungan ini. Digunakan sebagai ID unik.

pautan Alamat sambungan pelayan yang dipasangkan dengan pelanggan.

remote_pid
ID Proses, sekiranya pelanggan menyambung melalui soket UNIX dan OS menyokong mendapatkannya.

SHOW KOLAM;
Entri kumpulan baharu dibuat untuk setiap pasangan (pangkalan data, pengguna).

pangkalan data
Nama pangkalan data.

pengguna Nama pengguna.

cl_active
Sambungan pelanggan yang dipautkan kepada sambungan pelayan dan boleh memproses pertanyaan.

cl_waiting
Sambungan pelanggan telah menghantar pertanyaan tetapi belum mendapat sambungan pelayan.

sv_aktif
Sambungan pelayan yang dipautkan kepada klien.

sv_idle
Sambungan pelayan yang tidak digunakan dan boleh digunakan serta-merta untuk pertanyaan pelanggan.

sv_used
Sambungan pelayan yang telah melahu lebih daripada server_check_delay, jadi mereka perlukan
server_check_query untuk berjalan di atasnya sebelum ia boleh digunakan.

sv_tested
Sambungan pelayan yang sedang berjalan sama ada server_reset_query or
server_check_query.

sv_login
Sambungan pelayan sedang dalam proses log masuk.

maxwait
Berapa lama pelanggan pertama (tertua) dalam baris gilir menunggu, dalam beberapa saat. Jika ini bermula
meningkat, maka kumpulan pelayan semasa tidak mengendalikan permintaan dengan cukup pantas.
Sebabnya mungkin sama ada pelayan terlebih beban atau terlalu kecil daripada a saiz_kolam penetapan.

mod_kolam
Mod pengumpulan sedang digunakan.

SHOW SENARAI;
Tunjukkan maklumat dalaman berikut, dalam lajur (bukan baris):

pangkalan data
Bilangan pangkalan data.

pengguna Bilangan pengguna.

kolam Bilangan kolam.

free_clients
Bilangan pelanggan percuma.

digunakan_pelanggan
Bilangan pelanggan terpakai.

login_clients
Bilangan pelanggan dalam log masuk negeri.

free_servers
Bilangan pelayan percuma.

digunakan_pelayan
Bilangan pelayan yang digunakan.

SHOW PENGGUNA;
nama Nama pengguna

mod_kolam
Pengguna menimpa pool_mode, atau NULL jika lalai akan digunakan sebaliknya.

SHOW PANGKALAN DATA;
nama Nama kemasukan pangkalan data yang dikonfigurasikan.

tuan rumah Hos pgbouncer bersambung ke.

pelabuhan Port pgbouncer bersambung ke.

pangkalan data
Nama pangkalan data sebenar pgbouncer bersambung ke.

paksa_pengguna
Apabila pengguna adalah sebahagian daripada rentetan sambungan, sambungan antara pgbouncer dan
PostgreSQL dipaksa kepada pengguna yang diberikan, tidak kira pengguna klien.

saiz_kolam
Bilangan maksimum sambungan pelayan.

mod_kolam
Pangkalan data mengatasi pool_mode, atau NULL jika lalai akan digunakan sebaliknya.

SHOW FDS;
Perintah dalaman - menunjukkan senarai fd yang digunakan dengan keadaan dalaman yang dilampirkan padanya.

Apabila pengguna yang disambungkan mempunyai nama pengguna "pgbouncer", menyambung melalui soket Unix dan mempunyai
UID yang sama seperti proses yang sedang berjalan, fd sebenar dihantar melalui sambungan. ini
mekanisme digunakan untuk melakukan restart dalam talian. Nota: Ini tidak berfungsi pada mesin Windows.

Perintah ini juga menyekat gelung acara dalaman, jadi ia tidak boleh digunakan semasa PgBouncer
sedang digunakan.

fd Nilai angka deskriptor fail.

tugasan Salah satu pooler, pelanggan or server.

pengguna Pengguna sambungan menggunakan FD.

pangkalan data
Pangkalan data sambungan menggunakan FD.

addr Alamat IP sambungan menggunakan FD, unix jika soket unix digunakan.

pelabuhan Port yang digunakan oleh sambungan menggunakan FD.

membatalkan Batal kekunci untuk sambungan ini.

pautan fd untuk pelayan/pelanggan yang sepadan. NULL jika melahu.

SHOW KONFIG;
Tunjukkan tetapan konfigurasi semasa, satu setiap baris, dengan lajur berikut:

utama Nama pembolehubah konfigurasi

nilai Nilai konfigurasi

berubah
Sama ada yes or tidak, menunjukkan sama ada pembolehubah boleh diubah semasa berjalan. Jika tidak, yang
pembolehubah boleh ditukar hanya masa but.

SHOW DNS_HOSTS;
Tunjukkan nama hos dalam cache DNS.

nama hos
Nama hos.

ttl Berapa saat sehingga carian seterusnya.

addrs Senarai alamat dipisahkan koma.

SHOW DNS_ZONES
Tunjukkan zon DNS dalam cache.

nama zon
Nama zon.

siri Siri semasa.

mengira Nama hos kepunyaan zon ini.

Proses mengawal arahan
PAUSE [db];
PgBouncer cuba memutuskan sambungan daripada semua pelayan, mula-mula menunggu semua pertanyaan selesai.
Perintah tidak akan kembali sebelum semua pertanyaan selesai. Untuk digunakan pada masa
mulakan semula pangkalan data.

Jika nama pangkalan data diberikan, hanya pangkalan data itu akan dijeda.

HILANGKAN db;
Tolak semua sambungan pelanggan baharu pada pangkalan data yang diberikan.

ENABLE db;
Benarkan sambungan pelanggan baharu selepas sambungan sebelumnya HILANGKAN perintah.

BUNUH db;
Segera lepaskan semua sambungan pelanggan dan pelayan pada pangkalan data yang diberikan.

GANTUNG;
Semua penimbal soket disiram dan PgBouncer berhenti mendengar data mengenainya. The
arahan tidak akan kembali sebelum semua penimbal kosong. Untuk digunakan pada masa PgBouncer
but semula dalam talian.

RESUME [db];
Sambung semula kerja dari sebelumnya PAUSE or GANTUNG perintah.

MENUTUP;
Proses PgBouncer akan keluar.

TAMBAH NILAI;
Proses PgBouncer akan memuatkan semula fail konfigurasinya dan mengemas kini tetapan boleh tukar.

Isyarat
PENDAPATAN Muat semula konfigurasi. Sama seperti mengeluarkan arahan TAMBAH NILAI; pada konsol.

SIGINT Penutupan selamat. Sama seperti mengeluarkan JEDA; and MENUTUP; pada konsol.

TANDATANGAN
Penutupan segera. Sama seperti mengeluarkan MENUTUP; pada konsol.

Libevent tetapan
Daripada dokumen libevent:

Adalah mungkin untuk melumpuhkan sokongan untuk epoll, kqueue, devpoll, poll
atau pilih dengan menetapkan pembolehubah persekitaran EVENT_NOEPOLL,
EVENT_NOKQUEUE, EVENT_NODEVPOLL, EVENT_NOPOLL atau EVENT_NOSELECT,
masing-masing.

Dengan menetapkan pembolehubah persekitaran EVENT_SHOW_METHOD, libevent
memaparkan kaedah pemberitahuan kernel yang digunakan.

Gunakan pgbouncer dalam talian menggunakan perkhidmatan onworks.net