Bagikan melalui

Mulai menggunakan Azure Cosmos DB for Table menggunakan .NET

  • Artikel

BERLAKU UNTUK: Meja

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

Paket (NuGet) | Contoh | Referensi API | Kode sumber pustaka | Berikan Umpan Balik |

Prasyarat

Menyiapkan proyek Anda

Buat aplikasi .NET baru dengan menggunakan perintah dotnet new dengan templat konsol.

dotnet new console

Impor paket NuGet Azure.Data.Tables menggunakan perintah dotnet add package.

dotnet add package Azure.Data.Tables

Buat proyek dengan perintah dotnet build.

dotnet build

Menyambungkan ke Azure Cosmos DB untuk Tabel

Untuk menyambungkan ke API untuk Tabel Azure Cosmos DB, buat instans TableServiceClient kelas . Kelas ini adalah titik awal untuk melakukan semua operasi terhadap tabel.

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

Tempat aplikasi berjalan Prinsip keamanan
Komputer lokal (pengembangan dan pengujian) Identitas pengguna atau perwakilan layanan
Azure Identitas terkelola
Server atau klien di luar Azure Perwakilan layanan

Mengimpor Azure.Identity

Paket NuGet Azure.Identity berisi fungsionalitas autentikasi inti yang dibagikan di antara semua pustaka Azure SDK.

Impor paket NuGet Azure.Identity menggunakan perintah dotnet add package.

dotnet add package Azure.Identity

Bangun kembali proyek dengan perintah dotnet build.

dotnet build

Di editor kode Anda, tambahkan namespace Azure.Core dan Azure.Identity menggunakan arahan.

using Azure.Core;
using 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.

Untuk contoh ini, kami menyimpan instans dalam variabel jenis TokenCredential karena itu adalah jenis yang lebih umum yang dapat digunakan kembali di seluruh SDK.

// Credential class for testing on a local machine or Azure services
TokenCredential credential = new DefaultAzureCredential();

Buat instans baru kelas CosmosClient dengan variabel lingkungan COSMOS_ENDPOINT dan objek TokenCredential sebagai parameter.

// New instance of TableServiceClient class using Microsoft Entra
TableServiceClient client = new(
    endpoint: Environment.GetEnvironmentVariable("COSMOS_ENDPOINT")!,
    tokenCredential: credential
);

Bangun aplikasi Anda

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

  • API untuk akun Table, yang merupakan namespace layanan tingkat atas unik untuk data Azure Cosmos DB Anda.

  • Tabel, yang berisi sekumpulan item individual dalam akun Anda.

  • Item, yang mewakili item individual dalam tabel Anda.

Diagram berikut menunjukkan hubungan antara ketiga sumber daya ini.

Diagram hierarki Azure Cosmos DB termasuk akun, tabel, dan item.

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

Kelas Deskripsi
TableServiceClient Kelas klien ini menyediakan representasi logis sisi klien untuk layanan Azure Cosmos DB. Klien ini digunakan untuk mengonfigurasi dan menjalankan permintaan terhadap layanan.
TableClient Kelas klien ini adalah referensi ke tabel yang mungkin sudah ada, atau mungkin belum ada dalam layanan. Tabel divalidasi di sisi server saat Anda mencoba mengaksesnya atau melakukan operasi terhadapnya.
ITableEntity Antarmuka ini adalah antarmuka dasar untuk item apa pun yang dibuat dalam tabel atau dikueri dari tabel. Antarmuka ini mencakup semua properti yang diperlukan untuk item di API untuk Tabel.
TableEntity Kelas ini adalah implementasi generik antarmuka ITableEntity sebagai kamus pasangan kunci-nilai.

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

Panduan Deskripsi
Buat tabel Membuat tabel
Membuat item Membuat item
Membaca item Membaca item

Lihat juga

Langkah berikutnya

Sekarang setelah Anda tersambung ke API untuk akun Table, gunakan panduan berikutnya untuk membuat dan mengelola tabel.

Membuat tabel di Azure Cosmos DB untuk Tabel menggunakan .NET