Gyakorlat: Erőforrások létrehozása a Microsoft .NET SDK v3 használatával

15 perc

Ebben a gyakorlatban létrehoz egy konzolalkalmazást a következő műveletek végrehajtásához az Azure Cosmos DB-ben:

Csatlakozás Azure Cosmos DB-fiókba
-adatbázis létrehozása
Tároló létrehozása

Előfeltételek

An Azure account with an active subscription. Ha még nem rendelkezik előfizetéssel, regisztrálhat az ingyenes próbaverzióra a következő címen:https://azure.com/free.
Visual Studio Code az egyik támogatott platformon.
A .NET 6 a gyakorlat cél keretrendszere.
A Visual Studio Code C#-bővítménye.
A legújabb , helyileg telepített Azure CLI-eszközök .

Beállítás

Hajtsa végre az alábbi műveleteket az Azure és a helyi környezet előkészítéséhez a gyakorlathoz.

Csatlakozás az Azure-ba

Indítsa el a Visual Studio Code-ot, és nyisson meg egy terminálablakot a terminál kiválasztásával a felső alkalmazássávon, majd válassza az Új terminál lehetőséget.
Jelentkezzen be az Azure-ba a következő paranccsal. Meg kell nyitnia egy böngészőablakot, amelyen kiválaszthatja, hogy melyik fiókkal szeretne bejelentkezni.
```
az login
```

Erőforrások létrehozása az Azure-ban

Hozzon létre egy erőforráscsoportot a gyakorlathoz szükséges erőforrásokhoz. Cserélje le <myLocation> az Önhöz közeli régióra.
```
az group create --location <myLocation> --name az204-cosmos-rg
```
Hozza létre az Azure Cosmos DB-fiókot. Cserélje le <myCosmosDBacct> egy egyedi névre az Azure Cosmos DB-fiók azonosításához. A név csak kisbetűket, számokat és a kötőjel (-) karaktert tartalmazhatja. A név 3–31 karakter hosszú lehet. A parancs végrehajtása néhány percet vesz igénybe.
```
az cosmosdb create --name <myCosmosDBacct> --resource-group az204-cosmos-rg
```
Jegyezze fel a documentEndpoint JSON-válaszban látható eredményt, amelyet a gyakorlat későbbi részében használ.
Az alábbi paranccsal kérje le a fiók elsődleges kulcsát. Jegyezze fel a primaryMasterKey kódban használt parancseredményeket.
```
# Retrieve the primary key
az cosmosdb keys list --name <myCosmosDBacct> --resource-group az204-cosmos-rg
```

A konzolalkalmazás beállítása

Most, hogy a szükséges erőforrások üzembe lettek helyezve az Azure-ban, a következő lépés a konzolalkalmazás beállítása ugyanazzal a terminálablakkal a Visual Studio Code-ban.

Hozzon létre egy mappát a projekthez, és váltson a mappára.
```
md az204-cosmos
cd az204-cosmos
```
Hozza létre a .NET-konzolalkalmazást.
```
dotnet new console
```
Nyissa meg az aktuális mappát a Visual Studio Code-ban az alábbi paranccsal. A -r beállítás új Visual Studio Code-ablak elindítása nélkül nyitja meg a mappát.
```
code . -r
```
Válassza a Program.cs fájlt az Explorer panelen a fájl szerkesztőben való megnyitásához.

A konzolalkalmazás létrehozása

Itt az ideje, hogy elkezdje hozzáadni a csomagokat és a kódot a projekthez.

Csomagok hozzáadása és utasítások használata

Nyissa meg a terminált a Visual Studio Code-ban, és az alábbi paranccsal adja hozzá a Microsoft.Azure.Cosmos csomagot a projekthez.
```
dotnet add package Microsoft.Azure.Cosmos
```
Törölje a fájlban lévő Program.cs meglévő kódot, és adja hozzá az utasítást using Microsoft.Azure.Cosmos .
```
using Microsoft.Azure.Cosmos;
```

Kód hozzáadása Azure Cosmos DB-fiókhoz való csatlakozáshoz

Adja hozzá a következő kódrészletet az using utasítás után. A kódrészlet konstansokat és változókat ad hozzá az osztályhoz, és hozzáad néhány hibaellenőrzést. Mindenképpen cserélje le a helyőrző értékeket a kód megjegyzéseiben szereplő utasításokra EndpointUri , és PrimaryKey kövesse azokat.

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
}

Main A metódus alatt adjon hozzá egy új aszinkron feladatot, amely létrehozza az újatCosmosAsyncCosmosClient, és kódot ad hozzá, hogy meghívja a később hozzáadott metódusokat egy adatbázis és egy tároló létrehozásához.

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

-adatbázis létrehozása

Másolja és illessze be a CreateDatabaseAsync metódust a CosmosAsync metódus után. CreateDatabaseAsync létrehoz egy új adatbázist azonosítóval az204Database , ha még nem létezik.

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

Tároló létrehozása

Másolja és illessze be a CreateContainerAsync metódust a CreateDatabaseAsync metódus alá.

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

Az alkalmazás futtatása

Mentse a munkáját, és a Visual Studio Code egyik termináljában futtassa a parancsot a dotnet build hibák ellenőrzéséhez. Ha a build sikeres, futtassa a dotnet run parancsot. A konzol a következő üzeneteket jeleníti meg.
```
Beginning operations...

Created Database: az204Database

Created Container: az204Container

End of program, press any key to exit.
```
Az eredmények ellenőrzéséhez nyissa meg az Azure Portalt, navigáljon az Azure Cosmos DB-erőforráshoz, és az Adatkezelővel tekintse meg az adatbázist és a tárolót.

Azure-erőforrások tisztítása

Mostantól biztonságosan törölheti az az204-cosmos-rg erőforráscsoportot a fiókjából az alábbi parancs futtatásával.

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

Folytatás