Azure Cosmos DB for NoSQL: Contoh Spring Data Azure Cosmos DB v5
BERLAKU UNTUK: NoSQL
Penting
Catatan rilis ini untuk versi 5 Spring Data Azure Cosmos DB. Anda dapat menemukan catatan rilis untuk versi 3 di sini, dan versi 2 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:
Penting
Jika Anda tidak memiliki Langganan Azure, buat Akun gratis Azure sebelum memulai.
- Anda dapat mengaktifkan keuntungan pelanggan Visual Studio: Langganan Visual Studio Anda memberi Anda kredit setiap bulan yang dapat Anda gunakan untuk layanan Azure berbayar.
Anda dapat mencoba Azure Cosmos DB secara gratis, tanpa langganan Azure, dan tanpa penerapan. Atau, Anda dapat membuat akun tingkat gratis Azure Cosmos DB dengan 1000 RU/dtk dan penyimpanan 25 GB pertama secara gratis. Anda juga dapat menggunakan emulator Azure Cosmos DB dengan URI https://localhost:8081
. Agar kunci dapat digunakan dengan emulator, lihat Mengautentikasi permintaan.
Aplikasi sampel terbaru yang melakukan operasi CRUD dan operasi umum lainnya pada sumber daya Azure Cosmos DB disertakan dalam repositori GitHub azure-spring-boot-samples . Artikel ini menyediakan:
- Menautkan ke tugas di setiap contoh file proyek Data Spring Azure Cosmos DB.
- Tautan ke konten referensi API terkait.
Prasyarat
Anda memerlukan hal berikut ini untuk menjalankan aplikasi sampel ini:
- Kit Pengembangan Java 8
- Spring Data Azure Cosmos DB v5
Anda dapat secara opsional menggunakan Maven untuk mendapatkan biner Data Spring Azure Cosmos DB v3 terbaru untuk digunakan dalam proyek Anda. Maven secara otomatis menambahkan dependensi yang diperlukan. Jika tidak, Anda dapat langsung mengunduh dependensi yang tercantum pom.xml file dan menambahkannya ke jalur build Anda.
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-spring-data-cosmos</artifactId>
<version>LATEST</version>
</dependency>
Menjalankan aplikasi sampel
Mengkloning repo sampel:
$ git clone https://github.com/Azure-Samples/azure-spring-boot-samples
$ cd cosmos/azure-spring-data-cosmos/spring3-samples/cosmos-quickstart-samples
Anda dapat menjalankan sampel menggunakan IDE (Eclipse, IntelliJ, atau VS Code) atau dari baris perintah menggunakan Maven.
Dalam application.properties variabel lingkungan ini harus diatur
cosmos.uri=${ACCOUNT_HOST}
cosmos.key=${ACCOUNT_KEY}
cosmos.secondaryKey=${SECONDARY_ACCOUNT_KEY}
dynamic.collection.name=spel-property-collection
# Populate query metrics
cosmos.queryMetricsEnabled=true
untuk memberikan sampel akses baca/tulis ke akun, database, dan kontainer Anda.
IDE Anda dapat memberikan kemampuan untuk menjalankan kode sampel Data Spring. Jika tidak, Anda dapat menggunakan perintah terminal berikut untuk mengeksekusi sampel:
mvn spring-boot:run
Contoh CRUD dokumen
File sampel memperlihatkan cara melakukan tugas berikut. Untuk mempelajari tentang dokumen Azure Cosmos DB sebelum menjalankan sampel berikut, lihat Artikel konseptual Bekerja dengan database, kontainer, dan item .
Tugas | Referensi API |
---|---|
Membuat dokumen | CosmosRepository.save |
Baca dokumen menurut ID | CosmosRepository.derivedQueryMethod |
Menghapus semua dokumen | CosmosRepository.deleteSemua |
Contoh metode kueri yang diperoleh
File sampel memperlihatkan cara melakukan tugas berikut. Untuk mempelajari tentang kueri Azure Cosmos DB sebelum menjalankan sampel berikut, Anda mungkin merasa berguna untuk membaca Metode Kueri Turunan Baeldung di artikel Musim Semi.
| Kueri untuk dokumen | CosmosRepository.derivedQueryMethod |
Contoh kueri kustom
File sampel memperlihatkan cara melakukan tugas berikut menggunakan tata bahasa kueri SQL. Untuk mempelajari tentang referensi kueri SQL di Azure Cosmos DB sebelum Anda menjalankan contoh berikut, lihat contoh kueri SQL untuk Azure Cosmos DB.
Tugas | Referensi API |
---|---|
Kueri untuk semua dokumen | @Query anotasi |
Kueri untuk kesetaraan menggunakan == | @Query anotasi |
Kueri untuk kesetaraan menggunakan == | @Query anotasi |
Kueri menggunakan operator rentang seperti >, <, >=, <= | @Query anotasi |
Kueri menggunakan operator rentang terhadap string | @Query anotasi |
Kueri dengan URUTAN BERDASARKAN | @Query anotasi |
Kueri dengan BERBEDA | @Query anotasi |
Kueri dengan fungsi agregat | @Query anotasi |
Bekerja dengan subdokumen | @Query anotasi |
Kueri dengan Gabungan intra-dokumen | @Query anotasi |
Kueri dengan operator string, matematika, dan array | @Query anotasi |
Langkah berikutnya
Mencoba melakukan perencanaan kapasitas untuk migrasi ke Azure Cosmos DB? Anda dapat menggunakan informasi tentang kluster database Anda yang ada saat ini untuk membuat perencanaan kapasitas.
- Jika Anda hanya mengetahui jumlah vcore dan server di kluster database yang ada, baca tentang memperkirakan unit permintaan menggunakan vCore atau vCPU
- Jika Anda mengetahui rasio permintaan umum untuk beban kerja database Anda saat ini, baca memperkirakan unit permintaan menggunakan perencana kapasitas Azure Cosmos DB