Menghubungkan ke akun online

  • 9 menit

Setelah pustaka Microsoft.Azure.Cosmos diimpor, Anda dapat mulai menggunakan namespace layanan dan kelas dalam proyek .NET Anda.

Mengimpor namespace layanan

Sebelum menggunakan pustaka, Anda harus mengimpor namespace Microsoft.Azure.Cosmos menggunakan arahan. using directive memungkinkan Anda menggunakan tipe di dalam namespace layanan tanpa dipaksa untuk sepenuhnya memenuhi syarat setiap jenis.

using Microsoft.Azure.Cosmos;

Menggunakan kelas CosmosClient

Dua cara paling umum untuk membuat instans untuk kelas CosmosClient adalah dengan membuat instans dengan salah satu dari dua konstruktor berikut:

  • Konstruktor yang mengambil nilai string tunggal yang mewakili string koneksi untuk akun.
  • Konstruktor yang mengambil dua nilai string yang mewakili titik akhir dan kunci untuk akun.

Catatan

Anda selalu dapat mengambil string koneksi, titik akhir, atau salah satu kunci dari portal Azure. Untuk contoh di bagian ini, kami akan menggunakan titik akhir fiktif https­://dp420.documents.azure.com:443/ dan kunci sampel fDR2ci9QgkdkvERTQ==.

Tip

Anda juga dapat menggunakan kelas CosmosClient dengan Platform Identitas Microsoft secara langsung untuk autentikasi ID Microsoft Entra, tetapi itu di luar cakupan modul ini.

Menggunakan dengan string koneksi

Kelas CosmosClient memiliki konstruktor yang hanya membutuhkan satu nilai string. Berikan string koneksi akun untuk menggunakan konstruktor ini. Contoh ini menggunakan string koneksi dalam format AccountEndpoint=<account-endpoint>;AccountKey=<account-key> dengan titik akhir dan kunci fiktif.

string connectionString = "AccountEndpoint=https­://dp420.documents.azure.com:443/;AccountKey=fDR2ci9QgkdkvERTQ==";

CosmosClient client = new (connectionString);

Menggunakan dengan titik akhir dan kunci

Atau, Anda dapat menggunakan konstruktor kelas CosmosClient yang menggunakan dua parameter string yang mewakili endpoint dan key akun dalam urutan tersebut. Contoh ini menggunakan titik akhir dan kunci fiktif.

string endpoint = "https­://dp420.documents.azure.com:443/";
string key = "fDR2ci9QgkdkvERTQ==";

CosmosClient client = new (endpoint, key);

Membaca properti akun

Tip

Pada titik ini, Anda hanya memiliki representasi sisi klien logis dari akun Azure Cosmos DB for NoSQL. SDK awalnya tidak akan terhubung ke akun sampai Anda melakukan operasi.

Setelah instans klien digunakan, Anda dapat menggunakan berbagai metode secara langsung. Misalnya, Anda dapat memanggil metode ReadAccountAsync secara asinkron untuk mendapatkan objek dengan jenis AccountProperties dengan berbagai properti.

AccountProperties account = await client.ReadAccountAsync();

Kelas AccountProperties mencakup properti yang berguna seperti, namun tidak terbatas pada:

Properti Keterangan
Id Mendapatkan nama akun yang unik
ReadableRegions Mendapat daftar lokasi yang dapat dibaca untuk akun
WritableRegions Mendapat daftar lokasi yang dapat ditulis untuk akun
Konsistensi Mendapatkan tingkat konsistensi default untuk akun

Berinteraksi dengan database

Setelah memiliki instans klien, Anda dapat mengambil atau membuat database menggunakan salah satu dari tiga metode:

  • Mengambil database yang ada menggunakan nama
  • Membuat database baru dengan memasukkan nama database yang unik
  • Meminta SDK memeriksa keberadaan database dan membuat atau mengambilnya secara otomatis

Salah satu dari ketiga metode ini akan mengembalikan instans jenis Database yang dapat Anda gunakan untuk berinteraksi dengan database.

Mengambil database yang ada

Database database = client.GetDatabase("cosmicworks");

Buat database baru

Database database = await client.CreateDatabaseAsync("cosmicworks");

Membuat database jika belum ada

Database database = await client.CreateDatabaseIfNotExistsAsync("cosmicworks");

Berinteraksi dengan kontainer

Setelah memiliki instans DB, Anda dapat mengambil atau membuat kontainer menggunakan salah satu dari tiga metode:

  • Mengambil kontainer yang ada hanya menggunakan namanya
  • Membuat kontainer baru dengan memasukkan nama kontainer unik, jalur kunci partisi, dan jumlah throughput untuk penyediaan secara manual
  • Minta SDK memeriksa keberadaan kontainer dan membuat atau mengambilnya secara otomatis

Salah satu dari ketiga metode ini akan mengembalikan instans jenis Container yang dapat Anda gunakan untuk berinteraksi dengan kontainer.

Mengambil kontainer yang sudah ada

Container container = database.GetContainer("products");

Membuat kontainer baru

Container container = await database.CreateContainerAsync(
    "products", 
    "/categoryId", 
    400
);

Membuat kontainer jika belum ada

Container container = await database.CreateContainerIfNotExistsAsync(
    "products", 
    "/categoryId", 
    400
);