Menjalankan dan terhubung ke AlloyDB Omni menggunakan RPM

Pilih versi dokumentasi:

Halaman ini menjelaskan cara menjalankan dan terhubung ke AlloyDB Omni setelah Anda menginstalnya di komputer Anda sendiri.

Sebelum memulai

Instal AlloyDB Omni di sistem Anda.

Menjalankan AlloyDB Omni

Gunakan informasi di bagian berikut untuk memulai, memeriksa status, dan menghentikan AlloyDB Omni.

Opsional: Memperbarui kebijakan SELinux

Jika SELinux diaktifkan di sistem Anda dan Anda mengubah parameter Grand Unified Configuration (GUC) tertentu dalam file postgresql.conf, Anda harus memperbarui kebijakan SELinux sebelum memulai layanan AlloyDB Omni. Memperbarui kebijakan ini akan mencegah penolakan akses resource yang dapat membuat server database tidak tersedia atau mengganggu operasi seperti pencadangan.

Menjalankan perintah semanage dan restorecon memerlukan paket policycoreutils-python-utils.

Tabel berikut mencantumkan parameter GUC yang memerlukan update kebijakan SELinux saat Anda mengubahnya dari nilai default:

Parameter GUC Jenis resource Dampak jika kebijakan SELinux tidak diupdate Resolusi
port Port Server database gagal dimulai dan menjadi tidak tersedia. Tetapkan label postgresql_port_t ke port TCP kustom.
external_pid_file File Server database tetap tersedia, tetapi SELinux menolak akses untuk membuat file PID eksternal di luar /var/run/postgresql/. Tetapkan label postgresql_db_t ke direktori file PID kustom.
unix_socket_directories File Server database gagal membuat file soket dan menjadi tidak tersedia. Tetapkan label postgresql_db_t ke direktori soket Unix kustom.
log_directory File Server database gagal menulis log dan menjadi tidak tersedia. Tetapkan label postgresql_db_t ke direktori log kustom.
archive_command File Server database tetap tersedia, tetapi SELinux menolak akses tulis ke direktori target, yang dapat mengganggu pengarsipan dan pencadangan write-ahead log (WAL). Tetapkan label postgresql_db_t ke direktori arsip kustom.

Memperbarui kebijakan SELinux untuk port kustom

Jika Anda mengubah parameter port dalam file postgresql.conf, jalankan perintah berikut untuk mengizinkan AlloyDB Omni mengikat ke port TCP kustom:

  1. Tambahkan label postgresql_port_t ke port kustom:

    sudo /usr/sbin/semanage port -a -t postgresql_port_t -p tcp PORT_NUMBER

    Ganti PORT_NUMBER dengan nomor port TCP kustom—misalnya, 5433.

  2. Pastikan kebijakan port telah diperbarui:

    sudo /usr/sbin/semanage port -l | grep postgresql_port_t

Memperbarui kebijakan SELinux untuk direktori kustom

Jika Anda mengubah parameter external_pid_file, unix_socket_directories, log_directory, atau archive_command dalam file postgresql.conf untuk menggunakan direktori kustom, jalankan perintah berikut untuk menerapkan konteks postgresql_db_t ke direktori tersebut:

sudo /usr/sbin/semanage fcontext -a -t postgresql_db_t "DIRECTORY_PATH(/.*)?"
sudo /sbin/restorecon -R -F DIRECTORY_PATH

Ganti DIRECTORY_PATH dengan jalur lengkap ke direktori file PID kustom, direktori soket Unix, direktori log, atau direktori arsip WAL.

Memulai AlloyDB Omni

  sudo systemctl start alloydbomni18

Opsional: Mengaktifkan mulai ulang layanan otomatis

Untuk mengaktifkan mulai ulang otomatis layanan AlloyDB Omni, lakukan hal berikut:

  1. Tambahkan konfigurasi berikut ke file /etc/systemd/system/alloydbomni18.service.d/override.conf.

      [Service]
    Restart=on-failure

  2. Muat ulang konfigurasi pengelola systemd dan mulai ulang layanan alloydbomni18 agar perubahan diterapkan.

    sudo systemctl daemon-reload
sudo systemctl restart alloydbomni18

Memeriksa status AlloyDB Omni

   sudo systemctl status alloydbomni18

Menghentikan AlloyDB Omni

  sudo systemctl stop alloydbomni18

Menghubungkan ke AlloyDB Omni

Paket RPM AlloyDB Omni juga menyertakan klien psql yang memungkinkan Anda membuka sesi shell SQL interaktif dengan server database.

Anda juga dapat terhubung ke AlloyDB Omni menggunakan software yang kompatibel dengan PostgreSQL pilihan Anda.

Menghubungkan menggunakan psql yang dipaketkan

  /usr/lib/postgresql/18/bin/psql -h localhost -U postgres

Perintah ini menghubungkan Anda ke server sebagai peran pengguna postgres, dan menampilkan command prompt postgres=#. Sekarang Anda dapat menjalankan perintah psql dan kueri SQL.

Untuk keluar dari psql, jalankan perintah \q.

Menghubungkan menggunakan aplikasi Anda sendiri

Aplikasi klien apa pun yang berfungsi dengan PostgreSQL juga dapat berfungsi dengan AlloyDB Omni, tanpa perlu modifikasi.

Gunakan library kode atau klien yang kompatibel dengan PostgreSQL untuk terhubung ke AlloyDB Omni.

Setelah terhubung ke server database, Anda dapat menentukan, mengkueri, dan mengubah database dengan mengirimkan kueri DML dan SQL melalui protokol komunikasi PostgreSQL standar.

Karena AlloyDB Omni berjalan dalam lingkungan Anda sendiri, Anda dapat mengontrol cara terhubung ke AlloyDB Omni. Anda dapat mengizinkan atau membatasi akses jaringan ke AlloyDB Omni sesuai dengan kebutuhan aplikasi, seperti yang Anda lakukan dengan server PostgreSQL biasa.

Langkah berikutnya