Ismerkedés az Azure Cosmos DB for Table szolgáltatással a .NET használatával
A KÖVETKEZŐKRE VONATKOZIK: 
Asztal
Ez a cikk bemutatja, hogyan csatlakozhat az Azure Cosmos DB for Table szolgáltatáshoz a .NET SDK használatával. A csatlakozás után műveleteket hajthat végre táblákon és elemeken.
Package (NuGet) | Samples | API reference | Library source code | Give Feedback |
Előfeltételek
- Egy Azure-fiók, aktív előfizetéssel. Fiók ingyenes létrehozása.
- Azure Cosmos DB táblafiókhoz. Hozzon létre egy API-t a Table-fiókhoz.
- .NET 6.0 vagy újabb
- Azure Parancssori felület (CLI) vagy Azure PowerShell
A projekt beállítása
Hozzon létre egy új .NET-alkalmazást a dotnet new konzolsablon parancsával.
dotnet new console
Importálja az Azure.Data.Tables NuGet-csomagot a dotnet add package paranccsal.
dotnet add package Azure.Data.Tables
Hozza létre a projektet a dotnet build paranccsal.
dotnet build
Csatlakozás az Azure Cosmos DB for Table szolgáltatáshoz
Az Azure Cosmos DB Table API-hoz való csatlakozáshoz hozza létre az osztály egy példányát TableServiceClient . Ez az osztály a táblákon végzett összes művelet kiindulópontja.
Ha a Microsoft Entra használatával szeretne csatlakozni a NoSQL-fiókhoz készült API-hoz, használjon egy egyszerű biztonsági nevet. Az egyszerűség pontos típusa attól függ, hogy hol tárolja az alkalmazás kódját. Az alábbi táblázat rövid útmutatóként szolgál.
| Az alkalmazás futtatásának helye | Rendszerbiztonsági tag |
|---|---|
| Helyi gép (fejlesztés és tesztelés) | Felhasználói identitás vagy szolgáltatásnév |
| Azure | Felügyelt identitás |
| Azure-on kívüli kiszolgálók vagy ügyfelek | Szolgáltatásnév |
Az Azure.Identity importálása
Az Azure.Identity NuGet-csomag az összes Azure SDK-kódtár között megosztott alapvető hitelesítési funkciókat tartalmazza.
Importálja az Azure.Identity NuGet-csomagot a dotnet add package paranccsal.
dotnet add package Azure.Identity
Építse újra a projektet a dotnet build paranccsal.
dotnet build
A kódszerkesztőben adja hozzá a névterekre és Azure.Identity a névterekre vonatkozó Azure.Core irányelveket.
using Azure.Core;
using Azure.Identity;
CosmosClient létrehozása az alapértelmezett hitelesítő adatok implementálásával
Ha helyi gépen tesztel, vagy az alkalmazás a felügyelt identitások közvetlen támogatásával fog futni az Azure-szolgáltatásokban, szerezze be az OAuth-jogkivonatot egy DefaultAzureCredential példány létrehozásával.
Ebben a példában egy típusváltozóba TokenCredential mentettük a példányt, mivel ez egy általánosabb típus, amely az SDK-k között újra felhasználható.
// Credential class for testing on a local machine or Azure services
TokenCredential credential = new DefaultAzureCredential();
Hozzon létre egy új CosmosClient-példányt a COSMOS_ENDPOINT környezeti változóval és a TokenCredential objektummal paraméterként.
// New instance of TableServiceClient class using Microsoft Entra
TableServiceClient client = new(
endpoint: Environment.GetEnvironmentVariable("COSMOS_ENDPOINT")!,
tokenCredential: credential
);
Az alkalmazás összeállítása
Az alkalmazás létrehozásakor a kód elsősorban négy erőforrástípussal fog működni:
A Table API-fiók, amely az Azure Cosmos DB-adatok egyedi legfelső szintű névtere.
A fiókban található egyes elemeket tartalmazó táblák.
Elemek, amelyek a táblázat egy-egy elemét jelölik.
Az alábbi ábra az ezen erőforrások közötti kapcsolatot mutatja be.
Hierarchikus diagram egy Azure Cosmos DB-fiókot ábrázol felül. A fiók két gyermektáblacsomópontot tartalmaz. Az egyik táblacsomópont két gyermekelemet tartalmaz.
Minden erőforrástípust egy vagy több társított .NET-osztály vagy interfész jelöl. Íme a leggyakoribb típusok listája:
| Osztály | Leírás |
|---|---|
TableServiceClient |
Ez az ügyfélosztály ügyféloldali logikai reprezentációt biztosít az Azure Cosmos DB szolgáltatáshoz. Az ügyfélobjektum a szolgáltatással kapcsolatos kérések konfigurálására és végrehajtására szolgál. |
TableClient |
Ez az ügyfélosztály egy olyan táblára mutató hivatkozás, amely lehet, hogy még létezik a szolgáltatásban. A tábla kiszolgálóoldali érvényesítve lesz, amikor megpróbálja elérni, vagy műveletet hajt végre rajta. |
ITableEntity |
Ez az interfész a táblában létrehozott vagy a táblából lekérdezett elemek alapfelülete. Ez az interfész tartalmazza a Table API elemeihez szükséges összes tulajdonságot. |
TableEntity |
Ez az osztály a ITableEntity felület általános implementációja kulcs-érték párok szótáraként. |
Az alábbi útmutatók bemutatják, hogyan használhatja ezeket az osztályokat az alkalmazás létrehozásához.
| Útmutató | Leírás |
|---|---|
| Tábla létrehozása | Táblák létrehozása |
| Elem létrehozása | Elemek létrehozása |
| Elem olvasása | Elemek olvasása |
Lásd még
Következő lépések
Most, hogy csatlakozott a Table API-fiókhoz, a következő útmutató segítségével hozhat létre és kezelhet táblákat.