使用 Go 從來源物件 URL 複製 Blob

本文說明如何使用適用於 Go 的 Azure 儲存體用戶端模組 (英文)，從來源物件 URL 複製 Blob。 您可以從相同儲存體帳戶內的來源、從不同儲存體帳戶中的來源，或從任何透過 HTTP GET 要求在指定 URL 上擷取的可存取物件來複製 Blob。

本文涵蓋的用戶端程式庫方法使用 Put Blob From URL 和 Put Block From URL REST API 作業。 針對您想要將資料移至儲存體帳戶並具有來源物件 URL 的複製情節，這些是優先使用的方法。 針對您想要進行非同步排程的複製作業，請參閱使用 Go 複製具有非同步排程的 Blob。

必要條件

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

設定您的環境

如果沒有現有的專案，本節說明如何設定專案以使用適用於 Go 的 Azure Blob 儲存體用戶端模組。 這些步驟包括模組安裝、新增 import 路徑，以及建立已授權的用戶端物件。 如需詳細資訊，請參閱開始使用 Azure Blob 儲存體和 Go。

安裝模組

使用下列命令安裝 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

新增匯入路徑

在您的程式碼檔案中，新增下列匯入路徑：

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

這些匯入路徑代表開始使用所需的最小值。 本文中的某些程式碼範例可能需要其他匯入路徑。 如需特定詳細資料和範例使用方式，請參閱程式碼範例。

建立用戶端物件

若要將應用程式連線至 Blob 記憶體，請使用 azblob.NewClient 建立用戶端物件。 下列範例示範如何使用 DefaultAzureCredential 來建立用戶端物件以進行授權：

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
}

授權

授權機制必須具有執行複製作業的必要權限。 如需使用 Microsoft Entra ID 授權 (建議使用)，您需要 Azure RBAC 內建角色儲存體 Blob 資料參與者或更高權限。 若要深入了解，請參閱從 URL 放置 Blob 或 從 URL 放置區塊 (部分機器翻譯) 的授權指導。

關於從來源物件 URL 複製 Blob

Put Blob From URL 作業會建立新的區塊 Blob，其中 Blob 的內容會從指定的 URL 讀取。 作業會同步完成。

來源可以是透過指定 URL 上標準 HTTP GET 要求擷取的任何物件。 這包括區塊 Blob、附加 Blob、分頁 Blob、Blob 快照集、Blob 版本，或 Azure 內外的任何可存取物件。

當來源物件是區塊 Blob 時，會複製所有認可的 Blob 內容。 目的地 Blob 的內容與來源的內容相同，但不會保留已認可區塊的清單，也不會複製未認可的區塊。

目的地一律是區塊 Blob、現有的區塊 Blob，或作業所建立的新區塊 Blob。 現有 Blob 的內容會以新 Blob 的內容覆寫。

Put Blob From URL 作業一律會複製整個來源 Blob。 不支援複製特定範圍的位元組或一組區塊。 若要使用來源 URL 對區塊 Blob 的內容執行部分更新，請使用從 URL 放置區塊 API 以及 Put Block List。

若要深入了解 Put Blob From URL 作業，包括 Blob 大小限制和計費考量事項，請參閱從 URL 放置 Blob 備註。

從來源物件 URL 複製 Blob

本節概述了適用於 Go 的 Azure 儲存體用戶端程式庫對從來源物件 URL 執行複製作業所提供的方法。

下列方法會包裝從 URL 放置 Blob REST API 作業，並建立新的區塊 Blob，其中 Blob 的內容會從指定的 URL 讀取：

• UploadBlobFromURL (英文)

此方法適用於您想要將資料移至儲存體帳戶，且含有來源物件 URL 的案例。

對於大型物件，您可以選擇使用個別區塊。 下列方法會包裝從 URL 放置區塊 REST API 作業。 這個方法會建立新的區塊，以作為從來源 URL 讀取內容的 Blob 一部分認可：

• StageBlockFromURL (英文)

從 Azure 中的來源複製 Blob

如果您要從 Azure 內的來源複製 Blob，可以透過 Microsoft Entra ID (建議)、共用存取簽章 (SAS) 或帳戶金鑰來授權來源 Blob 的存取權。

下列程式碼範例示範複製 Azure 內來源 Blob 的案例。 在此範例中，我們也會使用 UploadBlobFromURLOptions (英文) struct，將目的地 Blob 的存取層設定為 Cool。

func copyFromSourceURL(srcBlob *blockblob.Client, destBlob *blockblob.Client) {
    // Set copy options
    copyOptions := blockblob.UploadBlobFromURLOptions{
        Tier: to.Ptr(blob.AccessTierCool),
    }

    // Copy the blob from the source URL to the destination blob
    _, err := destBlob.UploadBlobFromURL(context.TODO(), srcBlob.URL(), &copyOptions)
    handleError(err)
}

下列範例顯示範例使用方式：

// TODO: replace <storage-account-name> placeholders with actual storage account names
srcURL := "https://<src-storage-account-name>.blob.core.windows.net/"
destURL := "https://<dest-storage-account-name>.blob.core.windows.net/"

credential, err := azidentity.NewDefaultAzureCredential(nil)
handleError(err)

srcClient, err := azblob.NewClient(srcURL, credential, nil)
handleError(err)
destClient, err := azblob.NewClient(destURL, credential, nil)
handleError(err)

srcBlob := srcClient.ServiceClient().NewContainerClient("source-container").NewBlockBlobClient("source-blob")
destBlob := destClient.ServiceClient().NewContainerClient("destination-container").NewBlockBlobClient("destination-blob-1")

copyFromSourceURL(srcBlob, destBlob)

從 Azure 外部的來源複製 Blob

您可以在透過 HTTP GET 要求於指定 URL 擷取的任何來源物件上，執行複製作業，包括 Azure 外部的可存取物件。 下列範例程式碼示範從可存取的來源物件 URL 複製 Blob 的案例。

func copyFromExternalSource(srcURL string, destBlob *blockblob.Client) {
    // Set copy options
    copyOptions := blockblob.UploadBlobFromURLOptions{
        Tier: to.Ptr(blob.AccessTierCool),
    }

    // Copy the blob from the source URL to the destination blob
    _, err := destBlob.UploadBlobFromURL(context.TODO(), srcURL, &copyOptions)
    handleError(err)
}

下列範例顯示範例使用方式：

externalURL := "<source-url>"

destBlob = destClient.ServiceClient().NewContainerClient("destination-container").NewBlockBlobClient("destination-blob-2")

copyFromExternalSource(externalURL, destBlob)

資源

若要深入了解如何使用適用於 Go 的 Azure Blob 儲存體用戶端程式庫來複製 Blob，請參閱下列資源。

程式碼範例

• 檢視本文中的程式碼範例 (GitHub)

REST API 操作

適用於 Go 的 Azure SDK 包含建置在 Azure REST API 之上的程式庫，可讓您透過熟悉的 Go 典範與 REST API 作業進行互動。 本文中涵蓋的用戶端程式庫方法會使用下列 REST API 作業：

• 從 URL 放置 Blob (REST API)
• Put Block From URL (REST API)

用戶端模組資源

• 用戶端模組參考文件
• 用戶端模組原始程式碼
• 套件 (pkg.go.dev)

相關內容

• 本文是適用於 Go 的 Blob 儲存體開發人員指南的一部分。 若要深入了解，請參閱位於建置 Go 應用程式的完整開發人員指南文章清單。