Azure Learn AZ-204 The Hard Way | 實作 AZ-204 Lab 03 Storage SDK

2022-03-21

實作 AZ-204 證照測驗準備的實驗課程，從實驗課程中精熟 AZ-204 的測驗重點以及工具操作。本次要實驗的是如何使用 Azure Storage SDK。

logo

Lab03 - Storage SDK

詳細的實驗流程可以參考微軟在 GitHub上的專案

圖片來源：微軟

Pre Setting

首先建立 Storage Account，取得 Endpoints 中 Blob Services 的值以及取得 Access Keys 提供後續 Web App 使用。


建立兩個 Storage Container，分別是 raster-graphics 以及 compressed-audio，兩個 Container 的 Access Level 都選擇 Private (no anonymous access) 。

接著在 raster-graphics Container 上傳一張圖片 graph.jpg。

Dotnet new

dotnet new console --name BlobManager --output .

接著安裝相關的 packages

dotnet add package Azure.Storage.Blobs --version 12.0.0

進行編譯確認一切正常

dotnet build

Coding With Storage SDK

接下來的部分就是逐段使用到 Storage SDK 的功能，為求說明方面先呈現最終的程式碼，並且再逐段說明 SDK 使用方式：

Program 開頭的 blobServiceEndpoint、storageAccountName 及 storageAccountKey 分別需要輸入之前在建立 Storage Account 以及 Container 所得到的值。

using Azure.Storage;
using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;
using System;
using System.Threading.Tasks;

public class Program
{
    private const string blobServiceEndpoint = "https://mediastorcs.blob.core.windows.net/";
    private const string storageAccountName = "mediastorcs";
    private const string storageAccountKey = "*";

    public static async Task Main(string[] args)
    {
        StorageSharedKeyCredential accountCredentials = 
          new StorageSharedKeyCredential(storageAccountName, storageAccountKey);

        BlobServiceClient serviceClient = 
          new BlobServiceClient(new Uri(blobServiceEndpoint), accountCredentials);

        AccountInfo info = await serviceClient.GetAccountInfoAsync();

        await Console.Out.WriteLineAsync($"Connected to Azure Storage Account");
        await Console.Out.WriteLineAsync($"Account name:\t{storageAccountName}");
        await Console.Out.WriteLineAsync($"Account kind:\t{info?.AccountKind}");
        await Console.Out.WriteLineAsync($"Account sku:\t{info?.SkuName}");

        await EnumerateContainersAsync(serviceClient);

        string existingContainerName = "raster-graphics";
        await EnumerateBlobsAsync(serviceClient, existingContainerName);
    
        string newContainerName = "vector-graphics";
        BlobContainerClient containerClient = 
          await GetContainerAsync(serviceClient, newContainerName);
    
        string uploadedBlobName = "graph.svg";
        BlobClient blobClient = await GetBlobAsync(containerClient, uploadedBlobName);

        await Console.Out.WriteLineAsync($"Blob Url:\t{blobClient.Uri}");
    }
}

執行起來，會是這樣的結果：

$ dotnet run
Connected to Azure Storage Account
Account name:   mediastorcs
Account kind:   StorageV2
Account sku:    StandardLrs
Container:      compressed-audio
Container:      raster-graphics
Searching:      raster-graphics
Existing Blob:  graph.jpg
New Container:  vector-graphics
Blob Found:     graph.svg
Blob Url:       https://mediastorcs.blob.core.windows.net/vector-graphics/graph.svg

SDK 使用的首先目標是取得目前 Storage Account 的資訊：

StorageSharedKeyCredential accountCredentials = 
  new StorageSharedKeyCredential(storageAccountName, storageAccountKey);

BlobServiceClient serviceClient = 
  new BlobServiceClient(new Uri(blobServiceEndpoint), accountCredentials);

AccountInfo info = await serviceClient.GetAccountInfoAsync();

await Console.Out.WriteLineAsync($"Connected to Azure Storage Account");
await Console.Out.WriteLineAsync($"Account name:\t{storageAccountName}");
await Console.Out.WriteLineAsync($"Account kind:\t{info?.AccountKind}");
await Console.Out.WriteLineAsync($"Account sku:\t{info?.SkuName}");

使用 BlobServiceClient 迭代列出 Storage Account 中的所有 Container 名稱

await EnumerateContainersAsync(serviceClient);

搭配使用的函數為 EnumerateContainersAsync

private static async Task EnumerateContainersAsync(BlobServiceClient client)
{
    await foreach (BlobContainerItem container in client.GetBlobContainersAsync())
    {
        await Console.Out.WriteLineAsync($"Container:\t{container.Name}");
    }
}

使用 BlobServiceClient 迭代列出所有 Container 中的 Blog 資訊

string existingContainerName = "raster-graphics";
await EnumerateBlobsAsync(serviceClient, existingContainerName);

搭配使用的函數為 EnumerateBlobsAsync

private static async Task EnumerateBlobsAsync(
  BlobServiceClient client, string containerName)
{      
    BlobContainerClient container = client.GetBlobContainerClient(containerName);
    
    await Console.Out.WriteLineAsync($"Searching:\t{container.Name}");
    
    await foreach (BlobItem blob in container.GetBlobsAsync())
    {        
            await Console.Out.WriteLineAsync($"Existing Blob:\t{blob.Name}");
    }
}

使用 BlobContainerClient 建立一個新的 Container vector-graphics

string newContainerName = "vector-graphics";
BlobContainerClient containerClient = 
  await GetContainerAsync(serviceClient, newContainerName);

搭配使用的函數為 GetContainerAsync

private static async Task<BlobContainerClient> GetContainerAsync(
  BlobServiceClient client, string containerName)
{      
    BlobContainerClient container = client.GetBlobContainerClient(containerName);
    
    await container.CreateIfNotExistsAsync(PublicAccessType.Blob);
    await Console.Out.WriteLineAsync($"New Container:\t{container.Name}");
    
    return container;
}

這邊回到 Portal 將圖片 graph.svg 上傳至 Container vector-graphics，

並使用 BlobClient 以取得圖片的資訊：

string uploadedBlobName = "graph.svg";
BlobClient blobClient = await GetBlobAsync(containerClient, uploadedBlobName);

await Console.Out.WriteLineAsync($"Blob Url:\t{blobClient.Uri}");

搭配使用的函數為 GetContainerAsync

private static async Task<BlobClient> GetBlobAsync(
  BlobContainerClient client, string blobName)
{      
    BlobClient blob = client.GetBlobClient(blobName);
    await Console.Out.WriteLineAsync($"Blob Found:\t{blob.Name}");
    return blob;
}

完整的程式碼可以參考 GitHub AZ-204-DevelopingSolutionsforMicrosoftAzure

Azure Storage SDK 相關知識

blob.core.windows.net

Storage Account Data Lake

  • ACL in files
  • SubDirectories

Storage Tier

Hot, Cold, Archive

Storage Lifecycle Management

Emulator

Deprecated Azure Storage Emulatro

Azurite

實戰 Azure Storage SDK 心得

...

#Microsoft #Azure #Certification #Dev