Cvičení: Vytvoření prostředků pomocí sady Microsoft .NET SDK v3

15 min

V tomto cvičení vytvoříte konzolovou aplikaci, která provede následující operace ve službě Azure Cosmos DB:

Připojení k účtu služby Azure Cosmos DB
Vytvořit databázi
Vytvoření kontejneru

Požadavky

Účet Azure s aktivním předplatným. Pokud ho ještě nemáte, můžete si zaregistrovat bezplatnou zkušební verzi na webu https://azure.com/free.
Visual Studio Code na jedné z podporovaných platforem
.NET 8 je cílová architektura pro cvičení.
Rozšíření pro jazyk C# pro Visual Studio Code
Nejnovější nástroje Azure CLI nainstalované místně.

Nastavení

Provedením následujících akcí připravte Azure a místní prostředí pro toto cvičení.

Připojení k Azure

Spusťte Visual Studio Code a otevřete okno terminálu tak, že v horním panelu aplikace vyberete Terminál a pak zvolíte Nový terminál.
Přihlaste se k Azure pomocí následujícího příkazu. Mělo by se otevřít okno prohlížeče, ve kterém se můžete rozhodnout, pomocí kterého účtu se chcete přihlásit.
```
az login
```

Vytvoření prostředků v Azure

Vytvořte skupinu prostředků pro prostředky potřebné pro toto cvičení. Nahraďte <myLocation> oblastí blízko vás.
```
az group create --location <myLocation> --name az204-cosmos-rg
```
Vytvořte účet služby Azure Cosmos DB. Nahraďte <myCosmosDBacct> jedinečným názvem pro identifikaci účtu služby Azure Cosmos DB. Tento název může obsahovat jenom malá písmena, číslice a znak spojovníku (-). Musí mít délku 3 až 31 znaků. Dokončení tohoto příkazu trvá několik minut.
```
az cosmosdb create --name <myCosmosDBacct> --resource-group az204-cosmos-rg
```
Poznamenejte si documentEndpoint záznam zobrazený v odpovědi JSON pro pozdější použití v cvičení.
Pomocí následujícího příkazu načtěte primární klíč účtu. Zaznamenejte primaryMasterKey výsledky příkazu pro použití v kódu.
```
# Retrieve the primary key
az cosmosdb keys list --name <myCosmosDBacct> --resource-group az204-cosmos-rg
```

Nastavení konzolové aplikace

Teď, když jsou potřebné prostředky nasazené do Azure, je dalším krokem nastavení konzolové aplikace pomocí stejného okna terminálu v editoru Visual Studio Code.

Vytvořte složku pro projekt a přejděte do složky.
```
md az204-cosmos
cd az204-cosmos
```
Vytvořte konzolovou aplikaci .NET.
```
dotnet new console
```
Pomocí následujícího příkazu otevřete aktuální složku v editoru Visual Studio Code. Tato -r možnost otevře složku bez spuštění nového okna editoru Visual Studio Code.
```
code . -r
```
Výběrem souboru Program.cs v podokně Průzkumník otevřete soubor v editoru.

Sestavení konzolové aplikace

Je čas začít do projektu přidávat balíčky a kód.

Přidání balíčků a příkazů using

Otevřete terminál v editoru Visual Studio Code a pomocí následujícího příkazu přidejte Microsoft.Azure.Cosmos balíček do projektu.
```
dotnet add package Microsoft.Azure.Cosmos
```
Odstraňte veškerý existující kód v Program.cs souboru a přidejte příkaz using Microsoft.Azure.Cosmos .
```
using Microsoft.Azure.Cosmos;
```

Přidání kódu pro připojení k účtu služby Azure Cosmos DB

Za příkaz přidejte následující fragment using kódu. Fragment kódu přidá do třídy konstanty a proměnné a přidá kontrolu chyb. Nezapomeňte nahradit zástupné hodnoty pro EndpointUri a PrimaryKey podle pokynů v komentářích kódu.

public class Program
{
    // Replace <documentEndpoint> with the information created earlier
    private static readonly string EndpointUri = "<documentEndpoint>";

    // Set variable to the Primary Key from earlier.
    private static readonly string PrimaryKey = "<your primary key>";

    // The Cosmos client instance
    private CosmosClient cosmosClient;

    // The database we will create
    private Database database;

    // The container we will create.
    private Container container;

    // The names of the database and container we will create
    private string databaseId = "az204Database";
    private string containerId = "az204Container";

    public static async Task Main(string[] args)
    {
        try
        {
            Console.WriteLine("Beginning operations...\n");
            Program p = new Program();
            await p.CosmosAsync();

        }
        catch (CosmosException de)
        {
            Exception baseException = de.GetBaseException();
            Console.WriteLine("{0} error occurred: {1}", de.StatusCode, de);
        }
        catch (Exception e)
        {
            Console.WriteLine("Error: {0}", e);
        }
        finally
        {
            Console.WriteLine("End of program, press any key to exit.");
            Console.ReadKey();
        }
    }
    //The sample code below gets added below this line
}

Pod metodu Main přidejte novou asynchronní úlohu s názvem CosmosAsync, která vytvoří instanci našeho nového CosmosClient kódu a přidá kód pro volání metod, které přidáte později k vytvoření databáze a kontejneru.

public async Task CosmosAsync()
{
    // Create a new instance of the Cosmos Client
    this.cosmosClient = new CosmosClient(EndpointUri, PrimaryKey);

    // Runs the CreateDatabaseAsync method
    await this.CreateDatabaseAsync();

    // Run the CreateContainerAsync method
    await this.CreateContainerAsync();
}

Vytvořit databázi

Zkopírujte a vložte metodu CreateDatabaseAsync za metodu CosmosAsync . CreateDatabaseAsync vytvoří novou databázi s ID az204Database , pokud ještě neexistuje.

private async Task CreateDatabaseAsync()
{
    // Create a new database using the cosmosClient
    this.database = await this.cosmosClient.CreateDatabaseIfNotExistsAsync(databaseId);
    Console.WriteLine("Created Database: {0}\n", this.database.Id);
}

Vytvoření kontejneru

Zkopírujte a vložte metodu CreateContainerAsync pod metodu CreateDatabaseAsync .

private async Task CreateContainerAsync()
{
    // Create a new container
    this.container = await this.database.CreateContainerIfNotExistsAsync(containerId, "/LastName");
    Console.WriteLine("Created Container: {0}\n", this.container.Id);
}

Spuštění aplikace

Uložte svoji práci a spuštěním příkazu v terminálu v editoru dotnet build Visual Studio Code zkontrolujte případné chyby. dotnet run Pokud je sestavení úspěšné, spusťte příkaz. Konzola zobrazí následující zprávy.
```
Beginning operations...

Created Database: az204Database

Created Container: az204Container

End of program, press any key to exit.
```
Ověřte výsledky otevřením webu Azure Portal, přechodem k prostředku služby Azure Cosmos DB a zobrazením databáze a kontejneru pomocí Průzkumníka dat.

Vyčištění prostředků Azure

Teď můžete bezpečně odstranit skupinu prostředků az204-cosmos-rg ze svého účtu spuštěním následujícího příkazu.

az group delete --name az204-cosmos-rg --no-wait