Aracılığıyla paylaş

Verilerinizi yönetmek için Azure Cosmos DB Veri Gezgini kullanma

  • Makale

ŞUNLAR IÇIN GEÇERLIDIR: NoSQL MongoDB Cassandra Gremlin Masa

Azure Cosmos DB Veri Gezgini, Azure Cosmos DB'de depolanan verileri görüntülemenizi ve yönetmenizi sağlayan web tabanlı bir arabirimdir.

Ayrılmış Azure Cosmos DB Veri Gezgini (https://cosmos.azure.com), Azure portalın Veri Gezgini deneyimine kıyasla birkaç önemli avantaja sahiptir:

  • Verilere göz atmak, sorgu çalıştırmak ve sorgu sonuçlarını gözlemlemek için tam ekran emlak
  • Azure portalına veya Azure aboneliğine erişimi olmayan kullanıcılara kapsayıcılardaki veriler üzerinde okuma veya okuma-yazma özellikleri sağlama olanağı
  • Sorgu sonuçlarını Azure aboneliği veya Azure portalı erişimi olmayan kullanıcılarla paylaşma olanağı

Önkoşullar

Azure aboneliğinizi kullanarak doğrudan Veri Gezgini erişme

Veri Gezgini doğrudan erişebilir ve aracı hızlı bir şekilde kullanmaya başlamak için mevcut kimlik bilgilerinizi kullanabilirsiniz.

  1. Şuraya gidin: https://cosmos.azure.com

  2. Oturum Aç'ı seçin. Azure Cosmos DB hesabına erişimi olan mevcut kimlik bilgilerinizi kullanarak oturum açın.

  3. Ardından, Veritabanı Hesabı Seç menüsünden Azure aboneliğinizi ve hedef hesabınızı seçin.

    Veri Gezgini 'Veritabanı Hesabı Seç' menüsünün ekran görüntüsü.

Azure aboneliğinizi kullanarak Azure portalından Veri Gezgini erişme

Azure portalında zaten rahatsanız doğrudan portal içi Veri Gezgini tek başına Veri Gezgini gidebilirsiniz.

  1. Azure portalda oturum açın.

  2. Mevcut Azure Cosmos DB hesabınıza gidin.

  3. Kaynak menüsünde Veri Gezgini'ı seçin.

  4. Ardından Tam Ekranı Aç menü seçeneğini belirleyin.

    'Tam Ekranı Aç' seçeneğinin vurgulandığı Veri Gezgini sayfasının ekran görüntüsü.

  5. Tam Ekran Aç iletişim kutusunda Aç'ı seçin.

Özel Sütun Seçici ile veri görünümlerinizi özelleştirme

Azure Cosmos DB Veri Gezgini'daki Özel Sütun Seçicisi, NoSQL API'sini kullanırken çözümlemenize en uygun sütunları seçerek veri görünümlerinizi özelleştirmenize olanak tanır. Daha önce, Veri Gezgini öğeleri görünümünde yalnızca bölüm anahtarı ve kimlik sütunlarını görebiliyorsunuz. Artık bu yeni özellik sayesinde belgenizden bir veya daha fazla özellik seçebilir ve verilerinizi kolayca görüntülemek için ek sütunlar oluşturabilirsiniz. 

  1. Azure portalda oturum açın.

  2. Mevcut Azure Cosmos DB hesabınıza gidin.

  3. Kaynak menüsünde Veri Gezgini'ı seçin.

  4. Ardından (İsteğe bağlı) Tam Ekranı Aç menü seçeneğini belirleyin.

    'Tam Ekranı Aç' seçeneğinin vurgulandığı Veri Gezgini sayfasının ekran görüntüsü.

  5. Tam Ekran Aç iletişim kutusunda Aç'ı seçin.

  6. Veri Gezgini girdikten sonra sorgulamak istediğiniz koleksiyonu açın ve Öğeler'i seçin.

  7. Herhangi bir Sütunun sağ üst kısmındaki üç nokta menüsüne tıklayın, Sütunu Düzenle'yi seçin

  8. Görüntülemek istediğiniz sütunları seçin ve ayarlarınızı kaydedin.

  9. Veri görünümünüz artık yalnızca seçili sütunları yansıtarak ilgili verilere odaklanmayı kolaylaştırır.

  10. Özel Sütun Kaldırma

  11. Veri Gezgini girdikten sonra sorgulamak istediğiniz koleksiyonu açın ve Öğeler'i seçin.

  12. Herhangi bir Sütunun sağ üst kısmındaki üç nokta menüsüne tıklayın ve Sütunu Kaldır'ı seçin.

  13. Sütun Görünümünüzü artan veya azalan düzende sıralama

  14. Veri Gezgini girdikten sonra sorgulamak istediğiniz koleksiyonu açın ve Öğeler'i seçin.

  15. Herhangi bir Sütunun sağ üst kısmındaki üç nokta menüsüne tıklayın ve Sütunu Kaldır'ı seçin.

  16. Sütun Görünümünüzü sıfırlama

  17. Veri Gezgini girdikten sonra sorgulamak istediğiniz koleksiyonu açın ve Öğeler'i seçin.

  18. Herhangi bir Sütunun sağ üst kısmındaki üç nokta menüsüne tıklayın ve Sütunu Düzenle'yi seçin.

  19. Varsayılan görünüme dönmek için Sıfırla'yı seçin. Alternatif olarak, Veri Gezgini Genel menüsünün sağ üst kısmındaki dişli simgesini seçip Geçmişi Temizle'yi seçerek Filtre Geçmişi, Sütunlar ve Görünüm Penceresi ayarlarınızı temizleyebilirsiniz.

Filtre Geçmişini Kullanma

Filtre Geçmişi, önceki filtreleri hızla yeniden ziyaret edip uygulamanızı sağlar. Bu, yinelenen sorgular için filtreleri el ile yeniden oluşturmanın yinelenen görevinden sizi kaydeder. Filtre Geçmişi ile, geçmiş filtrelerinizin günlüğüne erişebilir ve bunları basit bir tıklamayla yeniden kullanabilirsiniz.  Bu özellik özellikle benzer veri kümelerinde düzenli analizler yapan kullanıcılar için yararlıdır.

  1. Kaydedilmiş Filtre Uygulama

  2. Veri Gezgini girdikten sonra sorgulamak istediğiniz koleksiyonu açın ve Öğeler'i seçin.

  3. Filtreyi Düzenle'ye tıklayın.

  4. Verilerinize normalde yaptığınız gibi bir filtre uygulayın.

Filtre uygulandıktan sonra, filtreniz otomatik olarak kaydedilir ve Açılan filtre penceresindeki Varsayılan filtre listesine eklenir.

  1. Önceki bir filtreyi yeniden uygulamak için Filtreyi Düzenle düğmesine tıklayın.

  2. Filtre penceresinden herhangi bir Filtreyi temizleyin. Kaydedilen Filtreleri görüntüleyebilmek için bu adım gereklidir.

  3. Filtre penceresinde Açılan Menü'ye tıklayın ve listeden istediğiniz filtreyi seçin.

  4. Filtre Uygula'yı seçin

  5. Filtre Geçmişinizi temizleme

  6. Veri Gezgini'da, ayarlara erişmek için Veri Gezgini sağ üst köşesindeki dişli simgesine tıklayın

  7. Geçmişi Temizle düğmesini seçin

  8. Geçmişinizi temizlemek istediğinizi onaylayın.  Buna filtre sütunu bölücü konumları, özel sütunlar ve sekme düzeniniz dahildir.

Sorgu Penceresi görünümünüzü değiştirme

Sorgu görünümünde, sorgu ve sonuç paneli için yatay ve dikey görünümler arasında geçiş yapmanızı sağlayan yeni bir özellik kullanıma sunulmuştur. Komut çubuğu menüsündeki "Görünümler" seçeneğini belirleyerek bu görünümler arasında kolayca geçiş yapabilirsiniz.

  1. Sorgu Penceresi görünüm tercihlerinizi kaydetme

  2. Veri Gezgini'da, ayarlara erişmek için Veri Gezgini sağ üst köşesindeki dişli simgesine tıklayın.

  3. Açılan menüden "Varsayılan Sorgu Sonuçları Görünümü"nü seçin.

  4. Varsayılan görünümünüz olarak yatay veya dikey seçeneğini belirleyin.

  5. Ayarlarınızı uygulamak için Kaydet'e tıklayın.

İstek birimi eşiğini yapılandırma

Veri Gezgini, sorguların kullandığı saniye başına istek birimleri (RU/sn) için bir sınır yapılandırabilirsiniz. Sorgularınızın istek birimlerindeki (RU) maliyeti ve performansı denetlemek için bu işlevi kullanın. Bu işlev, yüksek maliyetli sorguları otomatik olarak iptal edebilir.

  1. Hedef Azure Cosmos DB hesabı için gezginden başlayın.

  2. Ayarlar menü seçeneğini belirleyin.

    'Ayarları Aç' seçeneğinin vurgulandığı bir Veri Gezgini sayfasının ekran görüntüsü.

  3. Ayarlar iletişim kutusunda, RU eşiğini ve gerçek RU eşik değerini etkinleştirmek isteyip istemediğinizi yapılandırın.

    İstek birimi eşiğini yapılandırmak için tek tek ayarların ekran görüntüsü.

    > [!TIP]

    RU eşiği, varsayılan değeri 5.000 RU olan otomatik olarak etkinleştirilir.

Microsoft Entra kimlik doğrulaması ile kullanma

Microsoft Entra tabanlı kimlik doğrulamasını yapılandırma yoluyla etkinleştirerek gezgin içinde kullanabilirsiniz. Rol tabanlı erişim denetimi hakkında daha fazla bilgi için güvenlik kılavuzuna bakın.

  1. Hedef Azure Cosmos DB hesabı için gezginden başlayın.

  2. Ayarlar menü seçeneğini belirleyin.

  3. Ayarlar iletişim kutusunda, üç olası değerden birini kullanmak isteyip istemediğinizi Enable Entra ID (RBAC) yapılandırın:

Açıklama
Otomatik (varsayılan) Hesabınız için anahtar tabanlı kimlik doğrulaması devre dışı bırakılırsa rol tabanlı erişim denetimi (RBAC) otomatik olarak kullanılır. Aksi takdirde, Veri Gezgini veri istekleri için anahtar tabanlı kimlik doğrulaması kullanır.
Doğru Rol tabanlı erişim denetimi her zaman veri istekleri için kullanılır. Hesap veya kimlik için rol tabanlı erişim denetimi doğru yapılandırılmamışsa istekler başarısız olur.
Yanlış Anahtar tabanlı kimlik doğrulaması her zaman veri istekleri için kullanılır. Anahtar tabanlı kimlik doğrulaması devre dışı bırakılırsa istekler başarısız olur.

Microsoft Entra Id rol tabanlı erişim denetimi ayarının ve üç olası değerin ekran görüntüsü.

Not

Bu ayarı anahtar tabanlı kimlik doğrulaması kullanan bir seçenek olarak değiştirmek, oturum açmış olan kimlik adına birincil anahtarı alma isteği tetikleyebilir.

  1. Veri Gezgini hesabınızı kullanarak otomatik olarak oturum açar. Bu, sizden kimlik bilgisi girişi istemeden kısa bir açılan pencere gösterebilir. Otomatik oturum açma başarısız olursa veya açılır pencereler tarayıcınızda engelleniyorsa, veri isteğinde bulunmadan önce Entra ID RBAC için Oturum Aç düğmesini (Veri Gezgini komut çubuğunda bulunur) ve Veri Gezgini için açılır pencerelere izin vermelisiniz.

    İpucu

    Azure Cosmos DB Veri Gezgini, url'yi kullanarak https://cosmos.azure.com?feature.enableAadDataPlane=true değerini Enable Entra ID (RBAC) True el ile olarak ayarlama seçeneğini de destekler.

Bilinen sorunlar

Şu anda bilinen birkaç sorun şunlardır:

  • UUID içeren öğelere göz atma Veri Gezgini desteklenmez. Bu sınırlama kapsayıcıların yüklenmesini etkilemez, yalnızca bu öğeleri içeren tek tek öğeleri veya sorguları görüntüler. Bu öğeleri görüntülemek ve yönetmek için, kullanıcıların başlangıçta bu öğeleri oluşturmak için kullanılan araçları/SDK'ları kullanmaya devam etmesi gerekir.

  • HTTP 401 hataları, Microsoft Entra ID hesabınız için rol tabanlı erişim denetimi izinlerinin yetersiz olması nedeniyle oluşabilir. Bu koşul özellikle hesabın özel bir rolü varsa doğru olabilir. Veri Gezgini kullanmak için tüm özel rollerin eyleminin dahil olması gerekirMicrosoft.DocumentDB/databaseAccounts/listKeys/*.

Sonraki adım

Sorguları kullanmaya başlama