Azure Cosmos DB kaynaklarını Azure Depolama Gezgini

  • Makale
  • Okumak için 8 dakika

Uygulama hedefı: MongoDB için SQL API Cassandra API gremlin API tablo API'si Azure Cosmos DB API 'si

Azure Depolama DB'ye bağlanmak için Azure Cosmos kullanabilirsiniz. Azure ve bağımsız bulutlarda barındırılan Azure Cosmos DB hesaplarına Windows, macOS veya Linux üzerinden bağlanmanıza olanak sağlar.

Farklı Azure varlıklarınızı tek bir yerde yönetmek için aynı aracı kullanın. Azure veritabanı varlıklarını Cosmos, verileri iş yönetebilir, saklı yordamları ve tetikleyicileri ve depolama blobları ve kuyruklar gibi diğer Azure varlıklarını güncelleştirebilirsiniz. Azure Depolama Gezgini Cosmos, MongoDB, Graph ve Tablo API'leri için SQL hesapları destekler.

Not

Depolama Gezgini ile Azure Cosmos DB tümleştirmesi kullanımdan kaldırıldı. Bu sürümden itibaren en az 1 yıl boyunca mevcut işlevler kaldırılmayacaktır. Bunun yerine Azure Portal, Azure Portal masaüstü uygulaması veya tek başına Azure Cosmos DB Gezgini'ni kullansanız iyi olur. Alternatif seçenekler arasında, şu anda Depolama Gezgini’nde desteklenmeyen çok sayıda yeni özellik yer alır.

Önkoşullar

Cosmos API'si veya MongoDB SQL Azure Cosmos DB API'si olan bir hesap. Hesabınız yoksa, hesapta bir hesap Azure portal. Daha fazla bilgi Cosmos bkz. Azure Cosmos DB: .Azure portal NET ve SQL API web uygulaması derleme.

Yükleme

En yeni Azure Depolama Gezgini yüklemek için bkz. Azure Depolama Gezgini.. Windows, Linux ve macOS sürümlerini destekliyoruz.

Bir Azure aboneliğine Bağlanma

  1. Yükleme Azure Depolama Gezgini, sol bölmede eklenti simgesini seçin.

    Sol bölmede eklenti simgesini gösteren ekran görüntüsü.

  2. Azure Hesabı Ekle’yi seçip Oturum açın’a tıklayın.

    Azure Bağlan ekle radyo düğmesinin Depolama açılan menüsünü gösteren Azure Depolama'ye Giriş penceresinin ekran görüntüsü.

  3. Azure Oturum Açma iletişim kutusunda Oturum aç'ı seçin ve azure kimlik bilgilerinizi girin.

    Azure aboneliğiniz için kimlik bilgilerinizin nereye girebilirsiniz, gösteren Oturum açma penceresinin ekran görüntüsü.

  4. Listeden aboneliğinizi seçip Uygula’yı seçin.

    Aboneliklerin listesini ve Uygula düğmesini gösteren Hesap Yönetimi bölmesinin ekran görüntüsü.

    Gezgin bölmesi, seçili abonelikte güncelleştirmesi yapar ve hesapları gösterir.

    Seçili abonelikte hesapları gösterecek şekilde güncelleştirilmiş Gezgin bölmesinin ekran görüntüsü.

    Cosmos DB hesabınız Azure aboneliğinize bağlı.

Azure Cosmos DB'ye bağlanmak için bağlantı dizesi kullanma

Azure Cosmos DB'ye bağlanmak için bağlantı dizesi kullanabilirsiniz. Bu yöntem yalnızca SQL Tablo API'lerini destekler. Bağlantı dizesiyle bağlanmak için şu adımları izleyin:

  1. Sol ağaçta Yerel ve Bağlı'yı bulun, Veritabanı Hesapları'Cosmos sağ tıklayın ve ardından veritabanına Bağlan'Cosmos seçin.

    Sağ tıklamadan sonra açılan menüyü gösteren ve Azure'a Bağlan D B Cosmos vurgulanmış ekran görüntüsü.

  2. Veritabanı Bağlan Cosmos seçin:

    1. Açılan menüden API'yi seçin.

    2. Bağlantı dizenizi Bağlantı dizesi kutusuna yapıştırın. Birincil bağlantı dizesini alma hakkında bilgi için bkz. Bağlantı dizesini alma.

    3. Bir Hesap etiketi girin ve ardından özeti kontrol etmek için Sonraki'yi seçin.

    4. Azure Bağlan DB hesabına bağlanmak için Cosmos seçin.

      API açılan Bağlan, bağlantı Cosmos kutusunu ve Hesap etiketi kutusunu gösteren D B penceresinin ekran görüntüsü.

