Mulai menggunakan Azure Cosmos DB untuk NoSQL menggunakan JavaScript

2025-04-08

BERLAKU UNTUK: NoSQL

Artikel ini memperlihatkan kepada Anda cara menyambungkan ke Azure Cosmos DB for NoSQL menggunakan JavaScript SDK. Setelah tersambung, Anda dapat melakukan operasi pada database, kontainer, dan item.

Paket (npm) | Referensi API | Kode sumber pustaka | Beri Umpan Balik

Prasyarat

Akun Azure dengan langganan aktif. Buat akun secara gratis.
Akun Azure Cosmos DB untuk NoSQL. Buat API untuk akun NoSQL.
Node.js LTS
Azure Command-Line Interface (CLI) atau Azure PowerShell

Menyiapkan proyek lokal Anda

Buat direktori baru untuk proyek JavaScript Anda di shell bash.

mkdir cosmos-db-nosql-javascript-samples && cd ./cosmos-db-nosql-javascript-samples

Buat aplikasi JavaScript baru dengan menggunakan npm init perintah dengan templat konsol .
```
npm init -y
```
Instal dependensi yang diperlukan untuk Azure Cosmos DB untuk NoSQL JavaScript SDK.
```
npm install @azure/cosmos
```

Menyambungkan ke Azure Cosmos DB untuk NoSQL

Untuk menghubungkan ke API NoSQL dari Azure Cosmos DB, buat instans kelas CosmosClient. Kelas ini adalah titik awal untuk melakukan semua operasi terhadap database.

Untuk menyambungkan ke API Anda untuk akun NoSQL menggunakan Microsoft Entra, gunakan prinsip keamanan. Jenis principal yang tepat tergantung pada tempat Anda menghosting kode aplikasi Anda. Tabel di bawah ini berfungsi sebagai panduan referensi singkat.

Tempat aplikasi berjalan	Prinsipal keamanan
Komputer lokal (pengembangan dan pengujian)	Identitas pengguna atau prinsipal layanan
Azure	Identitas terkelola
Server atau klien di luar Azure	Prinsipal Layanan

Mengimpor @azure/identity

Paket npm @azure/identitas berisi fungsionalitas autentikasi inti yang dibagikan di antara semua pustaka Azure SDK.

Import paket npm @azure/identity menggunakan perintah npm install.
```
npm install @azure/identity
```

Di editor kode Anda, tambahkan dependensi.

const { DefaultAzureCredential } = require("@azure/identity");

Membuat CosmosClient dengan implementasi kredensial default

Jika Anda melakukan pengujian pada mesin lokal, atau aplikasi Anda akan berjalan di layanan Azure dengan dukungan langsung untuk identitas terkelola, dapatkan token OAuth dengan membuat instans DefaultAzureCredential. Kemudian buat instans baru kelas CosmosClient dengan COSMOS_ENDPOINT variabel lingkungan dan objek TokenCredential sebagai parameter.

const { CosmosClient } = require("@azure/cosmos");
const { DefaultAzureCredential } = require("@azure/identity");

const credential = new DefaultAzureCredential();

const cosmosClient = new CosmosClient({ 
    endpoint, 
    aadCredentials: credential
});

Bangun aplikasi Anda

Saat Anda membangun aplikasi, kode Anda utamanya akan berinteraksi dengan empat jenis sumber daya:

API untuk akun NoSQL, yang merupakan namespace unik tingkat atas untuk data Azure Cosmos DB Anda.
Database, yang mengatur kontainer di akun Anda.
Kontainer, yang berisi sekumpulan item individual dalam database Anda.
Item, yang mewakili dokumen JSON dalam kontainer Anda.

Diagram berikut menunjukkan hubungan antara ketiga sumber daya ini.

Diagram hierarki Azure Cosmos DB termasuk akun, database, kontainer, dan item.

Setiap jenis sumber daya diwakili oleh satu atau beberapa kelas terkait. Berikut adalah daftar kelas yang paling umum:

Kelas	Deskripsi
`CosmosClient`	Kelas ini menyediakan representasi logis sisi klien untuk layanan Azure Cosmos DB. Objek klien ini digunakan untuk mengonfigurasi dan menjalankan permintaan ke layanan.
`Database`	Kelas ini adalah referensi ke database yang mungkin sudah ada, atau mungkin belum ada dalam layanan. Database divalidasi di sisi server saat Anda mencoba mengaksesnya atau melakukan operasi terhadapnya.
`Container`	Kelas ini adalah referensi ke sebuah kontainer yang mungkin juga belum ada dalam layanan. Kontainer divalidasi di sisi server ketika Anda mencoba untuk menggunakannya.

Panduan berikut menunjukkan cara menggunakan masing-masing kelas ini untuk membangun aplikasi Anda.

Panduan	Deskripsi
Membuat database	Membuat basis data
Membuat kontainer	Membuat kontainer
Membuat dan membaca item	Poin membaca item tertentu
Hasil Kueri	Mengkueri beberapa item

Lihat juga

Langkah berikutnya

Membuat database di Azure Cosmos DB untuk NoSQL menggunakan JavaScript

Bagikan melalui