Bagikan melalui

Spring Data Azure Cosmos DB v2 untuk API untuk NoSQL (warisan): Catatan rilis dan sumber daya

  • Artikel

BERLAKU UNTUK: NoSQL

Spring Data Azure Cosmos DB versi 2 untuk NoSQL memungkinkan pengembang untuk menggunakan Azure Cosmos DB di aplikasi Spring. Spring Data Azure Cosmos DB memaparkan antarmuka Spring Data untuk memanipulasi database dan koleksi, bekerja dengan dokumen, dan menerbitkan kueri. API Sync dan Async (Reaktif) didukung dalam artefak Maven yang sama.

Peringatan

Versi Spring Data Azure Cosmos DB SDK ini bergantung pada versi Azure Cosmos DB Java SDK yang dihentikan. Spring Data Azure Cosmos DB SDK ini akan diumumkan sebagai pensiun dalam waktu dekat! Ini bukan Azure Spring Data Azure Cosmos DB SDK terbaru untuk Azure Cosmos DB dan sudah ketinggalan tahun. Karena masalah performa dan ketidakstabilan di Azure Spring Data Azure Cosmos DB SDK V2, kami sangat menyarankan untuk menggunakan Azure Spring Data Azure Cosmos DB v5 untuk proyek Anda. Untuk melakukan peningkatan, ikuti petunjuk dalam panduan Migrasi ke Azure Cosmos DB Java SDK v4 untuk memahami perbedaan dalam Java SDK V4 yang mendasarinya.

Spring Framework adalah model pemrograman dan konfigurasi yang menyederhanakan pengembangan aplikasi Java. Spring menyederhanakan "pipa" aplikasi menggunakan injeksi dependensi. Banyak pengembang menyukai Spring karena membuat pembangunan dan pengujian aplikasi lebih mudah. Spring Boot memperluas penanganan pipa ini dengan fokus ke pengembangan aplikasi web dan layanan mikro. Spring Data adalah model pemrograman untuk mengakses penyimpanan data seperti Azure Cosmos DB dari konteks aplikasi Spring atau Spring Boot.

Anda dapat menggunakan Spring Data Azure Cosmos DB di aplikasi Anda yang dihosting di Aplikasi Azure Spring.

Penting

Catatan rilis ini untuk versi 2 dari Data Spring Azure Cosmos DB. Anda dapat menemukan catatan rilis untuk versi 3 di sini.

Spring Data Azure Cosmos DB hanya mendukung API untuk NoSQL.

Lihat artikel berikut untuk informasi tentang Spring Data di API Azure Cosmos DB lainnya:

Ingin cepat melaju?

  1. Instal runtime Java minimum yang didukung, JDK 8, sehingga Anda dapat menggunakan SDK.
  2. Buat aplikasi Spring Data Azure Cosmos DB dengan menggunakan starter. Mudah sekali!
  3. Bekerja melalui panduan pengembang Spring Data Azure Cosmos DB, yang membahas permintaan Azure Cosmos DB dasar.

Anda dapat memutar aplikasi Spring Boot Starter dengan cepat menggunakan Spring Initializr!

Sumber

Sumber daya Tautan
Unduhan SDK Maven
Dokumentasi API Dokumentasi rujukan Spring Data Azure Cosmos DB
Berkontribusi ke SDK Repo Spring Data Azure Cosmos DB di GitHub
Spring Boot Starter Pustaka klien Azure Cosmos DB Spring Boot Starter untuk Java
Panduan pengembang Panduan pengembang Spring Data Azure Cosmos DB
Menggunakan Starter Cara menggunakan Spring Boot Starter dengan Azure Cosmos DB untuk NoSQL
Repo GitHub untuk Azure Cosmos DB Spring Boot Starter
Sampel dengan Azure App Service Cara menggunakan Spring dan Azure Cosmos DB dengan App Service di Linux

Riwayat rilis

2.3.0 (21 Mei 2020)

Fitur baru

  • Memperbarui Spring Boot ke versi 2.3.0.

2.2.5 (19 Mei 2020)

Fitur baru

  • Memperbarui Azure Cosmos DB ke versi 3.7.3.

Perbaikan bug kunci

  • Berisi perbaikan kebocoran memori dan peningkatan versi Netty dari Azure Cosmos DB SDK 3.7.3.

2.2.4 (6 April 2020)

Perbaikan bug kunci

  • Memperbaiki bendera allowTelemetry untuk memperhitungkan CosmosDbConfig.
  • Memperbaiki properti TTL pada kontainer.

2.2.3 (25 Februari 2020)

Fitur baru

  • Menambahkan findAll baru dengan API kunci partisi.
  • Memperbarui Azure Cosmos DB ke versi 3.7.0.

