Menggunakan Azure Cosmos DB Data Explorer untuk mengelola data Anda

  • Berlaku untuk: ✅ NoSQL, ✅ MongoDB, ✅ Apache Cassandra, ✅ Apache Gremlin, ✅ Table

Azure Cosmos DB Data Explorer adalah antarmuka berbasis web yang memungkinkan Anda melihat dan mengelola data yang disimpan di Azure Cosmos DB.

Azure Cosmos DB Data Explorer khusus (https://cosmos.azure.com) memiliki beberapa keuntungan utama jika dibandingkan dengan pengalaman Data Explorer portal Azure, termasuk:

  • Tampilan layar penuh untuk menelusuri data, menjalankan kueri, dan mengamati hasilnya.
  • 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

Prerequisites

Mengakses Data Explorer secara langsung menggunakan langganan Azure Anda

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

  1. Navigasi ke 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.

    Cuplikan layar menu 'Pilih Akun Database' di Data Explorer.

Mengakses Data 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 Data 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.

    Cuplikan layar halaman Data Explorer dengan opsi 'Buka Layar Penuh' disorot.

  5. Dalam dialog Buka Layar Penuh, pilih Buka.

Mengkustomisasi tampilan data Anda dengan Pemilih Kolom Kustom

Pemilih Kolom Kustom di Azure Cosmos DB Data Explorer memungkinkan Anda menyesuaikan tampilan data dengan memilih kolom tertentu yang paling relevan dengan analisis Anda saat menggunakan API NoSQL. Sebelumnya, dalam tampilan item Data Explorer, Anda hanya dapat melihat kunci partisi dan kolom ID. Sekarang, dengan fitur baru ini, Anda dapat memilih satu atau banyak properti dari dokumen Anda dan membuat kolom tambahan untuk menampilkan data Anda dengan mudah. 

  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. (Opsional) Selanjutnya, pilih opsi menu Buka Layar Penuh .

    Cuplikan layar halaman Data Explorer dengan opsi 'Buka Layar Penuh' disorot.

  5. Dalam dialog Buka Layar Penuh, pilih Buka.

  6. Setelah berada di Data Explorer, buka koleksi yang ingin Anda kueri, pilih Item.

  7. Pilih pada menu elipsis di kanan atas Kolom apa pun, pilih Edit Kolom

  8. Pilih kolom yang ingin Anda tampilkan dan simpan pengaturan Anda.

  9. Tampilan data Anda sekarang hanya mencerminkan kolom yang dipilih, sehingga lebih mudah untuk fokus pada data yang relevan.

Menghapus Kolom Kustom

  1. Setelah berada di Data Explorer, buka koleksi yang ingin Anda kueri, pilih Item.

  2. Pilih pada menu elipsis di kanan atas Kolom apa pun, pilih Hapus Kolom.

  3. Mengurutkan Tampilan Kolom Anda naik atau turun

  4. Setelah berada di Data Explorer, buka koleksi yang ingin Anda kueri, pilih Item.

  5. Pilih pada menu elipsis di kanan atas Kolom apa pun, pilih Hapus Kolom.

Mereset Tampilan Kolom Anda

  1. Setelah berada di Data Explorer, buka koleksi yang ingin Anda kueri, pilih Item.

  2. Pilih pada menu elipsis di kanan atas Kolom apa pun, pilih Edit Kolom.

  3. Pilih Reset untuk kembali ke tampilan default. Atau Anda dapat Menghapus pengaturan Riwayat Filter, Kolom, dan TampilanLaporan dengan memilih ikon gerigi di menu Global Data Explorer kanan atas dan pilih Hapus Riwayat.

Menggunakan Riwayat Filter

Riwayat Filter memungkinkan Anda mengunjungi kembali dan menerapkan filter sebelumnya dengan cepat. Fitur ini menghemat waktu Anda dari tugas pemulihan filter manual untuk permintaan berulang. Dengan Riwayat Filter, Anda dapat mengakses log filter sebelumnya dan menerapkannya kembali dengan pilihan sederhana. Fitur ini bermanfaat bagi pengguna yang melakukan analisis reguler pada himpunan data serupa.

Terapkan Filter Tersimpan

  1. Setelah berada di Data Explorer, buka koleksi yang ingin Anda kueri, pilih Item.

  2. Pilih Edit Filter.

  3. Terapkan filter ke data Anda seperti biasa.

  4. Filter Anda akan disimpan secara otomatis dan ditambahkan ke daftar Filter default dalam dialog filter setelah menerapkan filter.

  5. Untuk menerapkan kembali filter sebelumnya, pilih tombol Edit Filter.

  6. Hapus Filter apa pun dari jendela filter. Langkah ini diperlukan untuk dapat melihat Filter tersimpan Anda.

  7. Pilih Menu Drop Down di jendela filter, dan pilih filter yang diinginkan dari daftar.

  8. Pilih Terapkan Filter

Menghapus Riwayat Filter Anda

  1. Di Data Explorer, pilih ikon gerigi di sudut kanan atas Data Explorer untuk mengakses pengaturan

  2. Pilih tombol Hapus Riwayat

  3. Konfirmasikan bahwa Anda ingin menghapus riwayat Anda. Ini termasuk posisi pemisah kolom filter, kolom kustom, dan tata letak tab Anda.

Mengubah tampilan Jendela Kueri Anda

Fitur baru dalam tampilan kueri memungkinkan Anda beralih antara tampilan horizontal dan vertikal untuk kueri dan panel hasil. Anda dapat beralih di antara tampilan ini dengan memilih opsi "Tampilan" di menu bilah perintah.

  1. Simpan preferensi tampilan Jendela Kueri Anda

  2. Di Data Explorer, pilih ikon gerigi di sudut kanan atas Data Explorer untuk mengakses pengaturan.

  3. Pilih "Tampilan Hasil Kueri Default" dari menu dropdown.

  4. Pilih horizontal atau vertikal sebagai tampilan default Anda.

  5. Pilih Simpan untuk menerapkan pengaturan Anda.

Mengonfigurasi ambang unit permintaan

Di Data Explorer, Anda dapat mengonfigurasi batas pada request units per second (RU/s) yang digunakan kueri. Gunakan fungsionalitas ini untuk mengontrol biaya dan performa dalam unit permintaan (RU) kueri Anda. Fungsi ini juga dapat membatalkan kueri berbiaya tinggi secara otomatis.

  1. Mulai di bagian penjelajah untuk akun Azure Cosmos DB target.

  2. Pilih opsi menu Pengaturan.

    Cuplikan layar halaman Data Explorer dengan opsi 'Buka Pengaturan' disorot.

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

    Cuplikan layar pengaturan individual untuk mengonfigurasi ambang unit permintaan.

    Tip

    Ambang batas unit permintaan (RU) diaktifkan secara otomatis dengan nilai default 5.000 unit permintaan.

Gunakan dengan autentikasi Microsoft Entra

Anda dapat menggunakan autentikasi berbasis Microsoft Entra dalam penjelajah dengan mengaktifkannya melalui konfigurasi. Untuk informasi selengkapnya tentang kontrol akses berbasis peran, lihat panduan keamanan.

  1. Mulai di bagian penjelajah untuk akun Azure Cosmos DB target.

  2. Pilih opsi menu Pengaturan.

  3. Dalam dialog Pengaturan, konfigurasikan apakah Anda ingin Enable Entra ID (RBAC) menggunakan salah satu dari tiga nilai yang mungkin:

Description
Otomatis (default) Kontrol akses berbasis peran secara otomatis digunakan jika autentikasi berbasis kunci dinonaktifkan untuk akun Anda. Jika tidak, Data Explorer menggunakan autentikasi berbasis kunci untuk permintaan data.
Benar Kontrol akses berbasis peran selalu digunakan untuk permintaan data. Jika kontrol akses berbasis peran tidak dikonfigurasi dengan benar untuk akun atau identitas, maka permintaan gagal.
Tidak Benar Autentikasi berbasis kunci selalu digunakan untuk permintaan data. Jika autentikasi berbasis kunci dinonaktifkan, maka permintaan gagal.

Cuplikan layar pengaturan kontrol akses berbasis peran ID Microsoft Entra dan tiga nilai potensial.

Nota

Mengubah pengaturan ini ke opsi yang menggunakan autentikasi berbasis kunci dapat memicu permintaan untuk mengambil kunci utama atas nama identitas yang masuk.

  1. Data Explorer masuk secara otomatis menggunakan akun Anda. Langkah ini mungkin membuka jendela popup singkat tanpa meminta entri kredensial kepada Anda. Jika proses masuk otomatis gagal atau jika popup diblokir di browser Anda, Anda harus menggunakan tombol Masuk untuk RBAC ID Entra (terletak di bilah perintah Data Explorer) dan mengizinkan popup untuk Data Explorer sebelum membuat permintaan data apa pun.

    Tip

    Azure Cosmos DB Data Explorer juga mendukung opsi untuk mengatur nilai Enable Entra ID (RBAC) ke True menggunakan https://cosmos.azure.com?feature.enableAadDataPlane=true URL secara manual.

Pilih wilayah klien Data Explorer

Saat Anda mengakses akun NoSQL dengan Microsoft Entra Authentication (kontrol akses berbasis peran sarana kontrol), Anda akan melihat opsi Pemilihan Wilayah di pengaturan. Memilih wilayah memaksa Data Explorer untuk mengirim semua permintaan ke wilayah tertentu.

Cuplikan layar menu pemilihan wilayah dengan opsi global dan dua opsi regional.

Untuk memilih wilayah:

  1. Masuk ke akun Anda dengan Microsoft Entra Authentication melalui portal atau langsung melalui langganan Azure Anda.

  2. Buka menu Pengaturan .

  3. Gunakan menu drop-down Pilih Wilayah untuk memilih Global atau wilayah yang diperlukan.

Jika Anda memilih wilayah baca-saja , Data Explorer menonaktifkan operasi tulis, perbarui, dan hapus.

Jika Anda memilih Global, klien menggunakan titik akhir global akun dan memungkinkan penemuan titik akhir untuk merutekan permintaan ke wilayah optimal. Jika Anda memilih wilayah tertentu, klien menonaktifkan penemuan titik akhir dan mengirim semua permintaan hanya ke wilayah yang dipilih. 

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 mana pun harus disertakan tindakan Microsoft.DocumentDB/databaseAccounts/listKeys/* untuk menggunakan Data Explorer.

Langkah selanjutnya

Memulai dengan kueri

  • Last updated on