Voorbereiden

  • 4 minuten

U bouwt een .NET-toepassing waarmee gegevens worden geïmporteerd en opgevraagd in een Azure Cosmos DB for NoSQL-container. Hier bespreken we de algemene doelstellingen van het project en hoe u de import- en queryfunctionaliteit implementeert. Daarnaast wordt beschreven hoe u de API instelt voor het NoSQL-account dat u nodig hebt.

Illustration of the icon of an Azure Cosmos DB account.

Projectoverzicht

Het doel van dit project is om een .NET-consoletoepassing te bouwen en te valideren waarmee items in een API voor NoSQL-container worden geüpload en opgevraagd. De .NET-toepassing maakt gebruik van de .NET SDK voor Azure Cosmos DB for NoSQL om te communiceren met een service-exemplaar in Azure. De projectcode maakt gebruik van transactionele batches om meerdere gerelateerde items tegelijk te maken. De projectcode maakt ook gebruik van query's, vertegenwoordigd als tekenreeksen, om te controleren of de items zijn geüpload.

In het volgende stroomdiagram ziet u de bedrijfslogica die de app moet uitvoeren:

Diagram of a flowchart showing steps to create and submit client batches.

De belangrijkste taken die u moet uitvoeren zijn:

  1. Maak een Azure Cosmos DB-account en haal de verbindingsreeks op.
  2. Maak een .NET-consoletoepassing en voeg een pakketreferentie toe aan de Microsoft.Azure.Cosmos SDK.
  3. Database- en containerbronnen maken.
  4. Voeg één item toe als een eenvoudige bewerking.
  5. Maak een transactionele batch om vier items toe te voegen.
  6. Voer de resultaten van een query uit en bekijk deze.

Instellingen

U hebt een API voor noSQL-account nodig om dit project te voltooien.

Een Azure Cosmos DB for NoSQL-account maken

Het API voor NoSQL-account wordt gebruikt voor het opslaan van de gegevens die u in dit project maakt en voor het uitvoeren van query's. In deze sectie wordt u begeleid bij de stappen voor het maken van een nieuw account met behulp van de Azure CLI rechtstreeks in de Azure Cloud Shell-terminal.

  1. Maak een nieuwe shellvariabele met de naam achtervoegsel met een willekeurig getal. Maak een nieuw API voor NoSQL-account in de resourcegroep [naam sandbox-resourcegroep].

    let suffix=$RANDOM*$RANDOM

az cosmosdb create \
    --resource-group "<rgn>[sandbox resource group name]</rgn>" \
    --name "mslearn-$suffix" \
    --locations "regionName=westus"

    Belangrijk

    Deze resourcegroep is al gemaakt door de sandbox.

  2. Wacht totdat de opdracht is voltooid zodra het nieuwe account is gemaakt. Het maken van een nieuw account kan enkele minuten duren.

    Tip

    U kunt met behulp van Azure Portal naar uw nieuwe API voor NoSQL-account navigeren.

Account ophalen verbindingsreeks

Nu u een API voor NoSQL-account hebt, kunt u de az cosmosdb keys list opdracht van de Azure CLI gebruiken om de referenties van het account op te halen. In deze sectie filtert u de uitvoer van de opdracht om slechts één verbindingsreeks te retourneren.

  1. Haal eerst de naam op van de laatst gemaakte API voor NoSQL-accounts.

    let resourceGroup="<rgn>[sandbox resource group name]</rgn>"

az cosmosdb list \
    --resource-group $resourceGroup \
    --query "sort_by([].{name:name,created:systemData.createdAt}, &created)" \
    --output table

  2. Haal nu de Primary SQL Connection String referentie voor het eerste account op uit de lijst met onlangs gemaakte accounts.

    let resourceGroup="<rgn>[sandbox resource group name]</rgn>"

az cosmosdb keys list \
    --resource-group $resourceGroup \
    --name $(az cosmosdb list \
        --resource-group $resourceGroup \
        --query "sort_by([].{name:name,created:systemData.createdAt}, &created)[0].name" \
        --output tsv) \
    --type connection-strings \
    --query "connectionStrings[?description=='Primary SQL Connection String'].connectionString" \
    --output tsv

  3. Noteer de waarde van deze verbindingsreeks. U gebruikt de verbindingsreeks verderop in dit project om verbinding te maken met dit account.

Ontwikkelomgeving configureren

Een ontwikkelcontaineromgeving is beschikbaar met alle afhankelijkheden die nodig zijn om elke oefening in dit project te voltooien. U kunt de ontwikkelcontainer uitvoeren in GitHub Codespaces of lokaal met behulp van Visual Studio Code.

GitHub Codespaces voert een ontwikkelcontainer uit die wordt beheerd door GitHub met Visual Studio Code voor het web als de gebruikersinterface op basis van de browser. Voor de eenvoudigste ontwikkelomgeving gebruikt u GitHub Codespaces zodat u de juiste ontwikkelhulpprogramma's en afhankelijkheden vooraf hebt geïnstalleerd om deze trainingsmodule te voltooien.

Belangrijk

Alle GitHub-accounts kunnen Codespaces elke maand maximaal 60 uur gratis gebruiken met 2 kernexemplaren.

  1. Maak een nieuwe GitHub Codespace met behulp van de azure-samples/cosmos-db-dotnet sjabloon.

    Open in GitHub Codespaces

  2. Controleer op de pagina Codespace maken de configuratie-instellingen voor codespace en selecteer vervolgens Nieuwe coderuimte maken.

  3. Wacht tot de coderuimte is gestart. Dit opstartproces kan enkele minuten duren.

  4. Open een nieuwe terminal in de codespace.

  5. Controleer of .NET 8 is geïnstalleerd in uw omgeving:

    dotnet --list-sdks

  6. Sluit de terminal.

De resterende oefeningen in dit project vinden plaats in de context van deze ontwikkelingscontainer.