Exercițiu: Crearea de resurse utilizând Microsoft .NET SDK v3

15 minute

În acest exercițiu, creați o aplicație consolă pentru a efectua următoarele operațiuni în Azure Cosmos DB:

Conectarea la un cont Azure Cosmos DB
Crearea unei baze de date
Crearea unui container

Cerințe preliminare

Un cont Azure cu un abonament activ. Dacă nu aveți deja unul, vă puteți înscrie pentru o încercare gratuită la https://azure.com/free.
Visual Studio Code pe una dintre platformele acceptate.
.NET 8 este cadrul țintă pentru exercițiu.
Extensia C# pentru Visual Studio Code.
Cele mai recente instrumente Azure CLI , instalate local.

Configurarea

Efectuați următoarele acțiuni pentru a pregăti Azure și mediul local pentru exercițiu.

Conectarea la Azure

Porniți Visual Studio Code și deschideți o fereastră de terminal selectând Terminal din bara de aplicații de sus, apoi alegând Terminal nou.
Conectați-vă la Azure utilizând următoarea comandă. Ar trebui să se deschidă o fereastră de browser care să vă permită să alegeți contul cu care să vă conectați.
```
az login
```

Creați resurse în Azure

Creați un grup de resurse pentru resursele necesare pentru acest exercițiu. Înlocuiți-l <myLocation> cu o regiune din apropierea dvs.
```
az group create --location <myLocation> --name az204-cosmos-rg
```
Creați contul Azure Cosmos DB. Înlocuiți <myCosmosDBacct> cu un nume unic pentru a vă identifica contul Azure Cosmos DB. Numele poate conține numai litere mici, numere și cratima (-). Trebuie să aibă o lungime cuprinsă între 3-31 de caractere. Această comandă durează câteva minute.
```
az cosmosdb create --name <myCosmosDBacct> --resource-group az204-cosmos-rg
```
Înregistrați afișatul documentEndpoint afișat în răspunsul JSON pentru a fi utilizat mai târziu în exercițiu.
Preluați cheia primară pentru cont utilizând următoarea comandă. Înregistrați rezultatele comenzii primaryMasterKey pentru a fi utilizate în cod.
```
# Retrieve the primary key
az cosmosdb keys list --name <myCosmosDBacct> --resource-group az204-cosmos-rg
```

Configurarea aplicației consolă

Acum că resursele necesare sunt implementate în Azure, următorul pas este să configurați aplicația consolă utilizând aceeași fereastră de terminal în Visual Studio Code.

Creați un folder pentru proiect și schimbați-l în folder.
```
md az204-cosmos
cd az204-cosmos
```
Creați aplicația consolă .NET.
```
dotnet new console
```
Deschideți folderul curent în Visual Studio Code utilizând următoarea comandă. -r Opțiunea deschide folderul fără a lansa o nouă fereastră Visual Studio Code.
```
code . -r
```
Selectați fișierul Program.cs în panoul Explorer pentru a deschide fișierul în editor.

Construiți aplicația consolă

Este timpul să începeți să adăugați pachetele și codul la proiect.

Adăugarea pachetelor și utilizarea instrucțiunilor

Deschideți terminalul în Visual Studio Code și utilizați următoarea comandă pentru a adăuga pachetul Microsoft.Azure.Cosmos la proiect.
```
dotnet add package Microsoft.Azure.Cosmos
```
Ștergeți orice cod existent în Program.cs fișier și adăugați instrucțiunea using Microsoft.Azure.Cosmos .
```
using Microsoft.Azure.Cosmos;
```

Adăugarea codului pentru a vă conecta la un cont Azure Cosmos DB

Adăugați următorul fragment de cod după using instrucțiune. Fragmentul de cod adaugă constante și variabile în clasă și adaugă o verificare a erorilor. Asigurați-vă că înlocuiți valorile substituente pentru EndpointUri și urmați instrucțiunile din comentariile PrimaryKey codului.

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
}

Sub metodă Main , adăugați o nouă sarcină asincronă numită CosmosAsync, care instanțiază noul CosmosClient nostru și adaugă cod pentru a apela metodele pe care le adăugați mai târziu pentru a crea o bază de date și un container.

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();
}

Crearea unei baze de date

Copiați și lipiți CreateDatabaseAsync metoda după metodă CosmosAsync . CreateDatabaseAsync creează o nouă bază de date cu ID az204Database dacă nu există deja.

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);
}

Crearea unui container

Copiați și lipiți CreateContainerAsync metoda sub metodă 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);
}

Rulați aplicația

Salvați lucrul și, într-un terminal din Visual Studio Code, verificați dacă există erori rulând dotnet build comanda. Rulați comanda dotnet run dacă compilarea are succes. Consola afișează următoarele mesaje.
```
Beginning operations...

Created Database: az204Database

Created Container: az204Container

End of program, press any key to exit.
```
Verificați rezultatele deschizând portalul Azure, navigând la resursa Azure Cosmos DB și utilizați Data Explorer pentru a vizualiza baza de date și containerul.

Curățarea resurselor Azure

Acum puteți șterge în siguranță grupul de resurse az204-cosmos-rg din cont rulând următoarea comandă.

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