pg_ctl - Daring di Awan

PROGRAM:

NAMA

pg_ctl - menginisialisasi, memulai, menghentikan, atau mengontrol server PostgreSQL

RINGKASAN

hal_ctl init[db] [-s] [-D datadir] [-o initdb-opsi]

hal_ctl awal [-w] [-t detik] [-s] [-D datadir] [-l nama file] [-o Pilihan] [-p path] [-c]

hal_ctl berhenti [-W] [-t detik] [-s] [-D datadir] [-m pintar] | cepat] | segera]]

hal_ctl Restart [-w] [-t detik] [-s] [-D datadir] [-c]
[-m pintar] | cepat] | segera]] [-o Pilihan]

hal_ctl kembali [-s] [-D datadir]

hal_ctl status [-D datadir]

hal_ctl mendorong [-s] [-D datadir]

hal_ctl membunuh nama_sinyal proses_id

hal_ctl daftar [-N layani saya] [-U nama pengguna] [-P kata sandi] [-D datadir]
[-S mobil] | tuntutan]] [-w] [-t detik] [-s] [-o Pilihan]

hal_ctl batalkan registrasi [-N layani saya]

DESKRIPSI

pg_ctl adalah utilitas untuk menginisialisasi cluster database PostgreSQL, memulai, menghentikan, atau
memulai ulang server database PostgreSQL (postgres(1)), atau menampilkan status a
menjalankan server. Meskipun server dapat dimulai secara manual, pg_ctl merangkum tugas
seperti mengarahkan output log dan melepaskan dengan benar dari terminal dan grup proses.
Ini juga menyediakan opsi yang mudah untuk shutdown terkontrol.

init or initdb mode membuat cluster database PostgreSQL baru. Sebuah cluster database adalah
kumpulan database yang dikelola oleh satu instance server. Mode ini memanggil
itu initdb memerintah. Lihat initdb(1) untuk rincian.

In awal mode, server baru diluncurkan. Server dimulai di latar belakang, dan
input standar dilampirkan ke /dev/null (atau nul di Windows). Pada sistem mirip Unix, dengan
default, output standar server dan kesalahan standar dikirim ke standar pg_ctl
keluaran (bukan kesalahan standar). Output standar pg_ctl kemudian harus diarahkan ke a
file atau disalurkan ke proses lain seperti program rotasi log seperti rotatelogs; sebaliknya
postgres akan menulis outputnya ke terminal pengontrol (dari latar belakang) dan akan
tidak meninggalkan grup proses Shell. Di Windows, secara default output standar server
dan kesalahan standar dikirim ke terminal. Perilaku default ini dapat diubah dengan
menggunakan -l untuk menambahkan output server ke file log. Penggunaan keduanya -l atau keluaran
pengalihan dianjurkan.

In berhenti mode, server yang berjalan di direktori data yang ditentukan dimatikan.
Tiga metode shutdown yang berbeda dapat dipilih dengan -m pilihan. Mode "Cerdas" menunggu
untuk semua klien aktif untuk memutuskan sambungan dan pencadangan online apa pun untuk diselesaikan. Jika server dalam
siaga panas, pemulihan, dan replikasi streaming akan dihentikan setelah semua klien memiliki
terputus. Mode "Cepat" (default) tidak menunggu klien memutuskan sambungan dan akan
menghentikan pencadangan online yang sedang berlangsung. Semua transaksi aktif dibatalkan dan
klien terputus secara paksa, maka server dimatikan. Mode "Segera" akan
batalkan semua proses server segera, tanpa shutdown bersih. Ini akan menyebabkan
crash-recovery dijalankan pada restart berikutnya.

Restart mode secara efektif mengeksekusi stop diikuti oleh start. Hal ini memungkinkan mengubah
postgres opsi baris perintah. Restart mungkin gagal jika jalur relatif yang ditentukan adalah
ditentukan pada baris perintah selama server mulai.

kembali mode hanya mengirim postgres memproses sinyal SIGHUP, menyebabkannya membaca ulang
file konfigurasi (postgresql.conf, pg_hba.conf, dll.). Hal ini memungkinkan perubahan
opsi file konfigurasi yang tidak memerlukan restart lengkap untuk diterapkan.

status mode memeriksa apakah server berjalan di direktori data yang ditentukan. Jika memang,
PID dan opsi baris perintah yang digunakan untuk memanggilnya ditampilkan. jika
server tidak berjalan, proses mengembalikan status keluar 3. Jika data dapat diakses
direktori tidak ditentukan, proses mengembalikan status keluar 4.

In mendorong mode, server siaga yang berjalan di direktori data yang ditentukan adalah
diperintahkan untuk keluar dari pemulihan dan memulai operasi baca-tulis.

membunuh mode memungkinkan Anda mengirim sinyal ke proses tertentu. Ini terutama
berharga untuk Microsoft Windows yang tidak memiliki perintah kill. Gunakan --help untuk melihat
daftar nama sinyal yang didukung.

daftar mode memungkinkan Anda untuk mendaftarkan layanan sistem di Microsoft Windows. NS -S Option
memungkinkan pemilihan jenis mulai layanan, baik "otomatis" (mulai layanan secara otomatis pada
startup sistem) atau "permintaan" (mulai layanan sesuai permintaan).

