NoSQL için Azure Cosmos DB Java SDK'sı (eski): Sürüm notları ve kaynakları

UYGULANANLAR: NoSQL

Bu makale, NoSQL IÇIN API için Azure Cosmos DB Eşitleme Java SDK v2'yi kapsar. Bu API yalnızca zaman uyumlu işlemleri destekler.

Sürüm notları

SDK'nın her sürümü için sürüm notları aşağıdadır.

2.6.5

• Güvenlik açıkları nedeniyle test bağımlılığı com.google.guava/guava kaldırıldı
• Bağımlılık com.fasterxml.jackson.core/jackson-databind 2.14.0'a yükseltildi
• Bağımlılık commons-codec/commons-codec 1.15'e yükseltildi
• org.json/json bağımlılığı 20180130 yükseltildi

2.6.4

• Okuma zaman aşımları için yeniden deneme ilkesi düzeltildi

2.6.3

• içinde sarmalandığında GoneException IllegalStateException bir yeniden deneme ilkesi düzeltildi - Spark bağlayıcısının (Spark 2.4 için) bölüm bölmeleri sırasında sorguların başarılı olması için özel bir yeniden deneme ilkesi kullanabilmesi için Ağ Geçidi önbelleğinin 410'da yenilendiğinden emin olmak için bu değişiklik gereklidir

2.6.2

• Okuma Zaman Aşımlarını yeniden denemek için yeni bir yeniden deneme ilkesi eklendi
• Bağımlılık com.fasterxml.jackson.core/jackson-databind 2.9.10.8'e yükseltildi
• Bağımlılık org.apache.httpcomponents/httpclient 4.5.13'e yükseltildi

2.6.1

• Hizmet birlikte çalışma aracılığıyla bir sorguyu işlemede bir hata düzeltildi.

2.6.0

• Zaman içinde belirli bir noktadan değişiklik akışını sorgulama desteği eklendi.

2.5.1

• documentCollection sorgusundaki birincil bölüm önbelleği sorununu düzeltir.

2.5.0

• 449 özel yapılandırmayı yeniden deneme desteği eklendi.

2.4.7

• Bağlantı havuzu zaman aşımı sorununu düzeltir.
• İç yeniden denemelerde kimlik doğrulama belirteci yenilemesi düzeltildi.

2.4.6

• databaseAccount üzerinde doğru istemci tarafı çoğaltma ilkesi etiketi güncelleştirildi ve databaseAccount yapılandırmasının önbellekten okunmasını sağladı.

2.4.5

• Kullanıcı pkRangeId sağlıyorsa, bu sürüm geçersiz bölüm anahtarı aralığı hatasında yeniden denemeyi önler

2.4.4

• İyileştirilmiş bölüm anahtarı aralığı önbellek yenilemeleri.
• SDK'nın sunucudan bölüm bölme ipucunu eğlendirmediği ve yanlış istemci tarafı yönlendirme önbelleklerinin yenilenmesine neden olduğu senaryoyu düzeltir.

2.4.2

• İyileştirilmiş koleksiyon önbelleği yenilemeleri.

2.4.1

• İstek tanılama dizesinden iç özel durum iletisini alma desteği eklendi.

2.4.0

• PartitionKeyDefinition'da sürüm API'si kullanıma sunulmuştur.

2.3.0

• Doğrudan mod için ayrı zaman aşımı desteği eklendi.

2.2.3

• Hizmetten null hata iletisi kullanma ve belge istemcisi özel durumu oluşturma.

2.2.2

• SoKeepAlive varsayılan true değerini ekleyerek yuva bağlantısı geliştirmesi.

2.2.0

• İstek tanılama dizesi desteği eklendi.

2.1.3

• Karma V2 için PartitionKey'deki hata düzeltildi.

2.1.2

• Bileşik dizinler için destek eklendi.
• Yenilemeyi zorlamak için genel uç nokta yöneticisindeki hata düzeltildi.
• Doğrudan modda önkoşulları olan upsert işlemleri için hata düzeltildi.

2.1.1

• Ağ geçidi adres önbelleğindeki hata düzeltildi.

2.1.0

• Doğrudan mod için çok bölgeli yazma desteği eklendi.
• Bir proxy'den özel durum olarak ServiceUnavailable oluşan işleme IOExceptions desteği eklendi.
• Uç nokta bulma yeniden deneme ilkesindeki bir hata düzeltildi.
• BaseDatabaseAccountConfigurationProvider'da null işaretçi özel durumlarının oluşturulmasını sağlamaya yönelik bir hata düzeltildi.
• QueryIterator'ın null döndürmediğinden emin olmak için bir hata düzeltildi.
• Büyük PartitionKey'e izin verildiğinden emin olmak için bir hata düzeltildi.

2.0.0

• Ağ geçidi modu için çok bölgeli yazma desteği eklendi.

