Menjalankan dan terhubung ke AlloyDB Omni

Pilih versi dokumentasi:

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

Sebelum memulai

Sebagian besar perintah di halaman ini menggunakan AlloyDB Omni CLI.

Untuk menginstal alat command line ini di komputer Anda, lihat Menginstal CLI AlloyDB Omni.

Menjalankan AlloyDB Omni

Prosedur yang Anda gunakan untuk menjalankan AlloyDB Omni bergantung pada apakah Anda menjalankan AlloyDB Omni dalam container di satu server.

Menginstal AlloyDB Omni akan menyiapkan layanan sistem yang disebut alloydb-dataplane yang dikonfigurasi untuk diluncurkan setiap kali komputer Anda melakukan booting.

Untuk kontrol dan pemantauan dasar AlloyDB Omni, gunakan perintah sudo alloydb, seperti yang ditunjukkan di bagian berikut.

Mulai AlloyDB Omni

sudo alloydb database-server start

Untuk melakukan koneksi pengujian, lihat Menghubungkan menggunakan psql dalam container.

Memeriksa status AlloyDB Omni

sudo alloydb database-server status

Menghentikan AlloyDB Omni

sudo alloydb database-server stop

Menonaktifkan peluncuran saat browser dimulai

Menjalankan perintah berikut akan mencegah AlloyDB Omni memulai secara otomatis saat komputer Anda melakukan booting.

sudo systemctl disable alloydb-dataplane

Mengaktifkan kembali peluncuran saat startup

  sudo systemctl enable alloydb-dataplane

Menghubungkan ke AlloyDB Omni yang berjalan di satu server

Container AlloyDB Omni menyertakan salinan psql-nya sendiri yang memungkinkan Anda membuka sesi shell SQL interaktif dengan server databasenya.

Anda juga dapat terhubung ke AlloyDB Omni dari luar container, menggunakan software yang kompatibel dengan PostgreSQL pilihan Anda.

Menghubungkan menggunakan psql yang di-container

Untuk terhubung ke server database AlloyDB Omni menggunakan salinan psql dalam container-nya sendiri, jalankan perintah berikut:

Server tunggal

docker exec -it pg-service 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 apa pun yang berfungsi dengan PostgreSQL juga dapat berfungsi dengan AlloyDB Omni, tanpa perlu modifikasi.

Untuk terhubung ke server database AlloyDB Omni, gunakan klien atau library kode yang kompatibel dengan PostgreSQL untuk terhubung ke port 5432—port server database PostgreSQL default—dari mesin yang menjalankan AlloyDB Omni.

Hal ini berfungsi karena container AlloyDB Omni mengekspos port 5432-nya sendiri ke port yang sama dari mesin tempat container tersebut berjalan.

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

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

Langkah berikutnya