Azure Cosmos DB örneklerine bağlanmak ve bunları sorgulamak için Visual Studio Code kullanma

Visual Studio Code , Linux, macOS ve Windows için çok yönlü bir kod düzenleyicisidir ve çok sayıda uzantıyı destekler. Bu hızlı başlangıçta, Visual Studio Code kullanarak NoSQL için Azure Cosmos DB'ye ve MongoDB için Azure Cosmos DB'ye nasıl bağlanabileceğiniz gösterilmektedir. Verileri sorgulama, ekleme, güncelleştirme ve silme gibi temel veritabanı işlemlerini gerçekleştirmeyi kapsar.

Prerequisites

• Veritabanı ve kapsayıcı ile yapılandırılmış NoSQL için Azure Cosmos DB hesabı. Kaynak ayarlamak için buradaki hızlı başlangıçlardan herhangi birini kullanın:
  • Portal
  • Azure CLI

Uzantıyı yükleme

Visual Studio'da Azure Cosmos DB'ye bağlanmak ve verileri yönetmek için önce Azure Veritabanları uzantısını yükleyin.

1. Visual Studio Code'u açın.
2. UzantılarıGörüntüle'yi > seçerek veya Windows'ta Ctrl + Shift + X kısayolunu ve macOS'ta Command + Shift + X kısayolunu kullanarak Uzantılar bölmesine erişin.
3. Arama çubuğuna Visual Studio Code için DocumentDB yazın ve uzantıyı seçin. Ardından Yükle’yi seçin.
4. Yüklemeden sonra, istenirse Visual Studio Code'u yeniden yükleyin.

NoSQL için Azure Cosmos DB'ye bağlanma

1. Visual Studio Code'da Azure bölmesine gidin (Etkinlik Çubuğu'ndaki Azure simgesini seçin).

2. Microsoft Entra Id aracılığıyla NoSQL için Azure Cosmos DB hesabınızda oturum açın:

   Note

   Azure Cosmos DB kaynaklarınıza erişirken Microsoft Entra ID rol tabanlı erişim denetimini kullanın.

3. Oturum açtıktan sonra Azure ağaç görünümünde Azure Aboneliğinizi bulun ve Azure Cosmos DB'de detaya gidin.

4. Mevcut bir hesabı seçin veya sağ tıklayarak yeni bir kaynak oluşturun.

Verilerinizi sorgulama ve görüntüleme

Aşağıdaki adımlarda sorgu yürütmek ve sorgunun sonuçlarını görüntülemek için Sorgu Düzenleyicisi kullanılır:

1. Koleksiyonunuzun menüsünde koleksiyona sağ tıklayarak Sorgu Düzenleyicisi Önizleme'de açın.

   

2. Tablo Görünümü'nde verilerinizi görüntülemek için sorgu düzenleyicisinde sağlanan sorguyu çalıştırın:

   

3. Desteklenen diğer görünümlerde verilerinizi keşfedin:

   • JSON Görünümü: Ham veri yapısına bakın.

     

   • Ağaç Görünümü: İç içe verileri kolayca keşfedin.

     

Sorgu ve dizin ölçümlerini görüntüleme

Sorgu performansınızı iyileştirmeye yardımcı olmak için sorgu düzenleyicisinde daha fazla sorgu ve dizin ölçümü görüntüleyin.

1. Sorgu Sonuçları'nın yanındaki İstatistikler sekmesini seçin.

2. Ölçüm tanımları hakkında daha fazla bilgi için sorgu ölçümleri belgelerine bakın.

Belge ekleme, düzenleme ve silme

• Gerçek zamanlı belge düzenleme: Değişiklikleri gerçek zamanlı olarak yansıtarak belgeleri anında ekleyin, görüntüleyin, düzenleyin ve silin.

• JSON'dan içeri aktarma: Verilerinizi JSON dosyalarından hızla yükleyin.

Sorgu sonuçlarını dışarı aktarma

• Sonuçları indirme: Sorgu sonuçlarını CSV veya JSON dosyalarına indirin.

İlgili içerik

• NoSQL için API'yi kullanmaya başlama
• Node.js Hızlı Başlangıç
• Python Hızlı Başlangıcı
• Java Hızlı Başlangıcı
• Hızlı Başlangıç'a gidin

Prerequisites

• Veritabanı ve kapsayıcı ile yapılandırılmış NoSQL için Azure Cosmos DB hesabı.
• Komut satırı etkileşimleri için MongoDB kabuğu (mongosh) yüklenir (isteğe bağlı ancak önerilir).

Uzantıyı yükleme

Azure Cosmos DB'de verileri bağlamak ve yönetmek için Visual Studio Code için Azure Veritabanları uzantısını yüklemeniz gerekir.

1. Visual Studio Code'u açın.
2. UzantılarıGörüntüle'yi > seçerek veya Windows'ta Ctrl + Shift + X kısayolunu ve macOS'ta Command + Shift + X kısayolunu kullanarak Uzantılar bölmesine erişin.
3. Arama çubuğuna Visual Studio Code için DocumentDB yazın ve uzantıyı seçin. Ardından Yükle’yi seçin.
4. Yüklemeden sonra, istenirse Visual Studio Code'u yeniden yükleyin.

MongoDB iş yüküne bağlanma

Şimdi MongoDB için Azure Cosmos DB'de MongoDB iş yüküne bağlanın.

1. Çalışma alanı panelinde MongoDB hesapları bölümünü genişletin.