1.16.4

• Sorgu için Bölüm Anahtarı aralıklarını okuma bölümündeki bir hata düzeltildi.

1.16.3

• DirectHttps modunda devamlılık belirteci üst bilgi boyutunu ayarlamaya yönelik bir hata düzeltildi.

1.16.2

• Akış yük devretme desteği eklendi.
• Özel meta veriler için destek eklendi.
• Geliştirilmiş oturum işleme mantığı.
• Bölüm anahtarı aralığı önbelleğindeki bir hata düzeltildi.
• Doğrudan modda bir NullPointerException (NPE) hatası düzeltildi.

1.16.1

• Benzersiz Dizin desteği eklendi.
• Akış seçeneklerinde devamlılık belirteci boyutunu sınırlama desteği eklendi.
• Json Serileştirme (zaman damgası) hatası düzeltildi.
• Json Serileştirme (numaralandırma) hatası düzeltildi.
• com.fasterxml.jackson.core:jackson-databind bağımlılığı 2.9.5 sürümüne yükseltildi.

1.16.0

• Doğrudan Mod için Geliştirilmiş Bağlantı Havuzu.
• Sıralı olmayan çapraz bölüm sorgusu için gelişmiş ön oluşturma iyileştirmesi.
• Geliştirilmiş UUID oluşturma.
• Geliştirilmiş Oturum tutarlılığı mantığı.
• Çok kutuplu için destek eklendi.
• Koleksiyon için Bölüm Anahtarı Aralığı İstatistikleri desteği eklendi.
• Çok bölgeli destekte bir hata düzeltildi.

1.15.0

• Geliştirilmiş Json Serileştirme performansı.
• Bu SDK sürümü, Azure Cosmos DB Öykünücüsü'nin en son sürümünü gerektirir.

1.14.0

• Microsoft arkadaş kitaplıkları için iç değişiklikler.

1.13.0

• Tek bölüm anahtarı aralıklarını okumayla ilgili bir sorun düzeltildi.
• ResourceID ayrıştırmada veritabanını kısa adlarla etkileyen bir sorun düzeltildi.
• Bölüm anahtarı kodlamasına bağlı bir sorun düzeltildi.

1.12.0

• Bölüm bölmeleri sırasında işleme isteğinde kritik hata düzeltmeleri.
• Strong ve BoundedStaleness tutarlılık düzeyleriyle ilgili bir sorun düzeltildi.

1.11.0

• ConsistentPrefix adlı yeni bir tutarlılık düzeyi desteği eklendi.
• Oturum modunda koleksiyon okuma sırasında oluşan bir hata düzeltildi.

1.10.0

• 2.500 RU/sn'ye kadar düşük ve 100 RU/sn'lik artışlarla ölçeklendirilen bölümlenmiş koleksiyon desteği etkinleştirildi.
• Bazı sorgularda NullRef özel duruma neden olabilen yerel derlemedeki bir hatayı düzeltir.

1.9.6

• Sorgu altyapısı yapılandırmasında Ağ Geçidi modunda sorgular için özel durumlara neden olabilecek bir hata düzeltildi.
• Oturum kapsayıcısında koleksiyon oluşturulduktan hemen sonra istekler için "Sahip kaynağı bulunamadı" özel durumuna neden olabilecek birkaç hata düzeltildi.

1.9.5

• Toplama sorguları (COUNT, MIN, MAX, SUM ve AVG) için destek eklendi.
• Değişiklik akışı desteği eklendi.
• RequestOptions.setPopulateQuotaInfo aracılığıyla toplama kotası bilgileri için destek eklendi.
• RequestOptions.setScriptLoggingEnabled aracılığıyla saklı yordam betiği günlüğü için destek eklendi.
• Kısıtlama hatalarıyla karşılaşıldığında DirectHttps modundaki sorguların yanıt vermemesine neden olan bir hata düzeltildi.
• Oturum tutarlılığı modunda bir hata düzeltildi.
• İstek oranı yüksek olduğunda HttpContext içinde NullReferenceException'a neden olabilecek bir hatayı düzeltir.
• DirectHttps modunun performansı iyileştirildi.

1.9.4

• ConnectionPolicy.setProxy() API'si ile basit istemci örneği tabanlı proxy desteği eklendi.
• DocumentClient örneğini düzgün kapatmak için DocumentClient.close() API'sini ekledik.
• Sorgu planını Ağ Geçidi yerine yerel derlemeden türeterek doğrudan bağlantı modunda sorgu performansı iyileştirildi.
• Kullanıcıların Düz Eski Java Nesnelerinde (POJO) JsonIgnoreProperties tanımlaması gerekmeyecek şekilde FAIL_ON_UNKNOWN_PROPERTIES = false değerini ayarlayın.
• SLF4J kullanmak için günlüğe kaydetme yeniden düzenlenmiş.
• Tutarlılık okuyucudaki diğer birkaç hata düzeltildi.

