Koneksi aplikasi MongoDB ke Azure Cosmos DB

BERLAKU UNTUK: MongoDB

Pelajari cara menghubungkan aplikasi MongoDB Anda ke Azure Cosmos DB menggunakan string koneksi MongoDB. Anda kemudian dapat menggunakan database Azure Cosmos DB sebagai penyimpanan data untuk aplikasi MongoDB Anda.

Tutorial ini menyediakan dua cara untuk mengambil informasi string koneksi:

  • Metode mulai cepat, untuk digunakan dengan driver .NET, Node.js, MongoDB Shell, Java, dan Python.
  • Metode string koneksi kustom, untuk digunakan dengan driver lain.

Prasyarat

Ada dua item yang diperlukan

Dapatkan string koneksi MongoDB dengan menggunakan mulai cepat

Ikuti langkah-langkah di bawah ini:

  1. Di browser Internet, masuk ke portal Microsoft Azure.

  2. Di panel Azure Cosmos DB , pilih API.

  3. Di panel kiri panel akun, pilih Mulai cepat.

  4. Pilih platform Anda (.NET, Node.js, MongoDB Shell, Java, Python). Jika Anda tidak melihat driver atau alat tercantum, jangan khawatir--kami terus mendokumentasikan lebih banyak cuplikan kode koneksi. Komentari apa yang ingin Anda lihat. Untuk mempelajari cara membuat koneksi Anda sendiri, baca Mendapatkan informasi string koneksi akun.

  5. Salin dan tempel cuplikan kode ke aplikasi MongoDB Anda.

Dapatkan string koneksi MongoDB untuk disesuaikan

Ikuti langkah-langkah di bawah ini:

  1. Di browser Internet, masuk ke portal Microsoft Azure.

  2. Di panel Azure Cosmos DB , pilih API.

  3. Di panel kiri panel akun, pilih string Koneksi ion.

  4. Panel string Koneksi ion terbuka. Bilah ini memiliki semua informasi yang diperlukan untuk terhubung ke akun dengan menggunakan driver untuk MongoDB, termasuk string koneksi prakonstruksi.

    Persyaratan string koneksi

    Penting

    Microsoft Azure Cosmos DB memiliki persyaratan dan standar keamanan yang ketat. Akun Microsoft Azure Cosmos DB memerlukan autentikasi dan komunikasi yang aman melalui TLS.

    Microsoft Azure Cosmos DB mendukung format URI string koneksi MongoDB standar, dengan beberapa persyaratan khusus: Akun Microsoft Azure Cosmos DB memerlukan autentikasi dan komunikasi yang aman melalui TLS. Format string koneksi adalah:

    mongodb://username:password@host:port/[database]?ssl=true

    Nilai string ini adalah:

    • Nama pengguna (wajib): Nama akun Azure Cosmos DB.
    • Kata sandi (diperlukan): Kata sandi akun Azure Cosmos DB.
    • Host (wajib): FQDN akun Azure Cosmos DB.
    • Port (wajib diisi): 10255.
    • Database (opsional): Database yang digunakan koneksi. Jika tidak ada database yang tersedia, database defaultnya adalah "uji."
    • ssl=true (diperlukan).

    Misalnya, pertimbangkan akun yang ditampilkan di panel string Koneksi ion. String koneksi valid yaitu:

    mongodb://contoso123:0Fc3IolnL12312asdfawejunASDF@asdfYXX2t8a97kghVcUzcDv98hawelufhawefafnoQRGwNj2nMPL1Y9qsIr9Srdw==@contoso123.documents.azure.com:10255/mydatabase?ssl=true

    Persyaratan driver

    Semua driver yang mendukung protokol kawat versi 3.4 atau yang lebih besar mendukung Azure Cosmos DB untuk MongoDB.

    • Driver klien harus mendukung ekstensi TLS Service Name Identification (SNI) dan/atau opsi appName string koneksi.
    • Jika parameter appName disediakan, parameter tersebut harus disertakan seperti yang ditemukan dalam nilai string koneksi dalam portal Microsoft Azure.