Spring Data NoSQL için API için Azure Cosmos DB v2 (eski): Sürüm notları ve kaynaklar

  • Makale

UYGULANANLAR: NoSQL

Spring Data NoSQL için Azure Cosmos DB sürüm 2, geliştiricilerin Spring uygulamalarında Azure Cosmos DB kullanmasına olanak tanır. Spring Data Azure Cosmos DB veritabanlarını ve koleksiyonları işlemek, belgelerle çalışmak ve sorgular göndermek için Spring Data arabirimini kullanıma sunar. Hem Eşitleme hem de Zaman Uyumsuz (Reaktif) API'ler aynı Maven yapıtında desteklenir.

Uyarı

Spring Data Azure Cosmos DB SDK'sının bu sürümü, Azure Cosmos DB Java SDK'sının kullanımdan kaldırılmıştır. Bu Spring Data Azure Cosmos DB SDK'sı yakın gelecekte kullanımdan kaldırılacağı duyurulacaktır! Bu, Azure Cosmos DB için en son Azure Spring Data Azure Cosmos DB SDK'sı değildir ve güncel değildir. Azure Spring Data Azure Cosmos DB SDK V2'deki performans sorunları ve kararlılık nedeniyle projeniz için Azure Spring Data Azure Cosmos DB v3 kullanmanızı kesinlikle öneririz. Yükseltmek için, temel java SDK V4'teki farkı anlamak için Azure Cosmos DB Java SDK'sına geçiş v4 kılavuzundaki yönergeleri izleyin.

Spring Framework, Java uygulama geliştirmeyi kolaylaştıran bir programlama ve yapılandırma modelidir. Spring, bağımlılık ekleme kullanarak uygulamaların "tesisatını" kolaylaştırır. Birçok geliştirici Spring'i sever çünkü uygulama oluşturma ve test etme konularını daha kolay hale getirir. Spring Boot , sıhhi tesisatın bu işlemesini bir gözle web uygulamasına ve mikro hizmet geliştirmeye doğru genişletir. Spring Data , Spring veya Spring Boot uygulaması bağlamından Azure Cosmos DB gibi veri depolarına erişmeye yönelik bir programlama modelidir.

Spring Data Azure Cosmos DB'i Azure Spring Apps'te barındırılan uygulamalarınızda kullanabilirsiniz.

Önemli

Bu sürüm notları Spring Data Azure Cosmos DB'nin 2. sürümüne yöneliktir. Sürüm 3'e ilişkin sürüm notlarını burada bulabilirsiniz.

Spring Data Azure Cosmos DB yalnızca NoSQL için API'yi destekler.

Diğer Azure Cosmos DB API'lerinde Spring Data hakkında bilgi için aşağıdaki makalelere bakın:

Hızlı mı olmak istiyorsun?

  1. SDK'yı kullanabilmek için desteklenen en düşük Java çalışma zamanı olan JDK 8'i yükleyin.
  2. Başlatıcıyı kullanarak spring data Azure Cosmos DB uygulaması oluşturun. Bu çok kolay!
  3. Temel Azure Cosmos DB isteklerinde yol gösteren Spring Data Azure Cosmos DB geliştirici kılavuzuyla çalışın.

Spring Initializr'ı kullanarak Spring Boot Starter uygulamalarını hızlı bir şekilde başlatabilirsiniz!

Kaynaklar

Kaynak Bağlantı
SDK indirmesi Maven
API belgeleri Spring Data Azure Cosmos DB başvuru belgeleri
SDK'ya katkıda bulunma GitHub'da Spring Data Azure Cosmos DB deposu
Spring Boot Starter Java için Azure Cosmos DB Spring Boot Starter istemci kitaplığı
Geliştirici kılavuzu Spring Data Azure Cosmos DB geliştirici kılavuzu
Starter kullanma Spring Boot Starter'ı NoSQL için Azure Cosmos DB ile kullanma
Azure Cosmos DB Spring Boot Starter için GitHub deposu
Azure Uygulaması Hizmeti ile örnek Spring ve Azure Cosmos DB'yi Linux üzerinde App Service ile kullanma

