Contoh untuk Azure Cosmos DB untuk NoSQL SDK untuk JS

BERLAKU UNTUK: NoSQL

Solusi sampel yang melakukan operasi CRUD dan operasi umum lainnya pada sumber daya Azure Cosmos DB disertakan dalam SDK JavaScript untuk repositori GitHub Azure Cosmos DB . Artikel ini menyediakan:

  • Tautan ke tugas di setiap file proyek contoh Node.js.
  • Tautan ke konten referensi API terkait.

Prasyarat

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.

Anda juga memerlukan SDK JavaScript.

Catatan

Setiap sampel mandiri, ia mengatur dan membersihkan dirinya sendiri. Dengan demikian, sampel mengeluarkan beberapa panggilan ke Containers.create. Setiap kali hal ini dilakukan, langganan Anda akan ditagih selama 1 jam penggunakan per tingkat performa kontainer yang sedang dibuat.

Contoh database

File DatabaseManagement menunjukkan cara melakukan operasi CRUD pada database. Untuk mempelajari tentang database Azure Cosmos DB sebelum menjalankan sampel berikut, lihat Artikel konseptual bekerja dengan database, kontainer, dan item .

Task Referensi API
Membuat database jika tidak ada Database.createIfNotExists
Mencantumkan database untuk akun Database.readAll
Membaca database menurut ID Database.readAll
Menghapus database Database.delete

Contoh kontainer

File ContainerManagement menunjukkan cara melakukan operasi CRUD pada kontainer. Untuk mempelajari tentang koleksi Azure Cosmos DB sebelum menjalankan sampel berikut, lihat Artikel konseptual Bekerja dengan database, kontainer, dan item .

Task Referensi API
Membuat kontainer jika tidak ada Containers.createIfNotExists
Mencantumkan kontainer untuk akun Container.readAll
Membaca definisi kontainer Container.read
Menghapus kontainer Container.delete

Contoh item

File ItemManagement menunjukkan cara melakukan operasi CRUD pada item. Untuk mempelajari tentang dokumen Azure Cosmos DB sebelum menjalankan sampel berikut, lihat Artikel konseptual Bekerja dengan database, kontainer, dan item .

Task Referensi API
Membuat item Items.create
Membaca semua item dalam kontainer Items.readAll
Membaca item menurut ID Item.read
Membacakan item hanya jika item telah berubah Item.read - RequestOptions.accessCondition
Kueri untuk dokumen Items.query
Mengganti item Item.replace
Menggantikan item dengan pemeriksaan ETag bersyarat Item.replace - RequestOptions.accessCondition
Menghapus item Item.delete

Contoh pengindeksan

File IndexManagement menunjukkan cara mengelola pengindeksan. Untuk mempelajari tentang pengindeksan di Azure Cosmos DB sebelum menjalankan sampel berikut, lihat artikel konseptual kebijakan pengindeksan, jenis pengindeksan, dan jalur pengindeksan.

Task Referensi API
Mengindeks item tertentu secara manual RequestOptions.indexingDirective: 'include'
Mengecualikan item tertentu secara manual dari indeks RequestOptions.indexingDirective: 'include'
Mengecualikan jalur dari indeks IndexingPolicy.ExcludedPath
Membuat indeks rentang pada jalur string IndexKind.Range, IndexingPolicy, Items.query
Buat kontainer dengan indexPolicy default, lalu perbarui kontainer secara online Containers.create

Contoh pemrograman sisi server

File index.ts memperlihatkan cara melakukan tugas berikut. Untuk mempelajari tentang pemrograman Sisi Server di Azure Cosmos DB sebelum menjalankan sampel berikut ini, lihat artikel konseptual Prosedur tersimpan, pemicu, dan fungsi yang ditentukan pengguna.

Task Referensi API
Membuat prosedur tersimpan StoredProcedures.create
Menjalankan prosedur tersimpan StoredProcedures.create
Pembaruan massal dengan prosedur tersimpan StoredProcedures.create

Untuk informasi selengkapnya tentang pemrograman sisi server, lihat Pemrograman sisi server Azure Cosmos DB: Prosedur tersimpan, pemicu database, dan UDF.

Contoh Autentikasi Azure Identity(AAD)

File AADAuth.ts memperlihatkan cara melakukan tugas berikut.

Task Referensi API
Create credential object from @azure/identity API
Meneruskan kredensial ke objek klien dengan kunci aadCredentials API
Jalankan klien cosmos dengan kredensial aad API

Sampel lain-lain

Sampel yang dikumpulkan berikut mengilustrasikan skenario umum.

Task Referensi API
Throughput Ubah Kueri API
Mendapatkan throughput kueri API
menggunakan SasTokens untuk memberikan akses terlingkup ke sumber daya Cosmos DB API

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.