Erste Schritte mit Azure Cosmos DB for Table unter Verwendung von .NET

In diesem Artikel erfahren Sie, wie Sie mithilfe des .NET SDK eine Verbindung mit Azure Cosmos DB for Table herstellen. Sobald die Verbindung hergestellt ist, können Sie Vorgänge auf Tabellen und Elemente anwenden.

Paket (NuGet) | Beispiele | API-Dokumentation | Bibliotheksquellcode | Feedback einreichen |

Prerequisites

• Ein Azure-Konto mit einem aktiven Abonnement. Kostenlos ein Konto erstellen.
• Azure Cosmos DB für Table-Konto. Erstellen eines „API für Table“-Kontos.
• .NET 6,0 oder höher
• Azure-Befehlszeilenschnittstelle (CLI) oder Azure PowerShell

Einrichten Ihres Projekts

Erstellen Sie eine neue .NET Anwendung mithilfe des Befehls dotnet new mit der Vorlage console.

dotnet new console

Importieren Sie das NuGet-Paket Azure.Data.Tables mit dem Befehl dotnet add package.

dotnet add package Azure.Data.Tables

Erstellen Sie das Projekt mit dem dotnet build-Befehl.

dotnet build

Herstellen einer Verbindung mit Azure Cosmos DB for Table

Um eine Verbindung mit der API für Table von Azure Cosmos DB herzustellen, erstellen Sie eine Instanz der TableServiceClient-Klasse. Diese Klasse ist der Ausgangspunkt für das Anwenden aller Vorgänge auf Tabellen.

Um eine Verbindung mit Ihrer API für das NoSQL-Konto mithilfe von Microsoft Entra herzustellen, verwenden Sie einen Sicherheitsprinzipal. Der genaue Prinzipaltyp hängt davon ab, wo Sie Ihren Anwendungscode hosten. Die folgende Tabelle dient als Kurzanleitung.

Importieren Sie Azure.Identity

Das Azure.Identity NuGet-Paket enthält grundlegende Authentifizierungsfunktionen, die von allen Azure SDK-Bibliotheken gemeinsam genutzt werden.

Importieren Sie das Azure.Identity-NuGet-Paket mithilfe des dotnet add package-Befehls.

dotnet add package Azure.Identity

Erstellen Sie das Projekt mit dem Befehl dotnet build neu.

dotnet build

Fügen Sie in Ihrem Code-Editor die Verwendung von Direktiven für Azure.Core und Azure.Identity Namespaces hinzu.

using Azure.Core;
using Azure.Identity;

Erstelle CosmosClient mit Standard-Zugangsdaten-Implementierung

Wenn Sie auf einem lokalen Computer testen oder Ihre Anwendung auf Azure-Diensten mit direkter Unterstützung für verwaltete Identitäten ausgeführt wird, rufen Sie ein OAuth-Token ab, indem Sie eine DefaultAzureCredential-Instanz erstellen.

In diesem Beispiel haben wir die Instanz in einer Variablen vom Typ TokenCredential gespeichert, da es sich um einen generischeren Typ handelt, der über SDKs wiederverwendbar ist.

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

Erstellen Sie eine neue Instanz der CosmosClient-Klasse mit der COSMOS_ENDPOINT-Umgebungsvariable und dem TokenCredential-Objekt als Parameter.

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

Erstellen Ihrer Anwendung

Beim Erstellen Ihrer Anwendung interagiert Ihr Code hauptsächlich mit vier Arten von Ressourcen:

• Das „API für Table“-Konto, das den eindeutigen Namespace der obersten Ebene für Ihre Azure Cosmos DB-Daten darstellt.

• Tabellen, die eine Menge einzelner Elemente in Ihrem Konto enthalten.

• Elemente, die ein einzelnes Element in Ihrer Tabelle darstellen.

Das folgende Diagramm zeigt die Beziehung zwischen diesen Ressourcen.

Jeder Ressourcentyp wird durch eine oder mehrere zugeordnete .NET-Klassen oder -Schnittstellen dargestellt. Es folgt eine Liste der gängigsten Typen:

In den folgenden Leitfäden wird gezeigt, wie Sie diese verschiedenen Klassen verwenden, um Ihre Anwendung zu erstellen.

Siehe auch

• Package (NuGet)
• Beispiele
• API-Referenz
• Quellcode der Bibliothek
• Feedback geben

Nächste Schritte

Nachdem Sie eine Verbindung mit einem „API für Table“-Konto hergestellt haben, können Sie anhand der nächsten Anleitung Tabellen erstellen und verwalten.