Menyambungkan ke kluster di Azure Cosmos DB for PostgreSQL

Penting

Azure Cosmos DB for PostgreSQL tidak lagi didukung untuk proyek baru. Jangan gunakan layanan ini untuk proyek baru. Sebagai gantinya, gunakan salah satu dari dua layanan ini:

• Gunakan Azure Cosmos DB for NoSQL untuk solusi database terdistribusi yang dirancang untuk skenario skala tinggi dengan perjanjian tingkat layanan ketersediaan (SLA) 99,999%, skala otomatis instan, dan failover otomatis di beberapa wilayah.

• Gunakan fitur Elastic Clusters dari Azure Database For PostgreSQL untuk PostgreSQL yang dipecah menggunakan ekstensi Citus sumber terbuka.

Pilih salah satu klien database berikut untuk melihat cara mengonfigurasinya untuk menyambungkan ke kluster Azure Cosmos DB for PostgreSQL.

pgAdmin

pgAdmin adalah platform pengembangan dan administrasi sumber terbuka yang populer dan kaya fitur untuk PostgreSQL.

1. Unduh dan pasang pgAdmin.

2. Buka aplikasi pgAdmin di komputer klien Anda. Dari Dasbor, pilih Tambahkan Server Baru.

   

3. Pilih Nama di tab Umum. Nama apa pun akan berfungsi.

   

4. Masukkan detail koneksi di tab Koneksi.

   

   Kustomisasi bidang berikut:

   • Nama/alamat host: Dapatkan nilai ini dari halaman Gambaran Umum untuk kluster Anda di portal Azure. Itu tercantum di sana sebagai Nama koordinator. Itu akan berbentuk c-<clustername>.12345678901234.postgres.cosmos.azure.com.
   • Database pemeliharaan: gunakan nilai citus.
   • Nama pengguna: gunakan nilai citus.
   • Kata sandi: kata sandi koneksi atau token ID Microsoft Entra. Untuk informasi selengkapnya, lihat opsi autentikasi.
   • Simpan kata sandi: aktifkan jika diinginkan.

5. Di tab SSL, atur mode SSL ke Perlu.

   

6. Pilih Simpan untuk menyimpan dan menyambung ke database.

psql

Utilitas psql adalah front-end berbasis terminal untuk PostgreSQL. Ini memungkinkan Anda mengetik kueri secara interaktif, menerbitkan mereka ke PostgreSQL, dan melihat hasil kueri.

1. Instal psql. Ini disertakan dengan penginstalan PostgreSQL, atau tersedia secara terpisah di pengelola paket untuk beberapa sistem operasi.

2. Di Portal Azure, pada halaman kluster, pilih item menu String Koneksi, lalu salin string koneksi psql.

   

   String psql adalah dari formulir psql "host=c-<clustername>.<uniqueID>.postgres.cosmos.azure.com port=5432 dbname=citus user=citus password=<your_password> sslmode=require". Perhatikan bahwa nama host dimulai dengan c-, misalnya c-demo.12345678901234.postgres.cosmos.azure.com. Awalan ini menunjukkan simpul koordinator kluster. Default dbname dan username adalah citus dan tidak dapat diubah.

3. Di string koneksi Anda menyalin, ganti <your_password> dengan kata sandi koneksi atau token ID Microsoft Entra Anda. Untuk informasi selengkapnya, lihat opsi autentikasi.

4. Di prompt terminal lokal, tempelkan string koneksi psql, lalu tekan Enter.

Langkah berikutnya

• Pemecahan masalah koneksi.
• Verifikasikan sertifikat TLS di koneksi Anda.
• Sekarang Anda dapat tersambung ke database, pelajari cara membuat aplikasi yang dapat diskalakan.