1.9.3

• Doğrudan bağlantı modunda bağlantı sızıntılarını önlemek için bağlantı yönetimindeki bir hata düzeltildi.
• TOP sorgusunda NullReference özel durumu oluşturabileceği bir hata düzeltildi.
• İç önbellekler için ağ çağrılarının sayısını azaltarak performans iyileştirildi.
• Daha iyi sorun giderme için DocumentClientException'da durum kodu, ActivityID ve İstek URI'si eklendi.

1.9.2

• Bağlantı yönetiminde kararlılık sorunu düzeltildi.

1.9.1

• BoundedStaleness tutarlılık düzeyi desteği eklendi.
• Bölümlenmiş koleksiyonlar için CRUD işlemleri için doğrudan bağlantı desteği eklendi.
• SQL ile veritabanını sorgulamaya yönelik bir hata düzeltildi.
• Oturum önbelleğinde oturum belirtecinin yanlış ayarlanabileceği bir hata düzeltildi.

1.9.0

• Bölümler arası paralel sorgular için destek eklendi.
• Bölümlenmiş koleksiyonlar için TOP/ORDER BY sorguları için destek eklendi.
• Güçlü tutarlılık desteği eklendi.
• Doğrudan bağlantı kullanılırken ad tabanlı istekler için destek eklendi.
• ActivityId'nin tüm istek yeniden denemeleri arasında tutarlı kalması için düzeltildi.
• Aynı ada sahip bir koleksiyon yeniden oluştururken oturum önbelleğiyle ilgili bir hata düzeltildi.
• Uzamsal sorguların coğrafi olarak eskrilmesi için koleksiyon dizin oluşturma ilkesi belirtilirken Polygon ve LineString DataTypes eklendi.
• Java 1.8 için Java Doc ile ilgili sorunlar düzeltildi.

1.8.1

• PartitionKeyDefinitionMap'te tek bölüm koleksiyonlarını önbelleğe alma ve fazladan getirme bölüm anahtarı istekleri yapmama hatası düzeltildi.
• Yanlış bir bölüm anahtarı değeri sağlandığında yeniden denememe hatası düzeltildi.

1.8.0

• Çok bölgeli veritabanı hesapları için destek eklendi.
• Azaltılan isteklerde en fazla yeniden deneme denemesi ve maksimum yeniden deneme bekleme süresini özelleştirme seçenekleriyle otomatik yeniden deneme desteği eklendi. Daha fazla bilgi için bkz. RetryOptions ve ConnectionPolicy.getRetryOptions().
• IPartitionResolver tabanlı özel bölümleme kodu kullanım dışı bırakıldı. Daha yüksek depolama ve aktarım hızı için bölümlenmiş koleksiyonları kullanın.

1.7.1

• Hız sınırlama için yeniden deneme ilkesi desteği eklendi.

1.7.0

• Belgeler için yaşam süresi (TTL) desteği eklendi.

1.6.0

• Bölümlenmiş koleksiyonlar ve kullanıcı tanımlı performans düzeyleri uygulandı.

1.5.1

• HashPartitionResolver'da diğer yazılım geliştirme setleriyle (SDK) tutarlı olması için little-endian'da karma değerler oluşturma hatası düzeltildi.

1.5.0

• Birden çok bölüm arasında uygulama parçalama konusunda yardımcı olması için Karma ve Aralık bölüm çözümleyicileri ekleyin.

1.4.0

• Upsert uygulama. Upsert özelliğini desteklemek için yeni upsertXXX yöntemleri eklendi.
• Kimlik Tabanlı Yönlendirme uygulama. Genel API değişikliği yok, tüm değişiklikler dahili.

1.3.0

• Sürüm numarasını diğer SDK'larla uyumlu hale getirmek için sürüm atlandı

1.2.0

• Jeo-uzamsal dizini destekler.
• Tüm kaynaklar için Id özelliğini doğrular. Kaynakların kimlikleri , , /, #, \, karakterleri içeremez ?veya boşlukla bitemez.
• ResourceResponse'a yeni üst bilgi "dizin dönüştürme ilerlemesi" ekler.

1.1.0

• V2 dizin oluşturma ilkesini uygular

1.0.0

• GA SDK

Sürüm ve kullanımdan kaldırma tarihleri

Microsoft, daha yeni/desteklenen bir sürüme geçişi düzeltmek için SDK'nın kullanımdan kaldırılmasından en az 12 ay önce bildirim sağlar. Yeni özellikler, işlevler ve iyileştirmeler yalnızca geçerli SDK'ya eklenir. Her zaman en son SDK sürümüne mümkün olduğunca erken yükseltmenizi öneririz.

Sık Sorulan Sorular

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.