Share via


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

ŞUNLAR IÇIN GEÇERLIDIR: Nosql MongoDB Cassandra Gremlin Tablo

Azure Cosmos DB Gezgini, Azure Cosmos DB'de depolanan verileri görüntülemenizi ve yönetmenizi sağlayan tek başına bir web tabanlı arabirimdir. Azure Cosmos DB Gezgini, Azure Cosmos DB hesapları için Azure portalında bulunan mevcut Veri Gezgini bölümüne eşdeğerdir.

Azure Cosmos DB Gezgini, Veri gezginiyle karşılaştırıldığında aşağıdakiler dahil olmak üzere 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 Explorer'a doğrudan erişme

Gezgin'e 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.

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

Azure aboneliğinizi kullanarak Azure portalından Gezgin'e erişme

Azure portalında zaten rahatsanız doğrudan portal içi Veri Gezgini tek başına Gezgin'e 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.

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

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

Bağlantı dizesi kullanarak başka birine Gezgin erişimi verme

Başka bir kullanıcıya Azure Cosmos DB hesabınıza erişim vermek için okuma-yazma veya salt okunur anahtarı kullanın. Bu yöntem, kullanıcının bir Azure aboneliğine veya Azure portalına erişimi olmasa bile çalışır.

  1. Azure portalda oturum açın.

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

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

  4. Anahtarlar sayfasında, Okuma-yazma Anahtarları veya Salt Okunur Anahtarlar seçeneğini belirleyin. Ardından, Birincil Bağlan Ion Dizesi alanının değerini kopyalayın. Bu değeri sonraki bir adımda kullanacaksınız.

    Açıklama
    Okuma-yazma anahtarı Belirli bir hesapla ilişkili veritabanlarını, kapsayıcıları, sorguları ve diğer kaynakları görüntüleme ve değiştirme erişimi sağlar
    Salt okunur anahtar Belirli bir hesapla ilişkili veritabanlarını, kapsayıcıları, sorguları ve diğer kaynakları görüntüleme erişimi sağlar

    İpucu

    Bir sorgunun sonuçlarını Azure Aboneliğine veya Azure portalına erişimi olmayan ekip arkadaşlarınızla paylaşmak istiyorsanız, onlara salt okunur sağlayabilirsiniz.

  5. Şimdi diğer kullanıcının adresine gitmelerini sağlayın https://cosmos.azure.com.

  6. bağlantı dizesi ile hesabınıza Bağlan seçin. Ardından, kullanıcının daha önce kopyalanan bağlantı dizesi girmesini ve Bağlan'ı seçmesini sağlayın.

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

Gezgin'de sorguların kullandığı saniye başına istek birimleri (RU/sn) 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 Gezgin'de başlayın.

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

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

  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.

    Screenshot of the individual settings to configure the request unit threshold

    İpucu

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

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. Tüm özel rollerin Gezgin'i Microsoft.DocumentDB/databaseAccounts/listKeys/* kullanmak için eylemi içermesi gerekir.

Sonraki adım