Bagikan melalui

Azure Cosmos DB for NoSQL: Contoh Spring Data Azure Cosmos DB v5

  • Artikel

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 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 .

Task 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.

Task 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.