Not

Bağlantı Azure Depolama Gezgini Azure Cosmos DB bağlantı dizesinin geçersiz biçimde olduğunu gösteriyorsa, bağlantı dizesinin sonunda noktalı virgül ( ; ) olduğundan emin olun. Geçerli bir Azure Cosmos DB bağlantı dizesi örneği:AccountEndpoint=https://accountname.documents.azure.com:443;AccountKey=accountkey==;

Azure Cosmos DB'ye bağlanmak için yerel öykünücü kullanma

Öykünücü ile Bir Azure Cosmos DB'ye bağlanmak için aşağıdaki adımları kullanın. Bu yöntem yalnızca SQL destekler.

  1. DB Cosmos'Emulator yükleyin ve açın. Öykünücü yükleme hakkında bilgi için bkz. Cosmos DB Emulator.

  2. Sol ağaçta Yerel ve Bağlı'yı bulun, Cosmos DB Hesapları'Bağlan'yi Cosmos'yi Emulator.

    Sağ tıklamadan sonra azure'a Bağlan D B Cosmos vurgulanmış şekilde Emulator ekran görüntüsü.

  3. Veritabanı Bağlan Cosmos seçin:

    1. Bağlantı dizenizi Bağlantı dizesi kutusuna yapıştırın. Birincil bağlantı dizesini alma hakkında bilgi için bkz. Bağlantı dizesini alma.

    2. Bir Hesap etiketi girin ve ardından özeti kontrol etmek için Sonraki'yi seçin.

    3. Azure Bağlan DB hesabına bağlanmak için Cosmos seçin.

      Bağlantı Dizesi kutusunu Bağlan Hesap Cosmos kutusunu gösteren D B penceresindeki bağlantı kutusunun ekran görüntüsü.

Azure Cosmos DB kaynak yönetimi

Azure Cosmos DB hesabını yönetmek için aşağıdaki işlemleri kullanın:

  • Hesabı hesapta Azure portal.
  • Kaynağı Hızlı Erişim listesine ekleyin.
  • Kaynakları arama ve yenileme.
  • Veritabanlarını oluşturma ve silme.
  • Koleksiyon oluşturma ve silme.
  • Belgeleri oluşturun, düzenleyin, silin ve filtrelenin.
  • Saklı yordamları, tetikleyicileri ve kullanıcı tanımlı işlevleri yönetin.

Hızlı erişim görevleri

Gezgin bölmesinde bir aboneliğe sağ tıklarsanız birçok hızlı eylem görevi gerçekleştirebilirsiniz, örneğin:

  • Azure Cosmos DB hesabına veya veritabanına sağ tıklayın ve ardından portalda Aç'ı seçerek kaynağı tarayıcıda Azure portal.

    Sağ tıklarsınız ve Portalda Aç vurgulanmış şekilde gösterilen menüyü gösteren ekran görüntüsü.

  • Azure Cosmos DB hesabına, veritabanına veya koleksiyonuna sağ tıklayın ve hızlı erişim menüsüne eklemek için Hızlı Erişime Ekle'yi seçin.

  • Seçili yolun altında anahtar sözcük arama özelliğini etkinleştirmek için Buradan Ara'ya tıklayın.

    Arama kutusunun vurgulanmış olduğunu gösteren ekran görüntüsü.

Veritabanı ve koleksiyon yönetimi

Veritabanı oluşturma

  1. Azure Cosmos DB hesabına sağ tıklayın ve Veritabanı Oluştur'u seçin.

    Sağ tıklarsınız ve Veritabanı Oluştur vurgulanmış şekilde gösterilen menüyü gösteren ekran görüntüsü.

  2. Veritabanı adını girin ve tamamlamak için Enter tuşuna basın.

Veritabanı silme

  1. Veritabanına sağ tıklayın ve Veritabanını Sil'i seçin.

    Sağ tıklarsınız ve Veritabanını Sil vurgulanmış şekilde gösterilen menüyü gösteren ekran görüntüsü.

  2. Açılır pencerede Evet'i seçin. Veritabanı düğümü silinir ve Azure Cosmos DB hesabı otomatik olarak yenilenir.

    Evet düğmesinin vurgulanmış olduğu onay penceresinin ekran görüntüsü.

