Baca dalam bahasa Inggris

Bagikan melalui


Menggunakan Azure Cosmos DB Data Explorer untuk mengelola data Anda

BERLAKU UNTUK: NoSQL MongoDB Cassandra Gremlin Meja

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:

  • 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 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. 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.

    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. Selanjutnya, (Opsional) 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. Klik 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 akan mencerminkan kolom yang dipilih, sehingga lebih mudah untuk fokus pada data yang relevan.

  10. Menghapus Kolom Kustom

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

  12. Klik menu elipsis di kanan atas Kolom apa pun, pilih Hapus Kolom.

  13. Mengurutkan Tampilan Kolom Anda naik atau turun

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

  15. Klik menu elipsis di kanan atas Kolom apa pun, pilih Hapus Kolom.

  16. Mereset Tampilan Kolom Anda

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

  18. Klik menu elipsis di kanan atas Kolom apa pun, pilih Edit Kolom.

  19. 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. Ini menghemat Anda dari tugas berulang dari rekonstruksi filter secara manual untuk kueri berulang. Dengan Riwayat Filter, Anda dapat mengakses log filter sebelumnya dan menerapkannya kembali dengan klik sederhana.  Fitur ini sangat bermanfaat bagi pengguna yang melakukan analisis rutin pada himpunan data serupa.

  1. Terapkan Filter Tersimpan

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

  3. Klik Edit Filter.

  4. Terapkan filter ke data Anda seperti biasa.

Setelah menerapkan filter, filter Anda akan secara otomatis disimpan dan ditambahkan ke daftar Filter default di menu Drop Down jendela filter.

  1. Untuk menerapkan kembali filter sebelumnya, klik tombol Edit Filter.

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

  3. Klik Menu Drop Down di jendela filter, dan pilih filter yang diinginkan dari daftar.

  4. Pilih Terapkan Filter

  5. Menghapus Riwayat Filter Anda

  6. Di Data Explorer, klik ikon gerigi di sudut kanan atas Data Explorer untuk mengakses pengaturan

  7. Pilih tombol Hapus Riwayat

  8. 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

Kami telah memperkenalkan fitur baru dalam tampilan kueri yang memungkinkan Anda beralih antara tampilan horizontal dan vertikal untuk kueri dan panel hasil. Anda dapat dengan mudah beralih di antara tampilan ini dengan memilih opsi "Tampilan" di menu bilah perintah.

  1. Simpan preferensi tampilan Jendela Kueri Anda

  2. Di Data Explorer, klik 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. Klik Simpan untuk menerapkan pengaturan Anda.

Mengonfigurasi ambang unit permintaan

Di Data 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 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 RU diaktifkan secara otomatis dengan nilai default 5.000 RU.

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 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:

Deskripsi
Otomatis (default) Kontrol akses berbasis peran (RBAC) 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.
Salah 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.

Catatan

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 akan masuk secara otomatis menggunakan akun Anda. Ini mungkin menampilkan 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.

Masalah umum

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

Langkah selanjutnya