Azure Cosmos DB Shell ile yerel verileri terminalden inceleme

Azure Cosmos DB Shell, veritabanlarına, container'lara ve öğelere terminalden göz atmanızı sağlar. Bu yazı, aracı yerel Azure Cosmos DB Linux Emulator ile birlikte kullanarak FleetCharge örnek verisini nasıl sorgulayacağınızı ve nokta okumayı nasıl yapacağınızı gösteriyor. Geliştirme sırasında beklenmeyen veriyi portal veya ek kod olmadan kontrol etmek isteyenler için pratik bir yol.

Kilit noktalar

• Shell 1.1.280-preview ile dotnet tool install --global CosmosDBShell --prerelease komutu kurulabilir; ZIP ile self-contained binary da kullanılabilir.
• Emulator 8081 portunda veri uç noktası, 8080 portunda hazırlık kontrolü sunar; bağlantı için http://127.0.0.1:8081/ kullanılır.
• Container içinde ls -m 10 ile sınırlı liste alın; büyük container'larda limitsiz listelemeden kaçının.
• print current-dispatch SEA-01 nokta okuma yapar; sonuç BAY-2, print current-dispatch PDX-02 ise BAY-99 döndürmelidir.
• Nokta okumada öğe kimliği ile partition key birlikte verilmelidir; yalnızca id yeterli değildir.
• Test bittiğinde cleanup_cosmos ile demo veritabanını silin ve emulator container'ını durdurun.

Microsoft'un Azure Cosmos DB Shell aracı, terminalden veritabanlarına, container'lara ve öğelere göz atmanızı sağlar. Yazar, aracı Docker üzerinde 8081 portunda çalışan Azure Cosmos DB Linux Emulator ile birlikte kullanarak FleetCharge örneğindeki dispatch verilerini inceliyor. Bağlantı kurma, cd ve ls ile gezinme, sorgu çalıştırma ve print komutuyla nokta okuma adımları, portal açmadan ve geçici kod eklemeden nasıl yapılacağını gösteriyor.

Dikkat edilmesi gereken nokta, nokta okumanın tam adres istemesi. Container /depotId ile partition ediliyor, bu yüzden aynı öğe kimliği current-dispatch, SEA-01 ve PDX-02 için farklı belgeleri döndürüyor. Emulator yalnızca yerel geliştirme içindir; bilinen anahtarı ve yerel başarılı işlemler üretim kimlik doğrulaması, performans veya dayanıklılık hakkında bir şey kanıtlamaz.

Gerçek dünyada kullanımı

• Yeni yazılan bir dispatch servisinin Cosmos DB'ye ne yazdığını, test çalıştırmasından hemen sonra terminalde kontrol etmek.
• Belirli bir partition key değerindeki tek bir belgenin doğru güncellenip güncellenmediğini sorgu yazmadan doğrulamak.
• CI dışındaki yerel geliştirme ortamında bir testin neden başarısız olduğunu veri seviyesinde incelemek.

Neden önemli

Yerel geliştirmede beklenmeyen bir veri durumunu uygulama koduna log eklemeden hızlıca görebilirsiniz. Nokta okumada partition key'i doğru kullanmak, yanlış belgeyi okuma hatasını önler.

Benzer haberler

• .NET 8 ve 9 Destek Bitişi: Deployment Odaklı Geçiş Kontrol ListesiDVDEV Community: #dotnet2 gün önce
• Metalama 2027.0 ile metot çağrılarını build sırasında yönlendirmePMMetalama / PostSharp Blog4 gün önce
• Bobcat ile çalıştırılabilir spesifikasyonlar nasıl yazılırJMJeremy D. Miller (The Shade Tree Developer)5 gün önce