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

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ğı

Prerequisites

• Mevcut bir Azure Cosmos DB hesabı.
  • Azure aboneliğiniz yoksa Azure Cosmos DB'yi ücretsiz deneyin.

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. https://cosmos.azure.com adresine gidin.

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.

   

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

Azure portalında zaten rahat iseniz, portal içi Veri Gezgini'nden bağımsız Veri Gezgini'ne doğrudan geçiş yapabilirsiniz.

1. Azure portal'da 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.

   

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 portal'da oturum açın.

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

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

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

   

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öşesindeki atıf menüsünü seçin ve Sütun 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.

Özel Sütun Kaldırma

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

2. Herhangi bir sütunun sağ üst köşesindeki üç nokta menüsünden "Sütunu Kaldır" seçeneğini seçin.

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

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

5. Herhangi bir sütunun sağ üst köşesindeki üç nokta menüsünden "Sütunu Kaldır" seçeneğini seçin.

Sütun Görünümünüzü sıfırlayın

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

2. Herhangi bir Sütunun sağ üst kısmındaki üç nokta menüsünden Sütunu Düzenle'yi seçin.

3. 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 özellik sizi yinelenen sorgular için filtreleri el ile yeniden oluşturma yinelenen görevinden kurtarır. Filtre Geçmişi ile, geçmiş filtrelerinizin günlüğüne erişebilir ve bunları basit bir seçimle yeniden kullanabilirsiniz. Bu özellik, benzer veri kümelerinde düzenli analizler yapan kullanıcılar için yararlıdır.

Kaydedilmiş Filtreyi Uygula

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

2. Filtreyi Düzenle'yi seçin.

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

4. Filtreniz otomatik olarak kaydedilir ve filtre uygulandıktan sonra filtre iletişim kutusundaki Varsayılan filtre listesine eklenir.

5. Önceki bir filtreyi yeniden uygulamak için Filtreyi Düzenle düğmesini seçin.

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

7. Filtre penceresinde Açılır Menü'yü seçin ve listeden istediğiniz filtreyi seçin.

8. Filtre Uygula'yı seçin

Filtre Geçmişinizi temizleme

1. Veri Gezgini'nde, ayarlara erişmek için Veri Gezgini'nin sağ üst köşesindeki dişli simgesini seçin

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

3. 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ündeki yeni bir özellik, sorgu ve sonuçlar paneli için yatay ve dikey görünümler arasında geçiş yapmanızı sağlar. Komut çubuğu menüsünde "Görünümler" seçeneğini belirleyerek bu görünümler arasında geçiş yapabilirsiniz.

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

2. Veri Gezgini'nde, ayarlara erişmek için Veri Gezgini'nin sağ üst köşesindeki dişli simgesini seçin.

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'i seçin.

İ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. Azure Cosmos DB hedef hesabında Gezgin'de başlayın.

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

   

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.

   

   Tip

   İstek birimi (RU) eşiği, varsayılan değer olarak 5.000 istek birimi ile 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. Azure Cosmos DB hedef hesabında Gezgin'de 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:

	Description
Otomatik (varsayılan)	Hesabınız için anahtar tabanlı kimlik doğrulaması devre dışı bırakılırsa rol tabanlı erişim denetimi 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.

Note

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.

4. Veri Gezgini hesabınızı kullanarak otomatik olarak oturum açar. Bu adım sizden kimlik bilgisi girişi istemeden kısa bir açılır pencere açabilir. 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) kullanmanız ve Veri Gezgini için açılır pencerelere izin vermelisiniz.

   Tip

   Azure Cosmos DB Veri Gezgini, Enable Entra ID (RBAC) değerini True olarak el ile ayarlamak için https://cosmos.azure.com?feature.enableAadDataPlane=true URL'sini kullanma seçeneğini de destekler.

Veri Gezgini istemci bölgesini seçin

Microsoft Entra Authentication (denetim düzlemi rol tabanlı erişim denetimi) ile bir NoSQL hesabına eriştiğinizde ayarlarda Bölge Seçimi seçeneğini görürsünüz. Bir bölge seçildiğinde, Veri Gezgini tüm istekleri ilgili bölgeye göndermeye zorlar.

Bölge seçmek için:

1. Portal aracılığıyla veya doğrudan Azure aboneliğiniz aracılığıyla Microsoft Entra Authentication ile hesabınızda oturum açın.

2. Ayarlar menüsünü açın.

3. Genel'i veya gerekli bölgeyi seçmek için Bölge Seç açılan listesini kullanın.

Salt okunur bir bölge seçerseniz Veri Gezgini yazma, güncelleştirme ve silme işlemlerini devre dışı bırakır.

Genel'i seçerseniz, istemci hesabın genel uç noktasını kullanır ve uç nokta bulmanın istekleri en uygun bölgeye yönlendirmesini sağlar.  Belirli bir bölgeyi seçerseniz istemci uç nokta bulmayı devre dışı bırakır ve tüm istekleri yalnızca seçili bölgeye gönderir. 

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'ni kullanmak için herhangi bir özel rolün içinde Microsoft.DocumentDB/databaseAccounts/listKeys/* eyleminin dahil edilmesi gerekir.

Sonraki adım

Sorguları kullanmaya başlama