Sürüm geçmişi

2.3.0 (21 Mayıs 2020)

Yeni özellikler

  • Spring Boot sürümünü 2.3.0 sürümüne Güncelleştirmeler.

2.2.5 (19 Mayıs 2020)

Yeni özellikler

  • Azure Cosmos DB sürümünü 3.7.3 sürümüne Güncelleştirmeler.

Önemli hata düzeltmeleri

  • Azure Cosmos DB SDK 3.7.3'ten bellek sızıntısı düzeltmeleri ve Netty sürüm yükseltmeleri içerir.

2.2.4 (6 Nisan 2020)

Önemli hata düzeltmeleri

  • bayrağını CosmosDbConfighesaba katacak şekilde düzeltirallowTelemetry.
  • Kapsayıcıdaki özelliği düzeltir TTL .

2.2.3 (25 Şubat 2020)

Yeni özellikler

  • Bölüm anahtarı API'lerine göre yeni findAll ekler.
  • Azure Cosmos DB sürümünü 3.7.0 sürümüne Güncelleştirmeler.

Önemli hata düzeltmeleri

  • Düzeltmeler collectionName ->containerName.
  • Düzeltmeler entityClass ve domainClass ->domainType.
  • "Giriş varlığı yerine depo tarafından kaydedilen varlık koleksiyonunu döndür" hatalarını düzeltir.

2.1.10 (25 Şubat 2020)

Önemli hata düzeltmeleri

  • "Giriş varlığı yerine depo tarafından kaydedilen varlık koleksiyonunu döndürme" için backports düzeltmesi.

2.2.2 (15 Ocak 2020)

Yeni özellikler

  • Azure Cosmos DB sürümünü 3.6.0 sürümüne Güncelleştirmeler.

Önemli hata düzeltmeleri

2.2.1 (31 Aralık 2019)

Yeni özellikler

  • Azure Cosmos DB SDK sürümünü 3.5.0 sürümüne Güncelleştirmeler.
  • Otomatik koleksiyon oluşturmayı etkinleştirmek veya devre dışı bırakmak için ek açıklama alanı ekler.
  • Özel durum işlemeyi geliştirir. aracılığıyla kullanıma CosmosDBAccessExceptionsunarCosmosClientException.
  • ve activityId aracılığıyla ResponseDiagnosticskullanıma sunarrequestCharge.

Önemli hata düzeltmeleri

  • SDK 3.5.0 güncelleştirmesinde "Azure Cosmos DB HTTP yanıt üst bilgisi 8192 bayttan büyük olduğunda özel durum" "ConsistencyPolicy.defaultConsistencyLevel() Sınırlanmış Eskime ve Tutarlı Ön Ek üzerinde başarısız oluyor" hatasını düzeltir.
  • Yöntemin davranışını düzeltir findById . Daha önce, bir özel durum atmak yerine varlık bulunamadığında bu yöntem boş döndürdü.
  • Kullanıldığında sıralamanın bir sonraki sayfada CosmosPageRequest uygulanmadığı bir hatayı düzeltir.

2.1.9 (26 Aralık 2019)

Yeni özellikler

  • Otomatik koleksiyon oluşturmayı etkinleştirmek veya devre dışı bırakmak için ek açıklama alanı ekler.

Önemli hata düzeltmeleri

  • Yöntemin davranışını düzeltir findById . Daha önce, bir özel durum atmak yerine varlık bulunamadığında bu yöntem boş döndürdü.

2.2.0 (21 Ekim 2019)

