Mengkonfigurasi Tetapan Pangkalan Data MariaDB dalam ServBay

ServBay menyediakan persekitaran pembangunan web tempatan yang mantap untuk para pemaju, termasuk pangkalan data MariaDB yang sudah diintegrasikan dan mudah diurus. Dokumen ini akan menerangkan secara terperinci cara mengubah tetapan MariaDB dalam ServBay, dengan penekanan pada kaedah yang disyorkan melalui UI ServBay, serta menjelaskan peranan fail konfigurasi dan pilihan utama yang biasa digunakan.

Siapa patut membaca: Pemaju web yang menggunakan ServBay untuk pembangunan tempatan, terutamanya bagi pengguna yang perlu melaras tingkah laku MariaDB.

Pengenalan

Konfigurasi MariaDB menentukan cara pelayan pangkalan data beroperasi, termasuk tetapan sambungan rangkaian, had sambungan, saiz cache, pencatatan log, dan banyak lagi. Dalam ServBay, anda boleh dengan mudah melaraskan tetapan ini melalui antara muka grafik tanpa perlu menyunting fail konfigurasi yang rumit secara terus. Walaupun fail konfigurasi (seperti my.cnf) merupakan cara standard bagi pelarasan MariaDB, dalam persekitaran ServBay, kami amat mengesyorkan penggunaan UI untuk memastikan konfigurasi yang stabil dan berkekalan.

Bergantung kepada versi MariaDB, fail konfigurasi biasanya terletak di dalam direktori pemasangan ServBay: /Applications/ServBay/etc/mariadb/<version>.

Amaran Penting: Utamakan UI ServBay

Bagi mengelakkan risiko konflik konfigurasi dan penggantian tetapan secara tidak sengaja, kami sangat menggalakkan anda membuat perubahan tetapan MariaDB melalui UI grafik ServBay. ServBay akan menjana dan mengurus fail konfigurasi asas secara automatik berdasarkan tetapan di UI. Penyuntingan manual fail konfigurasi hanya sesuai untuk tujuan debug sementara dan boleh ditulis semula oleh sistem pengurusan dalaman ServBay pada bila-bila masa.

Mengubah Tetapan Melalui UI ServBay (Disyorkan)

ServBay menawarkan antara muka grafik yang intuitif supaya anda boleh melihat dan melaras parameter konfigurasi penting MariaDB dengan mudah. Kaedah ini selamat dan perubahan akan berkuat kuasa serta-merta tanpa memerlukan anda memulakan semula perkhidmatan secara manual.

1. Buka Antara Muka Pengurusan ServBay: Lancarkan aplikasi ServBay.

2. Navigasi ke Tetapan Pangkalan Data: Dalam panel navigasi kiri, kembangkan menu Pangkalan Data, kemudian pilih MariaDB.

3. Pilih Versi MariaDB: Jika anda memasang lebih daripada satu versi MariaDB, pilih versi yang ingin anda konfigurasi.

4. Ubah Parameter Konfigurasi: Dalam antara muka konfigurasi MariaDB, anda boleh menyemak dan melaraskan pelbagai tetapan berikut:

   • Nama Pengguna Lalai dan Kata Laluan Root: Anda boleh melihat atau (bagi sesetengah versi) set semula kata laluan pengguna root.
   • Alamat Dengar (bind-address): Mengawal antaramuka rangkaian yang didengar oleh MariaDB. Lalai biasanya 0.0.0.0, iaitu mendengar semua antaramuka rangkaian yang tersedia—membenarkan sambungan dari dalam komputer dan (jika dibenarkan firewall) dari jaringan luar. Anda boleh menukarnya menjadi 127.0.0.1 atau localhost untuk membenarkan sambungan tempatan sahaja.
   • Port (port): Menukar nombor port TCP yang didengar MariaDB. Lalai ialah 3306.
   • Bilangan Sambungan Maksimum (max_connections): Menetapkan bilangan maksimum klien yang boleh menyambung ke pelayan MariaDB secara serentak. Laraskan mengikut keperluan aplikasi dan sumber sistem anda.
   • Saiz Data Pakej Maksimum (max_allowed_packet): Mengawal saiz maksimum satu pakej komunikasi (dalam bait). Mempengaruhi saiz maksimum arahan SQL yang boleh diproses, terutamanya untuk pertanyaan dengan data BLOB yang besar.
   • Aktifkan Log Pertanyaan Lambat (slow_query_log): Membolehkan pencatatan pertanyaan lambat bagi tujuan diagnosis prestasi.
   • Fail Log Pertanyaan Lambat (slow_query_log_file): Tetapkan laluan fail log pertanyaan lambat (kebiasaan di /Applications/ServBay/logs/mariadb/).
   • Ambang Masa Pertanyaan Lambat (long_query_time): Tetapkan ambang masa (dalam saat). Pertanyaan yang mengambil masa melebihi ambang ini akan dicatatkan ke dalam log pertanyaan lambat.
   • Saiz Buffer Pool (innodb_buffer_pool_size): Salah satu konfigurasi utama untuk enjin storan InnoDB, digunakan untuk cache data jadual dan indeks. Meningkatkan nilai ini boleh memperbaiki prestasi pangkalan data dengan ketara, tetapi akan menggunakan lebih banyak memori.
   • Set Aksara dan Kaedah Susunan Lalai (character-set-server, collation-server): Menetapkan set aksara dan kaedah susunan lalai pelayan pangkalan data—ini mempengaruhi cara data disimpan dan dibandingkan. utf8mb4 adalah set aksara yang disyorkan kini, menyokong lebih banyak watak termasuk Emoji.

