Menggunakan Azure Cosmos DB Explorer untuk mengelola data Anda

  • Artikel

BERLAKU UNTUK: Nosql MongoDB Cassandra Gremlin Meja

Microsoft Azure Cosmos DB Explorer adalah antarmuka mandiri berbasis web yang memungkinkan Anda melihat dan mengelola data yang disimpan di Microsoft Azure Cosmos DB. Azure Cosmos DB Explorer setara dengan bagian Data Explorer yang ada yang tersedia di portal Azure untuk akun Azure Cosmos DB.

Azure Cosmos DB Explorer memiliki beberapa keuntungan utama jika dibandingkan dengan Data explorer, termasuk:

  • Real estat layar penuh untuk menelusuri data, menjalankan kueri, dan mengamati hasil kueri
  • Kemampuan untuk menyediakan pengguna tanpa akses ke portal Azure atau kemampuan baca atau baca-tulis langganan Azure melalui data dalam kontainer
  • Kemampuan untuk berbagi hasil kueri dengan pengguna yang tidak memiliki langganan Azure atau akses portal Azure

Prasyarat

Mengakses Explorer secara langsung menggunakan langganan Azure Anda

Anda dapat menggunakan akses Explorer secara langsung dan menggunakan kredensial yang ada untuk memulai alat dengan cepat.

  1. Buka https://cosmos.azure.com.

  2. Pilih Masuk. Masuk menggunakan kredensial Anda yang sudah ada yang memiliki akses ke akun Azure Cosmos DB.

  3. Selanjutnya, pilih langganan Azure dan akun target Anda dari menu Pilih Akun Database.

    Screenshot of the 'Select a Database Account' menu in the Explorer.

Mengakses Explorer dari portal Azure menggunakan langganan Azure Anda

Jika Anda sudah nyaman dengan portal Azure, Anda dapat menavigasi langsung dari Data Explorer di portal ke Explorer mandiri.

  1. Masuk ke portal Microsoft Azure.

  2. Navigasikan ke akun Azure Cosmos DB Anda yang sudah ada.

  3. Di menu sumber daya, pilih Data Explorer.

  4. Selanjutnya, pilih opsi menu Buka Layar Penuh.

    Screenshot of the Data Explorer page with the 'Open Full Screen' option highlighted.

  5. Dalam dialog Buka Layar Penuh, pilih Buka.

Memberi orang lain akses ke Explorer menggunakan string koneksi

Gunakan kunci baca-tulis atau baca-saja untuk memberi pengguna lain akses ke akun Azure Cosmos DB Anda. Metode ini berfungsi bahkan jika pengguna tidak memiliki akses ke langganan Azure atau portal Azure.

  1. Masuk ke portal Microsoft Azure.

  2. Navigasikan ke akun Azure Cosmos DB Anda yang sudah ada.

  3. Di menu sumber daya, pilih Kunci.

  4. Pada halaman kunci , pilih opsi Kunci Baca-tulis atau Kunci Baca-saja. Kemudian, salin nilai bidang String Koneksi utama. Anda menggunakan nilai ini di langkah selanjutnya.

    Deskripsi
    Kunci baca-tulis Menyediakan akses untuk melihat dan memodifikasi database, kontainer, kueri, dan sumber daya lain yang terkait dengan akun tertentu tersebut
    Kunci baca-saja Menyediakan akses untuk melihat database, kontainer, kueri, dan sumber daya lain yang terkait dengan akun tertentu tersebut

    Tip

    Jika Anda ingin berbagi hasil kueri dengan rekan satu tim yang tidak memiliki akses ke Langganan Azure atau portal Azure, Anda bisa memberi mereka baca-saja .

  5. Sekarang, minta pengguna lain menavigasi ke https://cosmos.azure.com.

  6. Pilih Koneksi ke akun Anda dengan string koneksi. Kemudian, minta pengguna memasukkan string koneksi yang disalin sebelumnya dan memilih Koneksi.

Mengonfigurasi ambang unit permintaan

Di Explorer, Anda dapat mengonfigurasi batas ke unit permintaan per detik (RU/dtk) yang digunakan kueri. Gunakan fungsionalitas ini untuk mengontrol biaya dan performa dalam unit permintaan (RU) kueri Anda. Fungsionalitas ini juga dapat membatalkan kueri berbayar tinggi secara otomatis.

  1. Mulai di Explorer untuk akun Azure Cosmos DB target.

  2. Pilih opsi menu Pengaturan.

    Screenshot of an Data Explorer page with the 'Open Settings' option highlighted.

  3. Dalam dialog Pengaturan, konfigurasikan apakah Anda ingin Mengaktifkan ambang RU dan nilai ambang RU yang sebenarnya.

    Screenshot of the individual settings to configure the request unit threshold

    Tip

    Ambang RU diaktifkan secara otomatis dengan nilai default 5.000 RU.

Masalah yang diketahui

Berikut adalah beberapa masalah yang saat ini diketahui:

  • Menelusuri item yang berisi UUID tidak didukung di Data Explorer. Batasan ini tidak memengaruhi pemuatan kontainer, hanya menampilkan item atau kueri individual yang menyertakan item ini. Untuk melihat dan mengelola item ini, pengguna harus terus menggunakan alat/SDK yang sama yang awalnya digunakan untuk membuat item ini.

  • Kesalahan HTTP 401 dapat terjadi karena izin kontrol akses berbasis peran yang tidak mencukup untuk akun ID Microsoft Entra Anda. Kondisi ini dapat benar terutama jika akun memiliki peran kustom. Peran kustom apa pun harus memiliki tindakan yang Microsoft.DocumentDB/databaseAccounts/listKeys/* disertakan untuk menggunakan Explorer.

Langkah selanjutnya

Mulai menggunakan kueri