Halaman ini menjelaskan cara menjalankan dan terhubung ke AlloyDB Omni setelah Anda menginstalnya di komputer 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 mesin 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 uji koneksi, lihat Menghubungkan menggunakan psql
yang di-containerkan.
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 dimulai secara otomatis saat komputer Anda melakukan booting.
sudo systemctl disable alloydb-dataplane
Mengaktifkan kembali peluncuran saat browser dimulai
sudo systemctl enable alloydb-dataplane
Menghubungkan ke AlloyDB Omni yang berjalan di satu server
Kontainer AlloyDB Omni menyertakan salinan psql
sendiri yang memungkinkan Anda membuka sesi shell SQL interaktif dengan server databasenya.
Anda juga dapat terhubung ke AlloyDB Omni dari luar penampung, menggunakan software yang kompatibel dengan PostgreSQL pilihan Anda.
Menghubungkan menggunakan psql
yang di-container
Untuk terhubung ke server database AlloyDB Omni menggunakan salinan psql
yang di-container-kan, 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
prompt perintah 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.
Cara ini berfungsi karena container AlloyDB Omni mengekspos portnya sendiri
5432
ke port yang sama pada mesin tempat container tersebut berjalan.
Setelah terhubung ke server database, Anda dapat menentukan, membuat kueri, 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 mencakup mengizinkan atau membatasi akses jaringan ke layanan ini sesuai dengan kebutuhan aplikasi Anda, seperti yang akan Anda lakukan dengan server PostgreSQL biasa.