Spring Data NoSQL için API için Azure Cosmos DB v3: Sürüm notları ve kaynakları

  • Makale

UYGULANANLAR: NoSQL

Spring Data Azure Cosmos DB sürüm 3 for NoSQL, 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.

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 modeli ve çerçevesidir.

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

Sürüm destek ilkesi

Spring Boot sürüm desteği

Bu proje birden çok Spring Boot Sürümünü destekler. Daha fazla bilgi için spring boot destek ilkesini ziyaret edin. Maven kullanıcıları, Spring'in bağımlılıkların sürümlerini yönetmesine izin vermek üzere bir bağımlılık yönetimi bölümü almak üzere projeden spring-boot-starter-parent devralabilir. Daha fazla bilgi için spring boot sürüm desteğini ziyaret edin.

Spring Data sürüm desteği

Bu proje farklı spring-data-commons sürümlerini destekler. Daha fazla bilgi için spring data version support adresini ziyaret edin.

Azure Spring Data Azure Cosmos DB'nin hangi sürümünü kullanmalıyım?

Azure Spring Data Azure Cosmos DB kitaplığı, Spring Boot /Spring Cloud'un birden çok sürümünü destekler. Spring Boot / Spring Cloud sürümüyle kullanılacak Azure Spring Data Azure Cosmos DB sürümü hakkında ayrıntılı bilgi için azure Spring Data Azure Cosmos DB sürüm eşlemesine bakın.

Önemli

Bu sürüm notları Spring Data Azure Cosmos DB'nin 3. sürümüne yöneliktir.

Azure Spring Data Azure Cosmos DB SDK'sı Spring Data çerçevesine bağımlıdır ve yalnızca NoSQL için API'yi destekler.

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

Hızlı kullanmaya başlama

Spring Boot Starter kılavuzumuzu izleyerek Spring Data Azure Cosmos DB ile çalışmaya başlayın. Spring Boot Starter yaklaşımı, Spring Data Azure Cosmos DB bağlayıcısını kullanmaya başlamanın önerilen yoludur.

Alternatif olarak, aşağıda gösterildiği gibi Spring Data Azure Cosmos DB bağımlılığını dosyanıza pom.xml ekleyebilirsiniz:

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-spring-data-cosmos</artifactId>
    <version>latest-version</version>
</dependency>

Yararlı içerik

İçerik Bağlantı
Sürüm notları Spring Data Azure Cosmos DB SDK v3 sürüm notları
SDK Belgeleri Azure Spring Data Azure Cosmos DB SDK v3 belgeleri
SDK indirmesi Maven
API belgeleri Java API başvuru belgeleri
SDK'ya katkıda bulunma GitHub'da Java Central Deposu için Azure SDK
Başlayın Hızlı Başlangıç: NoSQL için Azure Cosmos DB verilerini yönetmek için Spring Data Azure Cosmos DB uygulaması oluşturma
Hızlı başlangıç kodu ile GitHub deposu
Temel kod örnekleri Azure Cosmos DB: NoSQL API'sine yönelik Spring Data Azure Cosmos DB örnekleri
Örnek kod içeren GitHub deposu
Performans ipuçları Java SDK v4 için performans ipuçları (Spring Data için geçerlidir)
Sorun giderme Java SDK v4 (Spring Data için geçerlidir) sorunlarını giderme
Azure Cosmos DB atölyeleri ve laboratuvarları Azure Cosmos DB atölyelerinin giriş sayfası

Sürüm geçmişi

Sürüm geçmişi azure-sdk-for-java deposunda tutulur. Sürümlerin ayrıntılı listesi için changelog dosyasına bakın.

Sürüm 3.28.1 ve üzerini kullanmanız kesinlikle önerilir.

Ek notlar

  • Spring Data Azure Cosmos DB Java JDK 8, Java JDK 11 ve 3.8.0 ve üzeri Java JDK 17 sürümlerini destekler.

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.