Předchozí

Další

Příprava

Dokončeno

Vytváříte aplikaci .NET, která importuje a dotazuje data v kontejneru Azure Cosmos DB for NoSQL. Tady probereme celkové cíle projektu a způsob implementace funkcí importu a dotazů. Dále se podíváme, jak nastavit účet API pro NoSQL, který potřebujete.

Přehled projektu

Cílem tohoto projektu je sestavit a ověřit konzolovou aplikaci .NET, která nahrává a dotazuje položky v kontejneru API for NoSQL. Aplikace .NET používá sadu .NET SDK pro Azure Cosmos DB for NoSQL k interakci s instancí služby v Azure. Kód projektu používá transakční dávky k vytvoření více souvisejících položek současně. Kód projektu také používá dotazy reprezentované jako řetězce k ověření úspěšného nahrání položek.

Následující vývojový diagram ukazuje obchodní logiku, kterou aplikace potřebuje provést:

Diagram vývojového diagramu znázorňující kroky pro ověření klienta Vývojový diagram pak zobrazí krok dávkového vytvoření, který kombinuje vytvoření čtyř jednotlivých položek. Vývojový diagram nakonec zobrazuje sekvenci pro vytvoření, spuštění a sledování výsledků dotazu.

Mezi klíčové úkoly, které potřebujete udělat, patří:

1. Vytvořte účet služby Azure Cosmos DB a načtěte připojovací řetězec.
2. Vytvořte konzolovou aplikaci .NET a přidejte odkaz na balíček do sady Microsoft.Azure.Cosmos SDK.
3. Vytvořte prostředky databáze a kontejneru.
4. Přidejte jednu položku jako jednoduchou operaci.
5. Vytvořte transakční dávku pro přidání čtyř položek.
6. Spusťte a sledujte výsledky dotazu.

Nastavení

K dokončení tohoto projektu potřebujete účet API pro NoSQL.

Vytvoření účtu Azure Cosmos DB for NoSQL

Účet API pro NoSQL slouží k ukládání dat, která v tomto projektu vytvoříte, a ke spouštění dotazů. Tato část vás provede postupem vytvoření nového účtu pomocí Azure CLI přímo v terminálu Azure Cloud Shell.

1. Vytvořte novou proměnnou prostředí s názvem přípona s náhodným číslem. Vytvořte nový účet rozhraní API pro NoSQL ve skupině prostředků [název skupiny prostředků sandboxu].

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

   Důležité

   Tato skupina prostředků už byla vytvořena sandboxem.

2. Počkejte, až se příkaz dokončí po vytvoření nového účtu. Vytvoření nového účtu může trvat několik minut.

   Tip

   Pomocí webu Azure Portal můžete přejít na nový účet rozhraní API pro NoSQL.

Získání připojovací řetězec účtu

Teď, když máte účet API pro NoSQL, můžete k získání přihlašovacích údajů účtu použít az cosmosdb keys list příkaz z Azure CLI. V této části filtrujete výstup příkazu tak, aby vracel jenom jeden připojovací řetězec.

1. Nejprve získejte název naposledy vytvořeného rozhraní API pro účty NoSQL.

   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. Teď získejte Primary SQL Connection String přihlašovací údaje pro první účet ze seznamu nedávno vytvořených účtů.

   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. Poznamenejte si hodnotu tohoto připojovací řetězec. K připojení k tomuto účtu použijete připojovací řetězec dále v tomto projektu.

Konfigurace vývojového prostředí

Vývojové prostředí kontejneru je k dispozici se všemi závislostmi potřebnými k dokončení každého cvičení v tomto projektu. Vývojový kontejner můžete spustit v GitHub Codespaces nebo místně pomocí editoru Visual Studio Code.

Vývoj v prohlížeči

GitHub Codespaces spouští vývojový kontejner spravovaný GitHubem pomocí editoru Visual Studio Code pro web jako uživatelského rozhraní založeného na prohlížeči. Pro nejjednodušší vývojové prostředí použijte GitHub Codespaces, abyste měli předinstalované správné vývojářské nástroje a závislosti k dokončení tohoto trénovacího modulu.

Důležité

Všechny účty GitHubu můžou každý měsíc používat Codespaces až 60 hodin zdarma se 2 jádrovými instancemi.

1. Vytvořte nový Kódspace GitHubu azure-samples/cosmos-db-dotnet pomocí šablony.

   

2. Na stránce Vytvořit kódspace zkontrolujte nastavení konfigurace codespace a pak vyberte Vytvořit nový prostor kódu.

3. Počkejte, až se prostor kódu spustí. Tento proces spuštění může trvat několik minut.

4. Otevřete nový terminál v codespace.

5. Ověřte, že je ve vašem prostředí nainstalované rozhraní .NET 8:

   dotnet --list-sdks
   

6. Zavřete terminál.

Zbývající cvičení v tomto projektu probíhají v kontextu tohoto vývojového kontejneru.

Vývoj místně

Rozšíření Dev Containers pro Visual Studio Code vyžaduje instalaci Dockeru na místním počítači. Rozšíření hostuje vývojový kontejner místně pomocí hostitele Dockeru se správnými vývojářskými nástroji a závislostmi předinstalovanými k dokončení tohoto trénovacího modulu.

1. Otevřete úložiště šablon z GitHubu v editoru azure-samples/cosmos-db-dotnet Visual Studio Code.

   

2. Otevřete nový terminál.

3. Ověřte, že je ve vašem prostředí nainstalované rozhraní .NET 8:

   dotnet --list-sdks
   

4. Zavřete terminál.

Zbývající cvičení v tomto projektu probíhají v kontextu tohoto vývojového kontejneru.

Pokračovat