Perbaikan bug kunci

  • Memperbaiki collectionName ->containerName.
  • Memperbaiki entityClass dan domainClass ->domainType.
  • Memperbaiki "Koleksi entitas pengembalian yang disimpan oleh repositori alih-alih entitas input."

2.1.10 (25 Februari 2020)

Perbaikan bug kunci

  • Perbaikan backport untuk "Koleksi entitas pengembalian yang disimpan oleh repositori alih-alih entitas input."

2.2.2 (15 Januari 2020)

Fitur baru

  • Memperbarui Azure Cosmos DB ke versi 3.6.0.

Perbaikan bug kunci

2.2.1 (31 Desember 2019)

Fitur baru

  • Memperbarui Azure Cosmos DB ke versi 3.5.0.
  • Menambahkan bidang anotasi untuk mengaktifkan atau menonaktifkan pembuatan koleksi otomatis.
  • Meningkatkan penanganan pengecualian. Mengekspos CosmosClientException sampai CosmosDBAccessException.
  • Mengekspos requestCharge dan activityId sampai ResponseDiagnostics.

Perbaikan bug kunci

  • Pembaruan SDK 3.5.0 memperbaiki "Pengecualian ketika header respons HTTP Azure Cosmos DB lebih besar dari 8192 byte," "ConsistencyPolicy.defaultConsistencyLevel() gagal pada Bounded Staleness dan Consistent Prefix."
  • Memperbaiki perilaku metode findById. Sebelumnya, metode ini kembali kosong jika entitas tidak ditemukan alih-alih memberi pengecualian.
  • Memperbaiki bug ketika pengurutan tidak diterapkan pada halaman berikutnya saat CosmosPageRequest digunakan.

2.1.9 (26 Desember 2019)

Fitur baru

  • Menambahkan bidang anotasi untuk mengaktifkan atau menonaktifkan pembuatan koleksi otomatis.

Perbaikan bug kunci

  • Memperbaiki perilaku metode findById. Sebelumnya, metode ini kembali kosong jika entitas tidak ditemukan alih-alih memberi pengecualian.

2.2.0 (21 Oktober 2019)

Fitur baru

  • Selesaikan dukungan Repositori Azure Cosmos DB Reaktif.
  • Dukungan Metrik Untai dan Kueri Diagnostik Permintaan Azure Cosmos DB.
  • Pembaruan Azure Cosmos DB SDK ke versi 3.3.1.
  • Peningkatan Spring Framework ke versi 5.2.0.RELEASE.
  • Peningkatan Spring Data Commons ke versi 2.2.0.RELEASE.
  • Menambahkan API findByIdAndPartitionKey dan deleteByIdAndPartitionKey.
  • Menghapus dependensi dari azure-documentdb.
  • Mengubah DocumentDB menjadi Azure Cosmos DB.

Perbaikan bug kunci

  • Memperbaiki "Pengurutan melempar pengecualian ketika pageSize kurang dari total item di repositori."

2.1.8 (18 Oktober 2019)

Fitur baru

  • Menghentikan API DocumentDB.
  • Menambahkan API findByIdAndPartitionKey dan deleteByIdAndPartitionKey.
  • Menambahkan penguncian optimis berdasarkan _etag.
  • Mengaktifkan ekspresi SpEL untuk nama koleksi dokumen.
  • Menambahkan ObjectMapper penyempurnaan.

2.1.7 (18 Oktober 2019)

Fitur baru

  • Menambahkan dependensi Azure Cosmos DB SDK versi 3.
  • Menambahkan Repositori Azure Cosmos DB Reaktif.
  • Memperbarui implementasi DocumentDbTemplate untuk menggunakan Azure Cosmos DB SDK versi 3.
  • Menambahkan perubahan konfigurasi lain untuk dukungan Repositori Azure Cosmos DB reaktif.

2.1.2 (19 Maret 2019)

Perbaikan bug kunci

  • applicationInsights Menghapus dependensi untuk:
    • Potensi risiko polusi dependensi.
    • Ketidakcocokan Java 11.
    • Menghindari potensi dampak performa pada CPU dan/atau memori.

2.0.7 (20 Maret 2019)

Perbaikan bug kunci

  • Backport menghapus applicationInsights dependensi untuk:
    • Potensi risiko polusi dependensi.
    • Ketidakcocokan Java 11.
    • Menghindari potensi dampak performa pada CPU dan/atau memori.

2.1.1 (7 Maret 2019)

Fitur baru

  • Memperbarui versi utama ke 2.1.1.

2.0.6 (7 Maret 2019)

Fitur baru

  • Abaikan semua pengecualian dari telemetri.

