Začínáme se službou Azure Cosmos DB for Table s využitím .NET
PLATÍ PRO: 
Stůl
V tomto článku se dozvíte, jak se připojit ke službě Azure Cosmos DB for Table pomocí sady .NET SDK. Po připojení můžete provádět operace s tabulkami a položkami.
Referenční informace ke | zdrojovému kódu knihovny api pro balíčky (NuGet) | – | Referenční informace ke zdrojovému kódu knihovny | |
Požadavky
- Účet Azure s aktivním předplatným. Vytvoření účtu zdarma
- Účet služby Azure Cosmos DB for Table Vytvořte rozhraní API pro účet tabulky.
- .NET 6.0 nebo novější
- Rozhraní příkazového řádku Azure (CLI) nebo Azure PowerShell
Nastavení projektu
Pomocí příkazu se šablonou konzoly vytvořte novou aplikaci dotnet new .NET.
dotnet new console
Importujte balíček NuGet Azure.Data.Tables pomocí dotnet add package příkazu.
dotnet add package Azure.Data.Tables
Sestavte projekt pomocí dotnet build příkazu.
dotnet build
Připojení ke službě Azure Cosmos DB for Table
Pokud se chcete připojit k rozhraní API pro tabulku azure Cosmos DB, vytvořte instanci TableServiceClient třídy. Tato třída je výchozím bodem pro provádění všech operací s tabulkami.
Pokud se chcete připojit k účtu API for NoSQL pomocí Microsoft Entra, použijte objekt zabezpečení. Přesný typ objektu zabezpečení bude záviset na tom, kde hostujete kód aplikace. Následující tabulka slouží jako stručná referenční příručka.
| Kde aplikace běží | Objekt zabezpečení |
|---|---|
| Místní počítač (vývoj a testování) | Identita uživatele nebo instanční objekt |
| Azure | Spravovaná identita |
| Servery nebo klienti mimo Azure | Instanční objekt |
Import Azure.Identity
Balíček NuGet Azure.Identity obsahuje základní funkce ověřování, které se sdílí mezi všemi knihovnami sady Azure SDK.
Importujte balíček NuGet Azure.Identity pomocí dotnet add package příkazu.
dotnet add package Azure.Identity
Znovu sestavte projekt pomocí dotnet build příkazu.
dotnet build
V editoru kódu přidejte direktivy using pro Azure.Core obory názvů a Azure.Identity obory názvů.
using Azure.Core;
using Azure.Identity;
Vytvoření CosmosClient s výchozí implementací přihlašovacích údajů
Pokud testujete na místním počítači nebo vaše aplikace bude běžet na službách Azure s přímou podporou spravovaných identit, získejte token OAuth vytvořením DefaultAzureCredential instance.
V tomto příkladu jsme instanci uložili do proměnné typu TokenCredential , protože jde o obecnější typ, který je opakovaně použitelný napříč sadami SDK.
// Credential class for testing on a local machine or Azure services
TokenCredential credential = new DefaultAzureCredential();
Vytvořte novou instanci třídy CosmosClient s COSMOS_ENDPOINT proměnnou prostředí a tokenCredential objekt jako parametry.
// New instance of TableServiceClient class using Microsoft Entra
TableServiceClient client = new(
endpoint: Environment.GetEnvironmentVariable("COSMOS_ENDPOINT")!,
tokenCredential: credential
);
Sestavení aplikace
Při vytváření aplikace bude váš kód primárně pracovat se čtyřmi typy prostředků:
Rozhraní API pro účet tabulky, což je jedinečný obor názvů nejvyšší úrovně pro vaše data azure Cosmos DB.
Tabulky, které obsahují sadu jednotlivých položek ve vašem účtu
Položky, které představují jednotlivé položky v tabulce.
Na následujícím diagramu jsou vztahy těchto prostředků.
Hierarchický diagram znázorňující účet služby Azure Cosmos DB v horní části Účet má dva podřízené uzly tabulky. Jeden z uzlů tabulky obsahuje dvě podřízené položky.
Každý typ prostředku je reprezentován jednou nebo více přidruženými třídami nebo rozhraními .NET. Tady je seznam nejběžnějších typů:
| Třída | Popis |
|---|---|
TableServiceClient |
Tato třída klienta poskytuje logickou reprezentaci na straně klienta pro službu Azure Cosmos DB. Objekt klienta slouží ke konfiguraci a spouštění požadavků na službu. |
TableClient |
Tato třída klienta je odkazem na tabulku, která může nebo nemusí existovat ve službě ještě. Tabulka se ověří na straně serveru, když se pokusíte o přístup k ní nebo provedete operaci s ní. |
ITableEntity |
Toto rozhraní je základní rozhraní pro všechny položky vytvořené v tabulce nebo dotazované z tabulky. Toto rozhraní zahrnuje všechny požadované vlastnosti položek v rozhraní API pro tabulku. |
TableEntity |
Tato třída je obecná implementace ITableEntity rozhraní jako slovník párů klíč-hodnota. |
Následující příručky vám ukážou, jak pomocí každé z těchto tříd sestavit aplikaci.
| Průvodce | Popis |
|---|---|
| Vytvoření tabulky | Vytváření tabulek |
| Vytvoření položky | Vytvoření položek |
| Čtení položky | Čtení položek |
Viz také
Další kroky
Teď, když jste se připojili k rozhraní API pro účet Table, použijte další příručku k vytváření a správě tabulek.