Yeni özellikler

  • Reaktif Azure Cosmos DB Deposu desteğini tamamlayın.
  • Azure Cosmos DB İstek Tanılama Dizesi ve Sorgu Ölçümleri desteği.
  • Azure Cosmos DB SDK sürüm 3.3.1 güncelleştirmesi.
  • Spring Framework sürümü 5.2.0.RELEASE sürümüne yükseltildi.
  • Spring Data Commons sürümü 2.2.0.RELEASE sürümüne yükseltildi.
  • Ekler findByIdAndPartitionKey ve deleteByIdAndPartitionKey API'ler.
  • Azure-documentdb'den bağımlılığı kaldırır.
  • DocumentDB'yi Azure Cosmos DB'ye yeniden markalar.

Önemli hata düzeltmeleri

  • "Sıralama, pageSize depodaki toplam öğeden küçük olduğunda özel durum oluşturur" hatasını düzeltir.

2.1.8 (18 Ekim 2019)

Yeni özellikler

  • DocumentDB API'lerini kullanımdan kaldırıyor.
  • Ekler findByIdAndPartitionKey ve deleteByIdAndPartitionKey API'ler.
  • temelinde _etagiyimser kilitleme ekler.
  • Belge koleksiyonu adı için SpEL ifadesini etkinleştirir.
  • Geliştirmeler ekler ObjectMapper .

2.1.7 (18 Ekim 2019)

Yeni özellikler

  • Azure Cosmos DB SDK sürüm 3 bağımlılığı ekler.
  • Reactive Azure Cosmos DB Deposu ekler.
  • Azure Cosmos DB SDK sürüm 3'ün DocumentDbTemplate kullanılması için uygulamasını Güncelleştirmeler.
  • Reaktif Azure Cosmos DB Deposu desteği için diğer yapılandırma değişikliklerini ekler.

2.1.2 (19 Mart 2019)

Önemli hata düzeltmeleri

  • Bağımlılıkları applicationInsights kaldırır:
    • Bağımlılıkların kirletilmesi riski.
    • Java 11 uyumsuzluğu.
    • CPU ve/veya bellek üzerinde olası performans etkisini önleme.

2.0.7 (20 Mart 2019)

Önemli hata düzeltmeleri

  • Backport şu işlemlerin applicationInsights bağımlılığını kaldırır:
    • Bağımlılıkların kirletilmesi riski.
    • Java 11 uyumsuzluğu.
    • CPU ve/veya bellek üzerinde olası performans etkisini önleme.

2.1.1 (7 Mart 2019)

Yeni özellikler

  • Ana sürümü 2.1.1'e Güncelleştirmeler.

2.0.6 (7 Mart 2019)

Yeni özellikler

  • Telemetriden gelen tüm özel durumları yoksayın.

2.1.0 (17 Aralık 2018)

Yeni özellikler

  • Sorunu gidermek için 2.1.0 sürümüne Güncelleştirmeler.

2.0.5 (13 Eylül 2018)

Yeni özellikler

  • ve startsWithanahtar sözcükleri exists ekler.
  • Benioku'Güncelleştirmeler.

Önemli hata düzeltmeleri

  • "Varlık için self href doğrudan çağrılamıyor" hatasını düzeltir.
  • "koleksiyon oluşturulmazsa findAll başarısız olur" düzeltmeleri

2.0.4 (Yayın Öncesi) (23 Ağustos 2018)

Yeni özellikler

  • Paketi documentdb'den cosmosdb'ye yeniden adlandırır.
  • Sorgu yöntemi anahtar sözcüğünü yeni özelliği ekler. NoSQL için API'den 16 anahtar sözcük artık desteklenmektedir.
  • Disk belleği ve sıralama ile sorgunun yeni özelliğini ekler.
  • spring-data-cosmosdb yapılandırmasını basitleştirir.
  • Ekler deleteCollection ve deleteAll API'ler.

Önemli hata düzeltmeleri

  • Hata düzeltmesi ve hata azaltma.

SSS

SDK'nın kullanımdan kaldırıldığı bana nasıl bildirilir?

