Mengubah Konfigurasi Pangkalan Data PostgreSQL dalam ServBay

ServBay menyediakan persekitaran pembangunan web tempatan yang berkuasa untuk para pembangun macOS, lengkap dengan PostgreSQL sebagai salah satu pangkalan data yang disertakan. Panduan ini menerangkan secara terperinci cara untuk mengubah tetapan konfigurasi PostgreSQL di ServBay, termasuk kaedah melalui antara muka UI (paling disyorkan) serta penyuntingan manual fail konfigurasi untuk tujuan sementara atau lanjutan.

Bergantung pada versi PostgreSQL yang dipasang dalam ServBay, fail-fail konfigurasi utama biasanya terletak dalam direktori /Applications/ServBay/etc/postgresql/<version>, contohnya untuk PostgreSQL 16, laluan fail konfigurasinya ialah /Applications/ServBay/etc/postgresql/16.

Nota Penting

Sebahagian besar tetapan konfigurasi dalam ServBay diuruskan melalui antara muka grafik pengguna (UI) dan fail konfigurasi dijana secara automatik. Sangat disyorkan untuk melakukan pengubahsuaian melalui UI ServBay. Pengeditan manual mungkin akan ditindih apabila ServBay mengurus atau mengemas kini konfigurasi seterusnya. Kaedah manual hanya sesuai untuk ujian sementara atau pengguna lanjutan yang faham akan konfigurasi asas dan tidak digalakkan bagi tetapan jangka panjang atau dalam persekitaran pengeluaran.

Mengubah Konfigurasi Melalui UI ServBay (Disyorkan)

ServBay menawarkan antara muka grafik yang mesra pengguna — cara paling mudah dan disyorkan untuk mengubah konfigurasi PostgreSQL. Sebarang perubahan melalui UI ini biasanya diterapkan serta-merta tanpa perlu memulakan semula servis (kecuali jika diminta oleh ServBay).

Langkah-langkah

1. Buka aplikasi ServBay.
2. Pada bar navigasi kiri, pilih Database.
3. Dalam senarai pangkalan data, cari PostgreSQL, kemudian klik pada versi yang ingin dikonfigurasi.
4. Setelah masuk ke paparan konfigurasi PostgreSQL, anda akan dapat melihat maklumat terperinci serta pilihan tetapan bagi versi berkenaan.

Pilihan Konfigurasi

Di paparan ini, anda boleh melihat nama pengguna dan kata laluan PostgreSQL lalai yang ditetapkan oleh ServBay (biasanya dipaparkan di halaman tersebut). Anda juga boleh mengubah beberapa parameter lazim secara terus:

• Alamat Pendengaran (listen_addresses): Menentukan antara muka rangkaian yang didengari oleh PostgreSQL. Nilai lalai biasanya *, bermakna semua antara muka didengari.
• Port (port): Port rangkaian yang digunakan oleh servis PostgreSQL. Port lalai ialah 5432 (berbeza dari MySQL/MariaDB yang menggunakan 3306).
• Bilangan Maksimum Sambungan (max_connections): Mengehadkan jumlah maksimum klien yang boleh menyambung ke pangkalan data pada satu masa.
• Memori Kerja (work_mem): Had memori bagi setiap proses pertanyaan semasa operasi penapisan atau jadual hash.

Selain itu, anda boleh menambah atau mengubah parameter tambahan lain daripada postgresql.conf yang tidak tersenarai terus di UI melalui bahagian Additional Parameters. Setiap parameter perlu dimasukkan pada satu baris dengan format nama_parameter = nilai.

Menggunakan Perubahan

Setelah selesai mengubah tetapan, klik butang Simpan di bahagian bawah paparan. ServBay akan terus menerapkan perubahan anda. Untuk kebanyakan tetapan, perubahan ini akan berkuatkuasa serta-merta. Dalam beberapa kes yang jarang berlaku, servis PostgreSQL mungkin perlu dimulakan semula — makluman akan diberi jika perlu.

Mengubah Konfigurasi Secara Manual (Tidak Disyorkan untuk Jangka Panjang)

Seperti yang dinyatakan, pengeditan manual fail konfigurasi tidak diutamakan untuk pengurusan harian kerana perubahan anda boleh ditindih oleh UI ServBay. Namun memahami lokasi fail serta kandungannya dapat membantu anda mendalami tahap konfigurasi PostgreSQL.

WARNING

Pengeditan fail konfigurasi hanya sesuai untuk tujuan penyahpepijatan sementara atau analisis lanjutan. ServBay amat menyarankan anda menggunakan UI untuk membuat perubahan bagi memastikan tetapan kekal dan konsisten. Fail dan laluan yang anda ubah secara manual boleh dikembalikan ke asal bergantung kepada mekanisme dalaman ServBay.

Lokasi Fail Konfigurasi

Fail konfigurasi utama PostgreSQL dalam ServBay ialah postgresql.conf dan pg_hba.conf. Lokasi fail bergantung pada versi dan secara umum ialah:

• postgresql.conf: /Applications/ServBay/etc/postgresql/<version>/postgresql.conf
• pg_hba.conf: /Applications/ServBay/etc/postgresql/<version>/pg_hba.conf

Perlu diingat bahawa laluan seperti /db/postgresql/16/pg_hba.conf mungkin digunakan ServBay untuk pengurusan dalaman atau versi lama, namun UI ServBay kini mengurus konfigurasi di bawah /Applications/ServBay/etc. Jika anda ingin membuat pengeditan manual, pastikan anda menyunting fail pada laluan yang betul. Untuk konsistensi dengan pengurusan ServBay, direktori /Applications/ServBay/etc/postgresql/<version> adalah tempat simpanan konfigurasi yang paling relevan.

Contoh Pilihan Konfigurasi

Berikut beberapa parameter biasa yang terdapat dalam postgresql.conf dan pg_hba.conf. Sila gunakan editor teks (seperti VS Code, Sublime Text, Nano, dsb.) dengan hak pentadbir untuk menyunting fail.

postgresql.conf

postgresql.conf ialah fail utama yang mengawal pelbagai aspek operasi pelayan PostgreSQL.

# Alamat pendengaran: antara muka rangkaian yang akan didengari oleh pelayan. '*' bermaksud semua.
listen_addresses = '*'

# Nombor port: port rangkaian yang didengari pelayan. Piawaian PostgreSQL ialah 5432.
port = 5432

# Bilangan maksimum sambungan: jumlah maksimum klien yang boleh menyambung serentak.
max_connections = 100

# Saiz penimbal bersama: jumlah memori berkongsi untuk penimbal data dalam PostgreSQL.
shared_buffers = 128MB

# Direktori log: lokasi untuk simpanan fail log.
log_directory = 'log'

# Format nama fail log: cara penamaan fail log.
log_filename = 'postgresql-%Y-%m-%d.log'

# Log kueri perlahan: rekod pertanyaan yang melebihi masa tertentu (dalam milisaat).
# Isi dengan integer positif, contoh 2000 bermaksud log kueri lebih 2 saat.
# Nilai -1 menutup log kueri perlahan.
log_min_duration_statement = 2000

pg_hba.conf

Fail pg_hba.conf (Host-Based Authentication) digunakan untuk menetapkan kaedah dan keizinan autentikasi klien menyambung ke PostgreSQL.

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# Benarkan sambungan tempatan melalui Unix socket, dengan kaedah 'trust' (tidak perlukan kata laluan).
# "local" is for Unix domain socket connections only
local   all             all                                     trust

# Benarkan semua alamat IPv4 menyambung secara jauh, menggunakan autentikasi kata laluan 'md5'.
# IPv4 local connections:
host    all             all             0.0.0.0/0               md5

# Benarkan subnet IPv4 tertentu (cth: rangkaian 192.168.1.0/24) menyambung menggunakan 'md5'.
# Sambungan IPv4 dari subnet tertentu:
# host    all             all             192.168.1.0/24          md5

Sewaktu menyunting pg_hba.conf, pastikan anda memahami maksud setiap lajur (TYPE, DATABASE, USER, ADDRESS, METHOD). Konfigurasi yang salah boleh menyebabkan Anda gagal bersambung ke pangkalan data atau menyebabkan masalah keselamatan.

Menggunakan Perubahan Manual

Selepas anda mengubah fail konfigurasi secara manual, anda perlu memulakan semula servis PostgreSQL agar perubahan berkuatkuasa.

Memulakan Semula melalui UI ServBay

1. Buka antara muka pengurusan ServBay.
2. Di navigasi kiri, pilih Database.
3. Cari PostgreSQL dan klik pada versi berkaitan.
4. Pada halaman ini atau dalam senarai "Perisian/Perkhidmatan" utama ServBay, cari servis PostgreSQL untuk versi tersebut dan klik butang Restart.

Memulakan Semula dengan Arahan servbayctl

Gunakan alat arahan servbayctl dari ServBay untuk mengurus servis — termasuk memulakan semula PostgreSQL:

servbayctl restart postgresql <version>

Gantikan <version> dengan nombor versi PostgreSQL yang anda gunakan, contohnya 16.

Ringkasan

ServBay menyediakan antara muka UI mesra pengguna sebagai kaedah utama dan disyorkan untuk mengubah konfigurasi PostgreSQL, mengelakkan risiko perubahan manual ditindih. Anda boleh mengubah alamat pendengaran, port, bilangan sambungan, dan melihat maklumat log masuk pangkalan data lalai melalui UI. Untuk tujuan tertentu seperti penyahpepijatan, fail utama konfigurasi postgresql.conf dan pg_hba.conf terletak di /Applications/ServBay/etc/postgresql/<version>. Selepas pengubahsuaian, kebiasaannya servis PostgreSQL perlu dimulakan semula dan tindakan ini boleh dilakukan melalui UI ServBay atau alat perintah servbayctl.

Memahami pilihan tetapan dan kaedah mengubahnya akan membantu anda melaras persekitaran pangkalan data PostgreSQL dalam ServBay mengikut keperluan pembangunan anda.