2. Burada tüm MongoDB hesaplarınızı görüntüleyebilirsiniz. Kimlik bilgilerinizi kullanarak yeni bir MongoDB hesabına bağlanın.

   Note

   Başarıyla bağlanan tüm MongoDB kümeleri, Visual Studio Code kapatıldıktan sonra bile MongoDB hesapları bölümünde listelenir.

Sezgisel Veri Yönetimi

Visual Studio Code'da veritabanlarınızı kolayca yönetin:

• Veritabanlarını/Koleksiyonları Oluşturma ve Bırakma: Kaynak panelindeki hesabınızda, veritabanınızda veya koleksiyonunuzda bağlam menüsünü kullanarak veritabanlarını ve koleksiyonları oluşturun veya silin.

• JSON'dan içeri aktarma: JSON dosyalarından koleksiyonunuza hızla veri aktarabilirsiniz.

  • İçeri Aktarmayı Başlat
    1. Kaynak görünümünde koleksiyon adına sağ tıklayın ve Belgeleri Koleksiyona aktar'ı seçin.
    2. Alternatif olarak, koleksiyonunuzun Belgeler girdisine tıklayarak "Koleksiyon Görünümü"nü açın ve ardından İçeri Aktar düğmesini seçin.
  • JSON Dosyası Seç
    1. Verilerinizi içeren *.json dosyasını bulmak için göz atın.
    2. İçeri aktarma işlemini başlatmak için onaylayın.

• Verileri Dışarı Aktar: Yedekleme veya paylaşım için koleksiyonları veya sorgu sonuçlarını JSON olarak kaydedin.

  • Dışarı Aktarmayı Başlat:
    • Seçenek 1
      1. Kaynak görünümünde koleksiyon adına sağ tıklayın ve koleksiyonun tamamını dışarı aktarmak için Belgeleri Koleksiyondan Dışarı Aktar'ı seçin.
    • Seçenek 2
      1. Koleksiyonunuzun Belgeler girdisine tıklayıp Dışarı Aktar düğmesini seçerek "Koleksiyon Görünümü"nü açın.
      2. Koleksiyonun tamamını veya geçerli sorgunun sonuçlarını dışarı aktarmayı seçin.
  • Hedef Dosyayı Belirtin:
    1. Hedef *.json dosyasının adını ve konumunu girin.
    2. Verileri kaydetmeye başlamak için dışarı aktarmayı onaylayın.

• Gerçek Zamanlı Belge Düzenleme: Gerçek zamanlı güncelleştirmelerle belgeleri anında ekleyin, görüntüleyin, düzenleyin ve silin.

  • Belge Düzenlemeyi Aç:
    • Belge düzenleme seçeneklerine doğrudan "Koleksiyon Görünümü" içinde erişin. Bu denetimler, kolay erişim için veri görünümünün üzerinde rahatça bulunur.
  • Kullanılabilir Eylemler:
    • Ekle: Koleksiyon içinde yeni belgeler oluşturun.
    • Görünüm: Seçili belgenin içeriğini görüntüleyin.
    • Düzenle: Seçili belgelerin içeriğini düzenleyin.
    • Sil: Değişikliklerin hemen yansıtılacağı seçili belgeleri kaldırın.

Güçlü Sorgu Araçları

Sorgularınızı sorunsuz bir şekilde çalıştırın ve geliştirin:

• Anlık Sonuçlar: Sorgu sonuçlarını tercih ettiğiniz biçimde (Tablo, JSON veya Ağaç görünümü) hemen görüntüleyin.

  • Görünümleri kolayca değiştirmek için Görünüm menüsünü kullanın.

• Sorguları Doğrudan Yürütme: Söz dizimi vurgulama ve otomatik tamamlama gibi özelliklerle MongoDB sorguları yazın ve yürütür.

  • Sorgunuzu çalıştırmak için Sorgu Bul düğmesini seçin veya sorgu düzenleyicisine basın Ctrl/Cmd+Enter .

Note

Şu anda yalnızca bul filtre sorguları desteklenmektedir ve genişletilmiş sorgu özellikleri yakında kullanıma sunulacaktır.

Esnek Veri Görünümleri

Farklı perspektifler için birden çok görünüm kullanarak verilerinizi keşfedin:

• JSON Görünümü: Ham JSON veri yapısına bakın.

  

• Ağaç Görünümü: İç içe verileri zahmetsizce gezinin ve keşfedin.

  

• Tablo Görünümü: Verileri hızla tarayın ve iç içe geçmiş belgelerde detaya gidin.

  • Detaya gitmek için: Eklenmiş nesneleri gösteren simgeye {} sahip girdileri bulun. İçeriği genişletmek ve görüntülemek için çift tıklayın.

  • Geri dönmek için: Tablo Görünümünün altındaki gezinti içerik haritalarını kullanarak önceki düzeylere dönün.

  

Mongo Shell Tümleştirmesi

Komut satırı işlevselliği kullanılabilir:

• Başlatma mongosh: Gelişmiş MongoDB komutlarını doğrudan Visual Studio Code'dan yürütebilirsiniz.

Note

MongoDB kabuğu (mongosh) uzantıya dahil değildir. Ayrı olarak yüklenip el ile yapılandırılması gerekir.

Küme Yönetimi

Kaynaklarınızı yönetmeye devam edin

• Küme Ayrıntılarını Görüntüle: Kümenizin katmanını, sunucu sürümünü ve kaynak kullanımını denetleyin.

• Etiketleri Yönetme: Azure portalıyla eşitlenen etiketlerle kümelerinizi düzenleyin.