Koleksiyon oluşturma

  1. Veritabanınıza sağ tıklayın ve Koleksiyon Oluştur'u seçin.

    Sağ tıklamadan sonra, Koleksiyon Oluştur vurgulanmış olarak gösterilen menüyü gösteren ekran görüntüsü.

  2. Koleksiyon Oluştur penceresinde Koleksiyon Kimliği ve kapasite gibi istenen Depolama girin. Tamamlamak için Tamam'ı seçin.

    Koleksiyon ID kutusunu ve koleksiyon kapasitesi düğmelerini gösteren Koleksiyon Oluştur penceresinin Depolama görüntüsü.

  3. Sınırsız'ı seçerek bir bölüm anahtarı belirtin ve tamam'ı seçerek tamam'ı seçin.

    Not

    Koleksiyon oluşturma sırasında bölüm anahtarı kullanılırsa, oluşturma işlemi tamamlandıktan sonra koleksiyonda bölüm anahtarı değerini değiştiremezsiniz.

    Depolama Capacity için Sınırsız'ın seçili olduğunu ve Bölüm anahtarı kutusunun vurgulanmış olduğunu gösteren Koleksiyon Oluştur penceresinin ekran görüntüsü.

Koleksiyonu silme

  • Koleksiyona sağ tıklayın, Koleksiyonu Sil'i seçin ve açılan pencerede Evet'i seçin.

    Koleksiyon düğümü silinir ve veritabanı otomatik olarak yenilenir.

    Sağ tıklamadan sonra, Koleksiyonu Sil vurgulanmış olarak gösterilen menüyü gösteren ekran görüntüsü.

Belge yönetimi

Belge oluşturma ve değiştirme

  • Sol bölmedeki Belgeler ' i açın, Yeni belge' yi seçin, sağ bölmedeki Içeriği düzenleyin ve ardından Kaydet' i seçin.

  • Ayrıca var olan bir belgeyi güncelleştirebilir ve ardından Kaydet' i seçebilirsiniz. Değişiklikleri atmak için at' ı seçin.

    Sol bölmede vurgulanan belgeleri gösteren ekran görüntüsü. Sağ bölmede yeni belge, Kaydet ve at vurgulanacaktır.

Bir belgeyi silme

  • Seçili belgeyi silmek için Sil düğmesini seçin.

Belgeler için sorgu

  • belge filtresini düzenlemek için bir SQL sorgusugirin ve ardından uygula' yı seçin.

    Sağ bölmenin filtre ve uygulama düğmelerini, KIMLIK numarasını ve vurgulanan sorgu kutusunu gösteren ekran görüntüsü.

Graf yönetimi

Köşe oluşturma ve değiştirme

  • yeni bir köşe oluşturmak için sol bölmeden Graph açın, yeni köşe' i seçin, içeriği düzenleyin ve ardından tamam' ı seçin.

  • Varolan bir köşeyi değiştirmek için sağ bölmedeki kalem simgesini seçin.

    sol bölmede seçili Graph gösteren ve sağ bölmede yeni köşe ve kalem simgesi gösteren ekran görüntüsü.

Graf silme

  • Bir köşeyi silmek için köşe adının yanındaki geri dönüşüm kutusu simgesini seçin.

Grafik filtresi

  • Grafik filtresini düzenlemek için bir Gremlin sorgusugirin ve sonra Filtre Uygula' yı seçin.

    sol bölmede seçili Graph gösteren ekran görüntüsü ve sağ bölmede vurgulanmış filtre ve sorgu kutusunun gösterilmesi.

Tablo yönetimi

Tablo oluşturma ve değiştirme

  • Yeni bir tablo oluşturmak için:

    1. Sol bölmede varlıklar' ı açın ve ardından Ekle' yi seçin.

    2. Varlık Ekle iletişim kutusunda içeriği düzenleyin.

    3. Özellik eklemek için Özellik Ekle düğmesini seçin.

    4. Ekle'yi seçin.

      Sol bölmede vurgulanan varlıkları gösteren ekran görüntüsü; Ekle, Düzenle, Özellik Ekle ve sağ bölmede vurgulanmış olarak ekle.

  • Bir tabloyu değiştirmek için Düzenle' yi seçin, içeriği değiştirin ve ardından Güncelleştir' i seçin.

