Mulai cepat: Menggunakan Azure Data Studio untuk menyambungkan dan mengkueri Azure Cosmos DB API untuk MongoDB (Pratinjau)

Penting

Azure Data Studio akan dihentikan pada 28 Februari 2026. Kami menyarankan agar Anda menggunakan Visual Studio Code. Untuk informasi selengkapnya tentang migrasi ke Visual Studio Code, kunjungi Apa yang terjadi pada Azure Data Studio?

Mulai cepat ini menunjukkan cara menggunakan Azure Data Studio untuk menyambungkan ke API Azure Cosmos DB untuk MongoDB.

Catatan

Meskipun ID Microsoft Entra adalah nama baru untuk Azure Active Directory (Azure AD), untuk mencegah mengganggu lingkungan yang ada, Azure AD masih tetap berada di beberapa elemen yang dikodekan secara permanen seperti bidang UI, penyedia koneksi, kode kesalahan, dan cmdlet. Dalam artikel ini, dua nama tersebut dapat dipertukarkan.

Prasyarat

Untuk menyelesaikan panduan cepat ini, Anda memerlukan Azure Data Studio dan akun API Azure Cosmos DB.

• Instal Azure Data Studio.
• Instal azure Cosmos DB API untuk ekstensi MongoDB untuk Azure Data Studio.
• Buat Azure Cosmos DB API untuk akun MongoDB.

Menyambungkan ke akun Azure Cosmos DB untuk MongoDB

API untuk MongoDB (berbasis RU)

1. Mulai Azure Data Studio.

2. Pertama kali Anda memulai Azure Data Studio , dialog Koneksi terbuka. Jika dialog Koneksi tidak terbuka, pilih ikon Koneksi Baru di halaman SERVER:

   

3. Dalam dialog yang muncul, pilih Telusuri, lalu pilih + ikon untuk masuk ke Azure.

   

4. Setelah Anda masuk ke Azure, pilih akun Azure Cosmos DB yang ingin Anda akses atau isi Rincian Koneksi dari bidang tersebut menggunakan detail dalam tabel ini.

   Pengaturan	Nilai	Deskripsi
   Tipe sambungan	Akun Mongo	Atur nilai ini ke akun Mongo untuk digunakan dengan API Azure Cosmos DB untuk MongoDB.
   Akun Mongo	[cosmos-account-name]	Nama akun Azure Cosmos DB.
   Jenis autentikasi	Azure Active Directory - Universal dengan dukungan MFA	Pilih antara ID Microsoft Entra atau opsi autentikasi Dasar .
   Rekening	[current-aad-user-name]	Hanya terlihat jika menggunakan autentikasi Microsoft Entra . Pilih akun Microsoft Entra yang ingin Anda gunakan untuk autentikasi.
   Penyewa Microsoft Entra		Hanya terlihat jika menggunakan autentikasi Microsoft Entra. Pilih penyewa Microsoft Entra tempat instans MongoDB berada.
   Username		Hanya terlihat jika menggunakan autentikasi Dasar . Masukkan nama pengguna untuk autentikasi.
   String Koneksi		Hanya terlihat jika menggunakan autentikasi Dasar . Masukkan string koneksi untuk autentikasi.
   Grup Server	<Default>
   Nama (opsional)		Masukkan nama unik apa pun untuk digunakan di sidebar SERVERS.

   

5. Pilih Sambungkan.

   Penting

   Jika Anda memilih autentikasi Microsoft Entra, Anda mungkin diminta untuk memilih nilai string koneksi MongoDB yang akan digunakan untuk koneksi Anda.

Server Anda akan terbuka di bilah sisi SERVERS setelah Anda berhasil tersambung.

API untuk MongoDB (vCore)

1. Buka akun Azure Cosmos DB for MongoDB (vCore) baru di Portal Microsoft Azure.

2. Navigasi ke "Pengaturan" > "String koneksi", dan salin "String koneksi" yang ditampilkan.

   

3. Mulai Azure Data Studio.

4. Pertama kali Anda memulai Azure Data Studio , dialog Koneksi terbuka. Jika dialog Koneksi tidak terbuka, pilih ikon Koneksi Baru di halaman SERVER:

   

5. Dalam dialog yang muncul, pilih akun Mongo>String Koneksi. Tempelkan string Koneksi dari Portal Microsoft Azure ke bidang String Koneksi. Pastikan untuk mengganti token pengguna dan kata sandi di dalam string dengan nama pengguna dan kata sandi admin Anda (ditemukan di Portal Microsoft Azure).

   

6.Pilih Sambungkan.

Membuat database dan koleksi

Langkah-langkah berikut akan membuat database bernama SourceDatabase dan koleksi bernama People:

1. Buka menu konteks untuk akun Anda, dan pilih Buat Database.

   

2. Dalam dialog popup Database dan Koleksi, gunakan detail dalam tabel ini.

   Cepat	Nilai
   Nama database	SourceDatabase
   Nama koleksi	Rakyat

3. Setelah operasi selesai, database baru akan muncul dalam daftar database.

   Tips

   Jika database tidak muncul dalam daftar, pilih Refresh.

4. Perluas node SourceDatabase dan People di bilah sisi SERVERS.

   

Membuat koleksi sampel

Langkah-langkah berikut akan mengisi kumpulan Orang dengan himpunan data sampel:

1. Pilih Database untuk menavigasi ke daftar database di akun Anda.

   

2. Pilih item SourceDatabase dalam daftar database.

   

3. Di menu header, pilih Impor Data Sampel. Dalam dialog konfirmasi, pilih Ya.

   

4. Tunggu hingga operasi impor selesai.

   Kiat

   Operasi impor mungkin perlu waktu beberapa menit untuk diselesaikan.

Kueri data

Langkah-langkah berikut akan menggunakan Mongo Shell untuk menjalankan kueri dan menampilkan hasil kueri:

1. Di menu untuk database Anda, pilih Buka Mongo Shell.

   

2. Jalankan kueri berikut di shell.

   db.Persons.find().pretty()
   

   Saran/Petunjuk

   Metode pretty() di Mongo menampilkan hasil kueri dalam format yang mudah dibaca. Untuk mempelajari lebih lanjut , lihat dokumentasi Resmi MongoDB untuk kursor.pretty.

3. Perhatikan hasil kueri dalam shell. Output harus berisi

   

Langkah berikutnya

Dalam panduan cepat ini, Anda telah mempelajari cara membuat API untuk akun MongoDB, membuat database dan koleksi di Azure Data Studio, dan melakukan kueri data sampel. Sekarang Anda dapat menggunakan Azure Data Studio untuk meninjau data nyata di database Anda.

• Pelajari tentang ekstensi yang tersedia untuk Azure Cosmos DB API untuk MongoDB.
• Tertarik untuk mengimpor data MongoDB ke Azure Cosmos DB? Lihat Memigrasikan MongoDB ke API Azure Cosmos DB untuk MongoDB
• Mencoba melakukan perencanaan kapasitas untuk migrasi ke Azure Cosmos DB? Anda dapat menggunakan informasi tentang kluster database Anda yang ada saat ini untuk membuat perencanaan kapasitas.
  • Jika Anda hanya mengetahui jumlah vCore dan server di kluster database yang ada, baca tentang memperkirakan unit permintaan menggunakan vCore atau vCPU
  • Jika Anda mengetahui rasio permintaan umum untuk beban kerja database Anda saat ini, baca memperkirakan unit permintaan menggunakan perencana kapasitas Azure Cosmos DB