batalkan registrasi mode memungkinkan Anda untuk membatalkan pendaftaran layanan sistem di Microsoft Windows. Ini
membatalkan efek dari daftar perintah.

PILIHAN

-c
--file-inti
Mencoba untuk mengizinkan server mogok untuk menghasilkan file inti, pada platform di mana ini
mungkin, dengan mengangkat batas sumber daya lunak apa pun yang ditempatkan pada file inti. Ini berguna dalam
men-debug atau mendiagnosis masalah dengan mengizinkan pelacakan tumpukan diperoleh dari a
proses server gagal.

-D datadir
--halaman data datadir
Menentukan lokasi sistem file dari file konfigurasi database. Jika ini adalah
dihilangkan, variabel lingkungan PGDATA digunakan.

-l nama file
--catatan nama file
Tambahkan output log server ke nama file. Jika file tidak ada, itu dibuat.
Umask disetel ke 077, jadi akses ke file log tidak diizinkan untuk pengguna lain dengan
standar.

-m mode
--mode mode
Menentukan mode shutdown. mode bisa pintar, cepat, atau langsung, atau yang pertama
surat dari salah satu dari ketiganya. Jika ini dihilangkan, cepat digunakan.

-o Pilihan
Menentukan opsi yang akan diteruskan langsung ke postgres memerintah; beberapa pilihan
doa ditambahkan.

Opsi biasanya harus dikelilingi oleh tanda kutip tunggal atau ganda untuk memastikan bahwa
mereka melewati sebagai sebuah kelompok.

-o initdb-opsi
Menentukan opsi yang akan diteruskan langsung ke initdb perintah.

Opsi biasanya harus dikelilingi oleh tanda kutip tunggal atau ganda untuk memastikan bahwa
mereka melewati sebagai sebuah kelompok.

-p path
Menentukan lokasi executable postgres. Secara default postgres dapat dieksekusi
diambil dari direktori yang sama dengan hal_ctl, atau gagal, yang terprogram
direktori instalasi. Tidak perlu menggunakan opsi ini kecuali Anda melakukannya
sesuatu yang tidak biasa dan mendapatkan kesalahan bahwa executable postgres tidak ditemukan.

Dalam mode init, opsi ini secara analog menentukan lokasi executable initdb.

-s
--diam
Cetak hanya kesalahan, tidak ada pesan informasi.

-t
--waktu habis
Jumlah maksimum detik untuk menunggu saat menunggu startup atau shutdown untuk
menyelesaikan. Default ke nilai PGCTLTIMEOUT variabel lingkungan atau, jika tidak
diatur, menjadi 60 detik.

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

-w
Tunggu hingga startup atau shutdown selesai. Menunggu adalah pilihan default untuk
shutdown, tapi bukan startup. Saat menunggu startup, hal_ctl berulang kali mencoba
terhubung ke server. Saat menunggu shutdown, hal_ctl menunggu server untuk
hapus file PID-nya. Opsi ini memungkinkan masuknya frasa sandi SSL saat startup.
hal_ctl mengembalikan kode keluar berdasarkan keberhasilan startup atau shutdown.

-W
Jangan menunggu startup atau shutdown selesai. Ini adalah default untuk memulai dan
mode mulai ulang.

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

Opsi untuk Windows
-e sumber
Nama sumber peristiwa untuk pg_ctl yang akan digunakan untuk masuk ke log peristiwa saat dijalankan
sebagai layanan Windows. Standarnya adalah PostgreSQL. Perhatikan bahwa ini hanya mengontrol
masuk dari pg_ctl itu sendiri; setelah dimulai, server akan menggunakan sumber acara
ditentukan oleh event_source. Jika server gagal selama startup awal, mungkin juga
log menggunakan sumber acara default PostgreSQL.

-N layani saya
Nama layanan sistem untuk mendaftar. Nama tersebut akan digunakan sebagai nama layanan
dan nama tampilan.

-P kata sandi
Kata sandi bagi pengguna untuk memulai layanan.

-S tipe awal
Mulai jenis layanan sistem untuk mendaftar. tipe awal dapat berupa otomatis, atau permintaan, atau
huruf pertama dari salah satu dari dua ini. Jika ini dihilangkan, otomatis digunakan.

-U nama pengguna
Nama pengguna untuk pengguna untuk memulai layanan. Untuk pengguna domain, gunakan format
DOMAIN\nama pengguna.

LINGKUNGAN

PGCTLTIMEOUT
Batas default pada jumlah detik untuk menunggu saat menunggu startup atau shutdown untuk
menyelesaikan. Jika tidak disetel, defaultnya adalah 60 detik.

PGDATA
Lokasi direktori data default.

hal_ctl, seperti kebanyakan utilitas PostgreSQL lainnya, juga menggunakan variabel lingkungan
didukung oleh libpq (lihat Bagian 31.14, “Variabel Lingkungan”, dalam dokumentasi). Untuk
variabel server tambahan, lihat postgres(1).

Gunakan pg_ctl online menggunakan layanan onworks.net