5. Simpan dan Terapkan Perubahan: Setelah selesai mengubah, klik butang Simpan di bahagian bawah UI. ServBay akan mengemas kini konfigurasi dan memuat semula atau memulakan semula perkhidmatan MariaDB di latar belakang secara automatik supaya perubahan berkuat kuasa serta-merta.

Gambar rajah: Antara muka UI untuk mengubah konfigurasi MariaDB melalui ServBay

Mengubah Secara Manual Melalui Fail Konfigurasi (Tidak Disyorkan, Hanya untuk Debug Sementara)

Walaupun tidak digalakkan, mengetahui di mana lokasi dan bagaimana struktur fail konfigurasi MariaDB masih berguna untuk pemahaman lanjut dan debug sementara.

Amaran Risiko: Perubahan Manual Mudah Ditulis Semula

Menyunting fail konfigurasi (seperti my.cnf) secara manual yang diurus oleh ServBay adalah tidak disyorkan, kerana ServBay boleh menjana semula fail-fail ini ketika mengurus atau mengemas kini servis, menyebabkan perubahan manual anda hilang. Sentiasa gunakan UI ServBay untuk perubahan kekal. Jika anda mesti melakukan suntingan manual, fahami bahawa ia adalah berstatus sementara dan cuba kenal pasti cara menetapkan perubahan yang sama melalui UI.

Lokasi Fail Konfigurasi

Fail konfigurasi utama MariaDB dalam ServBay ialah my.cnf. Lokasinya bergantung pada versi MariaDB yang digunakan.

• Fail konfigurasi utama: /Applications/ServBay/etc/mariadb/<version>/my.cnf

Sebagai contoh, untuk versi MariaDB 11.5, laluan ke fail konfigurasi ialah /Applications/ServBay/etc/mariadb/11.5/my.cnf.

Struktur Fail my.cnf & Pilihan Konfigurasi Biasa

my.cnf ialah fail teks dalam format INI. Pilihan-pilihan dikelaskan di bawah kumpulan [section], dengan bahagian [mysqld] adalah utama untuk tetapan pelayan.

Contoh tetapan-tetapan utama (bersamaan tetapan pada UI):

1. Menukar Alamat Dengar (bind-address)

   [mysqld]
   bind-address = 0.0.0.0

   Menetapkan kepada 0.0.0.0 membenarkan sambungan dari mana-mana antaramuka rangkaian. Nilai 127.0.0.1 atau localhost hanya membenarkan sambungan tempatan.

2. Menukar Nombor Port (port)

   [mysqld]
   port = 3306

   Port yang didengar oleh perkhidmatan MariaDB.

3. Menukar Bilangan Sambungan Maksimum (max_connections)

   [mysqld]
   max_connections = 200

   Had maksimum sambungan serentak daripada klien.

4. Menukar Saiz Buffer Pool InnoDB (innodb_buffer_pool_size)

   [mysqld]
   innodb_buffer_pool_size = 256M

   Saiz kawasan memori untuk cache data & indeks InnoDB. Unit boleh K, M, atau G.

5. Menukar Laluan Fail Log Ralat (log_error)

   [mysqld]
   log_error = /Applications/ServBay/logs/mariadb/error.log

   Tetapkan lokasi fail log ralat MariaDB.

6. Mengaktifkan Log Pertanyaan Lambat (slow_query_log, slow_query_log_file, long_query_time)

   [mysqld]
   slow_query_log = 1
   slow_query_log_file = /Applications/ServBay/logs/mariadb/slow.log
   long_query_time = 2  # Dalam saat, catat pertanyaan melebihi 2 saat

   slow_query_log = 1 mengaktifkan log pertanyaan lambat, slow_query_log_file ialah laluan fail log, long_query_time ialah ambang masa.