Tabloyu içeri ve dışarı aktarma

  • İçeri aktarmak için Içeri aktar düğmesini seçin ve ardından mevcut bir tabloyu seçin.

  • Dışarı aktarmak için dışarı aktar düğmesini seçin ve ardından bir hedef seçin.

    Sağ bölmede vurgulanan Içeri ve dışarı aktarma düğmelerinin gösterildiği ekran görüntüsü.

Varlıkları silme

  • Varlıkları seçin ve ardından Sil düğmesini seçin.

    Sağ bölmede Sil düğmesinin vurgulandığı ve Evet vurgulu bir onay penceresi gösteren ekran görüntüsü.

Tablo sorgulama

  • Sorgu düğmesini seçin, bir sorgu koşulu girin ve sonra sorguyu Yürüt düğmesini seçin. Sorgu bölmesini kapatmak için sorguyu kapat düğmesini seçin.

    Sağ bölmenin sorgu Yürüt düğmesini ve sorguyu Kapat düğmesinin vurgulandığı ekran görüntüsü.

Saklı yordamları, tetikleyicileri ve UDF'leri yönetme

  • Saklı yordam oluşturmak için:

    1. Sol ağaçta saklı yordamlar' a sağ tıkladıktan sonra saklı yordam oluştur' u seçin.

      Sol bölmenin, sağ tıkladıktan sonra, saklı yordam oluştur vurgulanmış şekilde görüntülenen ekran görüntüsü.

    2. Sola bir ad girin, sağ bölmedeki saklı yordam betikleri ' ni girin ve ardından Oluştur' u seçin.

  • Varolan bir saklı yordamı düzenlemek için, yordama çift tıklayın, güncelleştirmeyi yapın ve ardından kaydetmek üzere Güncelleştir ' i seçin. Ayrıca, değişikliği iptal etmek için at ' ı da seçebilirsiniz.

  • Tetikleyiciler ve udf işlemleri, saklı yordamlara benzerdir.

Sorun giderme

aşağıda, Depolama Gezgini Azure Cosmos DB kullandığınızda ortaya çıkan yaygın sorunlara yönelik çözümler verilmiştir.

Oturum açma sorunları

İlk olarak, sorunu düzeltiyor olup olmadığını görmek için uygulamanızı yeniden başlatın. Sorun devam ederse sorun gidermeye devam edin.

Sertifika zincirindeki otomatik olarak imzalanan sertifika

Bu hatayı görmenizin birkaç nedeni vardır, en yaygın iki durum şunlardır:

  • Saydam bir proxy'nin arkasında olursunuz. BT departmanınız gibi birisi, HTTPS trafiğini keser, şifresini çözer ve kendinden imzalı bir sertifika kullanarak şifreler.

  • Virüsten koruma yazılımı gibi yazılımlar çalıştırıyorsunuz. Yazılım, otomatik olarak imzalanan bir TLS/SSL sertifikasını aldığınız HTTPS iletilerine çıkartır.

Depolama Gezgini kendinden imzalı bir sertifika bulduğunda, aldığı HTTPS iletisinin üzerinde oynanıp oynanmadığını bilmez. otomatik olarak imzalanan sertifikanın bir kopyasına sahipseniz, Depolama Gezgini buna güvenmesini söyleyebilirsiniz. Sertifikayı hangi sunucudan eklediyseniz emin değilseniz, şunu bulmayı denemek için aşağıdaki adımları izleyebilirsiniz:

  1. OpenSSL 'yi yükler:

    • Windows: tüm hafif sürümler tamam.
    • macOS ve Linux: işletim sisteminize eklenmelidir.

  2. OpenSSL Çalıştır:

    • Windows: ınstall dizinine gidin ve sonra da openssl.exe çift tıklayın.
    • Mac ve Linux: bir terminalden OpenSSL yürütün.

  3. Yürütün s_client -showcerts -connect microsoft.com:443 .

  4. Otomatik olarak imzalanan sertifikaları bulun. Otomatik olarak imzalanan bir emin değilseniz, konunun ("s:") ve verenin ("i:") aynı olduğunu arayın.

  5. Otomatik olarak imzalanan bir sertifika bulursanız, -----Başlangıç sertifikası----- ve dahil olmak üzere -----son sertifikaya----- yeni bir sertifika ekleyerek ve bu her şeyi kopyalayıp yapıştırın. Her biri için CER dosyası.

  6. Depolama Gezgini açın ve ardından > SSL sertifikalarını düzenle > sertifikaları içeri aktar' a gidin. Bulmak, seçmek ve sonra açmak için dosya seçiciyi kullanın. Oluşturduğunuz CER dosyaları.

