Menjalankan dan terhubung ke AlloyDB Omni

Pilih versi dokumentasi:

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

Menjalankan AlloyDB Omni

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

Mulai AlloyDB Omni

Untuk memulai container AlloyDB Omni yang dihentikan, jalankan perintah docker container start atau perintah podman container start:

Docker 

docker container start CONTAINER_NAME

Ganti CONTAINER_NAME dengan nama yang Anda tetapkan ke container AlloyDB Omni saat Anda menginstalnya.

Podman 

podman container start CONTAINER_NAME

Ganti CONTAINER_NAME dengan nama yang Anda tetapkan ke container AlloyDB Omni saat Anda menginstalnya.

Memeriksa status AlloyDB Omni

Untuk memeriksa status semua container yang sedang Anda jalankan, jalankan perintah docker container ls atau perintah podman container ls:

Docker 

docker container ls

Podman 

podman container ls

Jika container AlloyDB Omni Anda berjalan, namanya akan muncul di kolom NAMES pada tabel output. Baris yang sesuai merangkum status penampung.

Jika nama penampung Anda tidak muncul di kolom NAMES, berarti AlloyDB Omni Anda tidak berjalan.

Menghentikan AlloyDB Omni

Untuk menghentikan container AlloyDB Omni, jalankan perintah docker container stop atau perintah podman container stop:

Docker 

  docker container stop CONTAINER_NAME

Ganti CONTAINER_NAME dengan nama yang Anda tetapkan ke container AlloyDB Omni saat Anda menginstalnya.

Podman 

  podman container stop CONTAINER_NAME

Ganti CONTAINER_NAME dengan nama yang Anda tetapkan ke container AlloyDB Omni saat Anda menginstalnya.

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.

Untuk mengetahui informasi tentang cara menghubungkan ke cluster database AlloyDB Omni yang berjalan di cluster Kubernetes, lihat Menghubungkan ke AlloyDB Omni yang berjalan di Kubernetes.

Menghubungkan menggunakan psql yang di-container

Untuk terhubung ke server database AlloyDB Omni menggunakan salinan psql yang di-container-kan, jalankan perintah berikut:

Docker 

  docker exec -it CONTAINER_NAME psql -U postgres

Ganti CONTAINER_NAME dengan nama yang Anda tetapkan ke container AlloyDB Omni saat Anda menginstalnya.

Podman 

  podman exec -it CONTAINER_NAME psql -U postgres

Ganti CONTAINER_NAME dengan nama yang Anda tetapkan ke container AlloyDB Omni saat Anda menginstalnya.

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, ekspos jaringan dari container Docker AlloyDB Omni ke mesin host Anda dengan menambahkan --network=host atau -p 5432:5432 ke perintah docker run atau podman run saat Anda memulai AlloyDB Omni.

Untuk memilih nomor port kustom, gunakan -p [HOST_PORT]:5432 saat Anda memulai AlloyDB Omni. Kemudian, gunakan klien atau library kode yang kompatibel dengan PostgreSQL untuk terhubung ke port 5432 atau nomor port kustom yang Anda tentukan.

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.

Langkah berikutnya