Lernprogramm: Verwenden einer Cosmos DB-Datenbank aus einer Windows-App

Dieser Artikel enthält die Erforderlichen Schritte zum Arbeiten mit einer Cosmos DB-Datenbank aus einer Windows-App. Er enthält auch einen kleinen Codeausschnitt zur Veranschaulichung, wie Sie im Code mit der Datenbank interagieren können.

Richten Sie Ihre Lösung ein

Dieses Beispiel kann mit jedem WPF-, Windows Forms-, WinUI- und UWP-Projekt verwendet werden, um Ihre Windows-App mit einer Cosmos DB-Datenbank zu verbinden. Führen Sie die nachfolgenden Schritte aus, um das Paket zu installieren und Beispielcode für einige grundlegende Aufgaben zu testen.

1. Öffnen Sie die Package Manager Console (Ansicht -> Weitere Fenster -> Package Manager Console). Verwenden Sie den Befehl Install-Package Microsoft.Azure.Cosmos, um das NuGet-Paket für die Azure Cosmos DB für NoSQL Clientbibliothek für .NET zu installieren. Dies ermöglicht den programmgesteuerten Zugriff auf Cosmos DB-Datenbanken.
2. Erstellen Sie Ihr Projekt, und vergewissern Sie sich, dass der Buildvorgang erfolgreich und ohne Fehler abgeschlossen wurde.

Als Nächstes müssen Sie eine Cosmos DB-Instanz in Azure erstellen. Führen Sie dazu die schritte in Create a NoSQL database account in Azure Cosmos DB aus.

Verwenden von Cosmos DB mit Beispielcode

Der folgende Beispielcode ruft einen Container aus einer Cosmos DB-Instanz in Azure ab und fügt diesem Container ein neues Element hinzu. Anschließend wird die NoSQL Abfrage-API von Cosmos DB verwendet, um das Element aus dem Container abzurufen und den Antwortstatus auszugeben. Beachten Sie, dass der Endpunkt, der Authentifizierungsschlüssel und der Datenbankname basierend auf der Cosmos DB-Instanz, die Sie im vorherigen Abschnitt erstellt haben, angepasst werden müssen.

using Microsoft.Azure.Cosmos;

...

public async Task CosmosSample(string endpoint, string authKey)
{
    // CONNECT
    var client = new CosmosClient(
        accountEndpoint: endpoint,
        authKeyOrResourceToken: authKey
    );
    Database database = client.GetDatabase("sample_customers");
    ContainerProperties properties = new(
        id: "customers",
        partitionKeyPath: "/location"
    );
    Container container = await database.CreateContainerIfNotExistsAsync(properties);

    // WRITE DATA
    string customerId = "1234";
    string state = "WA";
    var customer = new
    {
        id = customerId,
        name = "John Doe",
        location = state
    };
    var createResponse = await container.CreateItemAsync(customer);
    Console.WriteLine($"[Status code: {createResponse.StatusCode}]\t{customerId}");

    // READ DATA
    string sql = "SELECT * FROM customers c WHERE c.id = @id";
    var query = new QueryDefinition(
        query: sql
    ).WithParameter("@id", customerId);
    using var feed = container.GetItemQueryIterator<dynamic>(queryDefinition: query);
    var queryResponse = await feed.ReadNextAsync();
    Console.WriteLine($"[Status code: {queryResponse.StatusCode}]\t{customerId}");
}

Zugehöriger Inhalt

• Azure Cosmos DB für NoSQL Clientbibliothek für .NET
• Verwenden Sie eine MySQL-Datenbank in einer Windows-Anwendung