Spring Data NoSQL için API için Azure Cosmos DB v3 (eski): Sürüm notları ve kaynaklar
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.
Uyarı
Spring Data Azure Cosmos DB SDK'sının bu sürümü, Spring Boot ve Azure Cosmos DB Java SDK'sının eski bir sürümüne bağlıdı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 V3'teki performans sorunları ve kararlılık nedeniyle projeniz için Azure Spring Data Azure Cosmos DB v5 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 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 Bkz. Azure Spring Data Azure Cosmos DB sürüm eşlemesi.
Ö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
| Content | 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.
Önerilen sürüm
Azure Spring Data Azure Cosmos DB v5'e yükseltmeniz ve önerilen en düşük sürümü ve üzerini kullanmanız kesinlikle önerilir.
Ek notlar
- Spring Data Azure Cosmos DB, Java JDK 8, Java JDK 11'i destekler. Sürüm 3.8.0 ve üzeri Java JDK 17'i de 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.