2.1.0 (17 Desember 2018)

Fitur baru

  • Mempembarui versi ke 2.1.0 untuk mengatasi masalah.

2.0.5 (13 September 2018)

Fitur baru

  • Menambahkan kata kunci exists dan startsWith.
  • Memperbarui Readme.

Perbaikan bug kunci

  • Memperbaiki "Tidak dapat memanggil href langsung untuk Entitas."
  • Memperbaiki "findAll akan gagal jika koleksi tidak dibuat."

2.0.4 (Prarilis) (23 Agustus 2018)

Fitur baru

  • Ganti nama paket dari documentdb ke cosmosdb.
  • Menambahkan fitur baru kata kunci metode kueri. 16 kata kunci dari API untuk NoSQL sekarang didukung.
  • Menambahkan fitur kueri baru dengan pengurutan dan halaman.
  • Menyederhanakan konfigurasi spring-data-cosmosdb.
  • Menambahkan API deleteCollection dan deleteAll.

Perbaikan bug kunci

  • Perbaikan bug dan mitigasi defek.

FAQ

Bagaimana saya akan diberi tahu tentang SDK yang dihentikan?

Microsoft akan memberikan pemberitahuan 12 bulan sebelumnya sebelum akhir dukungan dari SDK yang dihentikan untuk memfasilitasi transisi yang mulus ke SDK yang didukung. Kami akan memberi tahu Anda melalui berbagai saluran komunikasi: portal Azure, pembaruan Azure, dan komunikasi langsung ke administrator layanan yang ditetapkan.

Dapatkah saya membuat aplikasi dengan menggunakan SDK Azure Cosmos DB yang akan dihentikan selama periode 12 bulan?

Ya, Anda akan dapat membuat, menyebarkan, dan mengubah aplikasi dengan menggunakan SDK Azure Cosmos DB yang akan dihentikan selama periode pemberitahuan 12 bulan. Kami menyarankan Anda untuk bermigrasi ke versi terbaru yang didukung dari SDK Azure Cosmos DB selama periode pemberitahuan 12 bulan, sebagaimana mestinya.

Setelah tanggal penghentian, apa yang terjadi pada aplikasi yang menggunakan SDK Azure Cosmos DB yang tidak didukung?

Setelah tanggal penghentian, Azure Cosmos DB tidak akan lagi melakukan perbaikan bug, menambahkan fitur baru, atau memberikan dukungan ke versi SDK yang dihentikan. Jika Anda memilih untuk tidak meningkatkan, permintaan yang dikirim dari versi SDK yang dihentikan akan terus dilayani oleh layanan Azure Cosmos DB.

Versi SDK mana yang akan memiliki fitur dan pembaruan terbaru?

Fitur dan pembaruan baru hanya akan ditambahkan ke versi minor terbaru dari versi SDK utama terbaru yang didukung. Kami menyarankan Anda untuk selalu menggunakan versi terbaru untuk memanfaatkan fitur baru, peningkatan performa, dan perbaikan bug. Jika Anda menggunakan SDK versi lama yang tidak dihentikan, permintaan Anda ke Azure Cosmos DB akan tetap berfungsi, tetapi Anda tidak akan memiliki akses ke kemampuan baru apa pun.

Apa yang harus saya lakukan jika saya tidak dapat memperbarui aplikasi saya sebelum batas waktu?

Kami menyarankan Anda meningkatkan ke SDK terbaru sedini mungkin. Setelah SDK ditandai untuk dihentikan, Anda memiliki waktu 12 bulan untuk memperbarui aplikasi. Jika Anda tidak dapat memperbarui pada tanggal penghentian, permintaan yang dikirim dari versi SDK yang dihentikan akan terus dilayani oleh Azure Cosmos DB, sehingga aplikasi Anda yang sedang berjalan akan terus berfungsi. Tetapi Azure Cosmos DB tidak akan lagi melakukan perbaikan bug, menambahkan fitur baru, atau memberikan dukungan ke versi SDK yang sudah dihentikan.

Jika Anda memiliki rencana dukungan dan memerlukan tim dukungan, hubungi kami dengan mengajukan tiket dukungan.

Bagaimana cara meminta fitur agar ditambahkan ke SDK atau konektor?

Fitur baru tidak selalu ditambahkan ke setiap SDK atau konektor dengan segera. Jika ada fitur tidak didukung yang ingin Anda tambahkan,silakan beri umpan balik ke forum komunitas kami.

Langkah berikutnya

Pelajari lebih lanjut tentang Azure Cosmos DB.

Pelajari lebih lanjut tentang Spring Framework.

Pelajari lebih lanjut tentang Spring Boot.

Pelajari lebih lanjut tentang Spring Data.