7. Menukar Set Aksara & Susunan Lalai (character-set-server, collation-server)

   [mysqld]
   character-set-server = utf8mb4
   collation-server = utf8mb4_unicode_ci

   Menetapkan set aksara & kaedah susunan lalai pelayan.

Melaksanakan Perubahan: Mulakan Semula Perkhidmatan MariaDB

Sama ada anda menyimpan perubahan melalui UI ServBay atau mengubah fail konfigurasi secara manual (tidak disyorkan), MariaDB biasanya perlu dimulakan semula supaya konfigurasi baharu diterapkan sepenuhnya. ServBay menawarkan dua cara mudah untuk melakukannya.

Mulakan Semula Melalui UI ServBay

Cara paling ringkas:

1. Buka antara muka pengurusan ServBay.
2. Dalam panel kiri, buka menu Pakej Perisian (Nota: Untuk versi lama, mungkin dipaparkan sebagai Perkhidmatan).
3. Cari pakej MariaDB dengan versi yang anda ingin mulai semula.
4. Klik butang Mulakan Semula di sebelah pakej tersebut.

Mulakan Semula Menggunakan Alat Baris Arahan servbayctl

servbayctl ialah alat baris arahan rasmi daripada ServBay untuk pengurusan pakej dan perkhidmatan.

Buka aplikasi Terminal dan jalankan perintah berikut untuk mulakan semula MariaDB bagi versi tertentu:

servbayctl restart mariadb <version>

Gantikan <version> dengan nombor versi MariaDB yang anda gunakan, contohnya 11.5.

# Contoh: Mulakan Semula MariaDB 11.5
servbayctl restart mariadb 11.5

Soalan Lazim (FAQ)

S: Mengapa ServBay menyarankan perubahan konfigurasi melalui UI, bukan dengan menyunting my.cnf secara manual?

J: ServBay ialah pengurus persekitaran pembangunan tempatan yang berintegrasi. Ia mengurus dan mengabstraksikan konfigurasi perisian asas melalui antara muka (UI). Apabila anda membuat perubahan di UI, ServBay secara automatik akan menjana atau mengemaskini fail konfigurasi berkaitan. Jika anda mengubah my.cnf secara manual, pada masa akan datang (contohnya semasa naik taraf, mula semula, atau bila tetapan lain disimpan dalam UI), konfigurasi boleh diganti semula berdasarkan status dalaman ServBay. Menggunakan UI memastikan perubahan lebih kekal dan selari dengan pengurusan persekitaran ServBay.

S: Adakah saya boleh mengkonfigurasi semua parameter MariaDB melalui UI ServBay?

J: UI ServBay menawarkan kebanyakan pilihan konfigurasi utama yang biasa digunakan pemaju. Untuk konfigurasi lanjutan yang jarang digunakan, anda mungkin perlu menyunting fail konfigurasi secara manual sebagai percubaan sementara. Namun pastikan anda faham sifat sementaranya, dan cuba periksa sama ada “konfigurasi tambahan” boleh dimasukkan melalui UI.

S: Di manakah saya boleh mencari log ralat dan log pertanyaan lambat MariaDB dalam ServBay?

J: Berdasarkan struktur fail lalai ServBay, fail log biasanya terletak di dalam direktori /Applications/ServBay/logs/mariadb/ dalam direktori pemasangan ServBay. Laluan sebenar boleh disemak pada UI ServBay atau dalam fail my.cnf.

Rumusan

Kaedah paling selamat dan disyorkan untuk mengkonfigurasi tetapan MariaDB dalam ServBay adalah menggunakan antara muka grafik ServBay. Melalui UI, anda boleh menyesuaikan alamat dengar, port, sambungan, log, dan parameter penting lain dengan mudah, sambil memastikan perubahan disimpan secara berterusan oleh ServBay. Walaupun anda boleh terus mengakses fail konfigurasi asas my.cnf (di /Applications/ServBay/etc/mariadb/<version>/my.cnf), suntingan manual membawa risiko ditulis semula dan patut dilakukan untuk debug sementara sahaja. Selepas perubahan, gunakan UI ServBay atau alat baris arahan servbayctl untuk memulakan semula MariaDB agar perubahan diaktifkan. Memahami pilihan konfigurasi ini akan membantu anda mengoptimumkan prestasi dan kelakuan MariaDB dalam persekitaran pembangunan tempatan anda.