Latihan: Buat sumber daya dengan menggunakan Microsoft .NET SDK v3

15 menit

Dalam latihan ini Anda membuat aplikasi konsol untuk melakukan operasi berikut di Azure Cosmos DB:

Menghubungkan ke akun Azure Cosmos DB
Membuat database
Membuat kontainer

Prasyarat

Akun Azure dengan langganan aktif. Jika Anda belum memilikinya, Anda dapat mendaftar uji coba gratis di https://azure.com/free .
Visual Studio Code di salah satu platform yang didukung.
.NET 6 adalah kerangka kerja target untuk latihan.
Ekstensi C# untuk Visual Studio Code.
Alat Azure CLI terbaru sudah terinstal secara lokal.

Menyiapkan

Lakukan tindakan berikut untuk mempersiapkan Azure, dan lingkungan lokal Anda, untuk latihan.

Menghubungkan ke Azure

Mulai Visual Studio Code dan buka jendela terminal dengan memilih Terminal dari bilah aplikasi atas, lalu pilih Terminal Baru.
Masuk ke Azure dengan menggunakan perintah berikut. Jendela browser akan terbuka memungkinkan Anda memilih akun mana yang akan masuk.
```
az login
```

Buat sumber daya di Azure

Buat grup sumber daya untuk sumber daya yang diperlukan untuk latihan ini. Ganti <myLocation> dengan wilayah di dekat Anda.
```
az group create --location <myLocation> --name az204-cosmos-rg
```
Buat akun Azure Cosmos DB. Ganti <myCosmosDBacct> dengan nama unikuntuk mengidentifikasi akun Azure Cosmos DB Anda. Nama hanya bisa berisi huruf kecil, angka, dan karakter tanda hubung (-). Panjang nama pengguna harus antara 3-31 karakter. Perintah ini membutuhkan waktu beberapa menit untuk diselesaikan.
```
az cosmosdb create --name <myCosmosDBacct> --resource-group az204-cosmos-rg
```
Rekam yang documentEndpoint ditunjukkan dalam respons JSON, yang digunakan nanti dalam latihan.
Ambil kunci primer untuk akun dengan menggunakan perintah berikut. primaryMasterKey Rekam dari hasil perintah yang akan digunakan dalam kode.
```
# Retrieve the primary key
az cosmosdb keys list --name <myCosmosDBacct> --resource-group az204-cosmos-rg
```

Menyiapkan aplikasi konsol

Setelah sumber daya yang diperlukan disebarkan ke Azure, langkah selanjutnya adalah menyiapkan aplikasi konsol menggunakan jendela terminal yang sama di Visual Studio Code.

Buat folder untuk proyek dan ubah ke folder.
```
md az204-cosmos
cd az204-cosmos
```
Buat aplikasi konsol .NET.
```
dotnet new console
```
Buka folder saat ini di Visual Studio Code menggunakan perintah berikut. Opsi -r membuka folder tanpa meluncurkan jendela Visual Studio Code baru.
```
code . -r
```
Pilih file Program.cs di panel Penjelajah untuk membuka file di editor.

Bangun aplikasi konsol

Saatnya untuk mulai menambahkan paket dan kode ke proyek.

Tambahkan paket dan gunakan pernyataan

Buka terminal di Visual Studio Code dan gunakan perintah berikut untuk menambahkan Microsoft.Azure.Cosmos paket ke proyek.
```
dotnet add package Microsoft.Azure.Cosmos
```
Hapus kode yang ada dalam file Program.cs dan tambahkan pernyataan using Microsoft.Azure.Cosmos.
```
using Microsoft.Azure.Cosmos;
```

Tambahkan kode untuk terhubung ke akun Azure Cosmos DB

Tambahkan cuplikan kode berikut setelah using pernyataan. Cuplikan kode menambahkan konstanta dan variabel ke dalam kelas dan menambahkan beberapa pemeriksaan kesalahan. Pastikan untuk mengganti nilai tempat penampung untuk EndpointUri dan PrimaryKey dengan mengikuti petunjuk di komentar kode.

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 Di bawah metode , tambahkan tugas asinkron baru yang disebut CosmosAsync, yang membuat instans kode baru CosmosClient kami dan menambahkan kode untuk memanggil metode yang Anda tambahkan nanti untuk membuat database dan kontainer.

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

Membuat database

Salin dan tempel metode CreateDatabaseAsync setelah metode CosmosAsync. CreateDatabaseAsync membuat database baru dengan ID az204Database jika belum ada.

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

Membuat kontainer

Salin dan tempel metode CreateContainerAsync di bawah metode 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);
}

Jalankan aplikasi

Simpan pekerjaan Anda dan, di terminal di Visual Studio Code, jalankan dotnet build perintah untuk memeriksa kesalahan apa pun. Jika build berhasil, jalankan dotnet run perintah . Konsol menampilkan pesan berikut.
```
Beginning operations...

Created Database: az204Database

Created Container: az204Container

End of program, press any key to exit.
```
Verifikasi hasilnya dengan membuka portal Azure, navigasikan ke sumber daya Azure Cosmos DB Anda, dan gunakan Penjelajah Data untuk melihat database dan kontainer.

Membersihkan sumber daya Azure

Anda sekarang dapat menghapus grup sumber daya az204-cosmos-rg dengan aman dari akun Anda dengan menjalankan perintah berikut.

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

Lanjutkan