Microsoft desteklenen SDK'ya sorunsuz geçişi kolaylaştırmak için kullanımdan kaldırılan SDK'nın destek sonundan 12 ay önce bildirimde bulunacak. Size bu durumu çeşitli iletişim kanallarıyla bildireceğiz: Azure portal, Azure güncelleştirmeleri ve atanan hizmet yöneticilerine doğrudan iletişim.

12 aylık dönem boyunca, kullanımdan kaldırılacak olan Azure Cosmos DB SDK'sını kullanarak uygulama yazabilir miyim?

Evet, 12 aylık bildirim dönemi boyunca kullanımdan kaldırılacak olan Azure Cosmos DB SDK'sını kullanarak uygulamaları yazabilir, dağıtabilir ve değiştirebilirsiniz. 12 aylık bildirim dönemi boyunca, uygun olduğunda Azure Cosmos DB SDK'sının desteklenen daha yeni bir sürümüne geçmenizi öneririz.

Kullanımdan kaldırma tarihinden sonra, desteklenmeyen Azure Cosmos DB SDK'sını kullanan uygulamalara ne olur?

Kullanımdan kaldırma tarihinden sonra Azure Cosmos DB artık kullanımdan kaldırılan SDK sürümlerinde hata düzeltmeleri yapmayacak, yeni özellikler eklemeyecek veya destek sağlamayacak. Yükseltmemeyi tercih ederseniz, SDK'nın kullanımdan kaldırılan sürümlerinden gönderilen isteklere Azure Cosmos DB hizmeti tarafından yanıt verilmeye devam edilecektir.

Hangi SDK sürümleri en son özellikleri ve güncelleştirmeleri içerecek?

Yeni özellikler ve güncelleştirmeler yalnızca desteklenen en son ana SDK sürümünün en son alt sürümüne eklenecek. Yeni özelliklerden, performans geliştirmelerinden ve hata düzeltmelerinden yararlanmak için her zaman en son sürümü kullanmanızı öneririz. SDK'nın eski ama kullanımdan kaldırılmamış bir sürümünü kullanıyorsanız, Azure Cosmos DB'ye yönelik istekleriniz çalışmaya devam eder ama yeni özelliklerin hiçbirine erişemezsiniz.

Uygulamamı belirli bir kesme tarihinden önce güncelleştiremezsem ne yapmalıyım?

Mümkün olan en kısa zamanda en son SDK'ya yükseltmenizi öneririz. SDK kullanımdan kaldırılmak üzere etiketlendikten sonra, uygulamanızı güncelleştirmek için 12 ayınız olacak. Kullanımdan kaldırma tarihine kadar güncelleştiremezseniz, SDK'nın kullanımdan kaldırılan sürümlerinden gönderilen isteklere Azure Cosmos DB tarafından yanıt verilmeye devam edecek, dolayısıyla çalışan uygulamalarınızda işlev kaybı olmayacak. Ama Azure Cosmos DB artık kullanımdan kaldırılan SDK sürümlerinde hata düzeltmeleri yapmayacak, yeni özellikler eklemeyecek veya destek sağlamayacak.

Destek planınız varsa ve teknik desteğe gerek duyuyorsanız, bir destek bileti doldurarak bizimle iletişime geçin.

Sdk veya bağlayıcıya özelliklerin eklenmesini nasıl isteyebilirim?

Yeni özellikler her zaman her SDK'ya veya bağlayıcıya hemen eklenmez. Eklenmesini istediğiniz desteklenmeyen bir özellik varsa lütfen topluluk forumumuza geri bildirim ekleyin.

Sonraki adımlar

Azure Cosmos DB hakkında daha fazla bilgi edinin.

Spring Framework hakkında daha fazla bilgi edinin.

Spring Boot hakkında daha fazla bilgi edinin.

Spring Data hakkında daha fazla bilgi edinin.