Otomatik olarak imzalanan sertifika bulamazsanız, daha fazla yardım için geri bildirim gönderebilirsiniz.

Abonelikler alınamıyor

Oturum açtıktan sonra aboneliklerinizi alamadıysanız, bu önerileri deneyin:

  • Hesabınızın aboneliklere erişimi olduğunu doğrulayın. Bunu yapmak için Azure Portaloturum açın.

  • Doğru ortamda oturum açtığınızdan emin olun:

  • bir proxy 'nin arkasındaysanız, Depolama Gezgini proxy 'nin düzgün yapılandırıldığından emin olun.

  • Hesabı kaldırın ve sonra yeniden ekleyin.

  • Aşağıdaki dosyaları giriş dizininizden silin (örneğin: C:\Users\ContosoUser) ve sonra hesabı tekrar ekleyin:

    • .adalcache
    • .devaccounts
    • .extaccounts

  • Geliştirici konsolunu açmak için F12 tuşuna basın. Oturum açtığınızda konsolu hata iletileri için izleyin.

    Konsol vurgulanmış olarak gösterilen geliştirici araçları konsolunun ekran görüntüsü.

Kimlik doğrulaması sayfası görülemiyor

Kimlik doğrulaması sayfasını göremiyorsanız:

  • Bağlantınızın hızına bağlı olarak, oturum açma sayfasının yüklenmesi biraz zaman alabilir. Kimlik doğrulama iletişim kutusunu kapatmadan önce en az bir dakika bekleyin.
  • bir proxy 'nin arkasındaysanız, Depolama Gezgini proxy 'nin düzgün yapılandırıldığından emin olun.
  • Geliştirici araçları konsolunda (F12), kimlik doğrulamasının neden çalışmadığını öğrenmek için yanıtları izleyin.

Hesap kaldırılamay

Hesabı kaldıramıyorsanız veya yeniden kimlik doğrulama bağlantısı herhangi bir şey yapamazsa:

  • Giriş dizinden aşağıdaki dosyaları silin ve hesabı yeniden ekleyin:

    • .adalcache
    • .devaccounts
    • .extaccounts

  • SAS bağlı Depolama kaynaklarını kaldırmak istiyorsanız şunları silin:

    • Windows için %AppData%/StorageExplorer klasörü
    • /Users/<your_name>/Library/Application SUpport/StorageExplorer for macOS
    • Linux için ~/.config/StorageExplorer

    Not

    Bu dosyaları silersiniz, tüm kimlik bilgilerinizi yeniden girmeniz gerekir.

HTTP/HTTPS ara sunucusu sorunu

ASE'de bir HTTP/HTTPS Cosmos yapılandırıldığında sol ağaçta Azure veritabanı veritabanı düğümlerini listeleyesiniz. Azure Cosmos DB veri gezginini Azure portal bir çalışma olarak kullanabilirsiniz.

"Yerel ve Bağlı" düğümünün altındaki "Geliştirme" düğümü sorunu

Sol ağaçtaki Yerel ve Bağlı düğümün altında Geliştirme düğümünü seçmenizin ardından yanıt yok. Bu beklenen bir davranıştır.

Geliştirme düğümünün seçili olduğunu gösteren ekran görüntüsü.

Yerel ve Cosmos düğümü hatasına Azure Cosmos DB hesabı ekleme

Yerel ve Bağlı düğümde bir Azure Cosmos DB hesabı iliştirdikten sonra aşağıdaki hatayı görüyorsanız, doğru bağlantı dizesini kullanmaya emin olun.

Getaddrinfo ENOTFOUND değerini gösteren Alt kaynaklar alınamadı hata açılır penceresinin ekran görüntüsü.

Azure Cosmos DB düğümünü genişletme hatası

Sol ağaçtaki düğümleri genişletmeye çalışsanız aşağıdaki hatayı alabilirsiniz.

Alt kaynaklar alınamadı hata açılan penceresinin ekran görüntüsü, bu D B hesabına Cosmos gösterir.

Şu önerileri deneyin:

  • Azure Cosmos DB hesabının sağlama devam ediyor olup olduğunu kontrol edin. Hesap başarıyla oluşturulurken yeniden deneyin.
  • Hesap Hızlı Erişim veya Yerel ve Ekli düğümler altında ise, hesabın silinp silinmemiş olduğunu kontrol edin. Bu durumda düğümü el ile kaldırmanız gerekir.

Sonraki adımlar