Membuat database di Azure Cosmos DB untuk NoSQL menggunakan .NET

Artikel
08/15/2024

BERLAKU UNTUK: NoSQL

Database di Azure Cosmos DB adalah unit manajemen untuk satu kontainer atau lebih. Sebelum dapat membuat atau mengelola kontainer, Anda harus membuat database terlebih dahulu.

Memberi nama database

Di Azure Cosmos DB, database dianalogikan dengan namespace layanan. Saat Anda membuat database, nama database membentuk segmen URI yang digunakan untuk mengakses sumber daya database dan sumber daya turunan apa pun.

Berikut beberapa aturan cepat saat memberi nama database:

Nama database tidak boleh kosong.
Nama database tidak boleh lebih panjang dari 256 karakter.

Setelah dibuat, URI untuk database berada dalam format ini:

https://<cosmos-account-name>.documents.azure.com/dbs/<database-name>

Tip

Untuk informasi selengkapnya tentang batas nama database, lihat kuota dan batas layanan

Membuat database

Untuk membuat database, panggil salah satu metode berikut:

CreateDatabaseAsync
CreateDatabaseIfNotExistsAsync

Membuat database secara asinkron

Contoh berikut membuat database secara asinkron:

// New instance of Database class referencing the server-side database
Database database1 = await client.CreateDatabaseAsync(
    id: "adventureworks-1"
);

Metode ini CosmosClient.CreateDatabaseAsync melemparkan pengecualian jika database dengan nama yang sama sudah ada.

Membuat database secara asinkron jika belum ada

Contoh berikut membuat database secara asinkron hanya jika database tersebut belum ada di akun:

// New instance of Database class referencing the server-side database
Database database2 = await client.CreateDatabaseIfNotExistsAsync(
    id: "adventureworks-2"
);

Metode CosmosClient.CreateDatabaseIfNotExistsAsync ini hanya membuat database baru jika belum ada. Metode ini berguna untuk menghindari kesalahan jika Anda menjalankan kode yang sama beberapa kali.

Mengurai respons

Dalam semua contoh sejauh ini, respons dari permintaan asinkron segera ditransmisikan ke jenis Database. Anda mungkin ingin mengurai metadata tentang respons termasuk header dan kode status HTTP. Jenis pengembalian true untuk metode CosmosClient.CreateDatabaseAsync dan CosmosClient.CreateDatabaseIfNotExistsAsync adalah DatabaseResponse.

Contoh berikut menunjukkan metode CosmosClient.CreateDatabaseIfNotExistsAsync yang mengembalikan DatabaseResponse. Setelah dikembalikan, Anda dapat mengurai properti respons, kemudian pada akhirnya mendapatkan objek Database yang mendasar:

// New instance of Database response class referencing the server-side database
DatabaseResponse response = await client.CreateDatabaseIfNotExistsAsync(
    id: "adventureworks-3"
);
// Parse additional response properties
Database database3 = response.Database;

Langkah berikutnya

Sekarang setelah Anda membuat database, gunakan panduan berikutnya untuk membuat kontainer.

Membuat kontainer

Bagikan melalui