開始使用 Azure Blob 儲存體和 Go

發行項
11/06/2024

本文說明如何使用適用於 Go 的 Azure Blob 儲存體用戶端模組來連線至 Azure Blob 儲存體。線上之後，請使用開發人員指南來瞭解如何在 Blob 記憶體服務的容器、Blob 和功能上運作程式碼。

如果您想要從完整的範例開始，請參閱快速入門：Azure Blob 儲存體適用於 Go 的用戶端連結庫。

API 參考文件 | 程式庫原始程式碼 | 套件 (pkg.go.dev)

必要條件

Azure 訂用帳戶 - 建立免費帳戶
Azure 儲存體帳戶 - 建立儲存體帳戶
Go 1.18+

設定您的專案

本節會引導您準備專案以搭配使用適用於 Go 的 Azure Blob 儲存體用戶端模組。

從您的 GOPATH，使用下列命令安裝 azblob 模組：

go get github.com/Azure/azure-sdk-for-go/sdk/storage/azblob

若要使用 Microsoft Entra ID 進行驗證 (建議使用)，請使用下列命令安裝 azidentity 模組：

go get github.com/Azure/azure-sdk-for-go/sdk/azidentity

然後開啟程式碼檔案，並新增必要的匯入路徑。在此範例中，我們會將下列內容新增至 go 檔案：

import (
    "github.com/Azure/azure-sdk-for-go/sdk/storage/azblob"
    "github.com/Azure/azure-sdk-for-go/sdk/azidentity"
)

Blob 用戶端模組資訊：

azblob：包含可用來在服務、容器和 Blob 上操作的方法。

授權存取權並連線到 Blob 儲存體

若要將應用程式連線至 Blob 記憶體，請使用 azblob.NewClient 建立用戶端物件。此物件是您與儲存體帳戶層級的資料資源互動的起點。您可以使用它來操作儲存體帳戶及其容器。

若要深入了解如何建立和管理客戶端物件，包括最佳做法，請參閱建立和管理與資料資源互動的客戶端物件。

您可以使用 Microsoft Entra 授權權杖 (建議)、帳戶存取密鑰或共用存取簽章 (SAS) 來授權用戶端物件。

若要使用 Microsoft Entra ID 進行授權，您必須使用安全性主體。下列文章提供不同驗證案例的指導：

使用 DefaultAzureCredential 授權存取

授權存取權並連線到 Blob 儲存體簡單又安全的方式，是藉由建立 DefaultAzureCredential 執行個體來取得 OAuth 權杖。然後，您可以使用該認證，使用 azblob.NewClient 建立用戶端物件。

func getServiceClientTokenCredential(accountURL string) *azblob.Client {
    // Create a new service client with token credential
    credential, err := azidentity.NewDefaultAzureCredential(nil)
    handleError(err)

    client, err := azblob.NewClient(accountURL, credential, nil)
    handleError(err)

    return client
}

若要使用共用存取簽章 (SAS) 權杖，請將權杖附加至帳戶 URL 字串，並使用 azblob.NewClientWithNoCredential 建立用戶端物件。

func getServiceClientSAS(accountURL string, sasToken string) *azblob.Client {
    // Create a new service client with an existing SAS token

    // Append the SAS to the account URL with a "?" delimiter
    accountURLWithSAS := fmt.Sprintf("%s?%s", accountURL, sasToken)

    client, err := azblob.NewClientWithNoCredential(accountURLWithSAS, nil)
    handleError(err)

    return client
}

注意

針對使用共用存取簽章 (SAS) 的案例，Microsoft 建議使用使用者委派 SAS。使用者委派 SAS 會使用 Microsoft Entra 認證來保護，而不是使用帳戶金鑰。如需詳細資訊，請參閱使用共用存取簽章 (SAS) 授與資料的有限存取權。

若要使用儲存體帳戶共用金鑰，請提供金鑰作為字串，並使用 azblob.NewClientWithSharedKeyCredential 初始化用戶端物件。

func getServiceClientSharedKey(accountName string, accountKey string) *azblob.Client {
    // Create a new service client with shared key credential
    credential, err := azblob.NewSharedKeyCredential(accountName, accountKey)
    handleError(err)

    accountURL := fmt.Sprintf("https://%s.blob.core.windows.net", accountName)

    client, err := azblob.NewClientWithSharedKeyCredential(accountURL, credential, nil)
    handleError(err)

    return client
}

您也可以使用連接字串來建立用戶端物件。

func getServiceClientConnectionString(connectionString string) *azblob.Client {
    // Create a new service client with connection string
    client, err := azblob.NewClientFromConnectionString(connectionString, nil)
    handleError(err)

    return client
}

關於如何取得帳戶金鑰及正確管理和保護金鑰的最佳做法指導方針，如需相關資訊，請參閱管理儲存體帳戶存取金鑰。

重要

應該謹慎使用帳戶存取金鑰。如果帳戶存取金鑰遺失或意外放在不安全的地方，您的服務可能變得易受攻擊。任何擁有存取金鑰的人都可以授權執行目標為儲存體帳戶的要求，而且可實質存取所有資料。 DefaultAzureCredential 會提供增強的安全性功能和權益，建議用來管理對 Azure 服務的授權。

建置應用程式

當您建置應用程式以在 Azure Blob 儲存體中使用資料資源時，您的程式碼主要會與三種資源類型互動：儲存體帳戶、容器和 Blob。若要深入了解這些資源類型、彼此的關係，以及應用程式如何與資源互動，請參閱了解應用程式如何與 Blob 儲存體資料資源互動。

下列指南說明如何使用適用於 Go 的 Azure Blob 儲存體用戶端模組來存取資料並執行特定動作：

指南	描述
設定重試原則 (部分機器翻譯)	實作用戶端作業的重試原則。
複製 Blob	將 Blob 從一個位置複製到另一個位置。
建立容器	建立容器。
刪除和還原 Blob	刪除 Blob 和 (如果已啟用虛刪除) 還原已刪除的 Blob。
刪除和還原容器	刪除容器和 (如果已啟用虛刪除) 還原已刪除的容器。
下載 Blob	使用字串、串流和檔案路徑來下載 Blob。
使用標籤來尋找 Blob	設定和擷取標籤，以及使用標籤來尋找 Blob。
列出 Blob	以各種方式列出 Blob。
列出容器	列出帳戶中的容器，以及可用來自訂清單的各種選項。
管理屬性和中繼資料 (Blob)	管理容器屬性和中繼資料。
管理屬性和中繼資料 (容器)	管理容器屬性和中繼資料。
上傳 Blob	了解如何使用字串、串流、檔案路徑和其他方法來上傳 Blob。

注意

本指南中的程式碼範例旨在協助您開始使用 Azure Blob 儲存體和 Go。您應該修改錯誤處理和 Context 值，以符合您應用程式的需求。

共用方式為