共用方式為

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

  • 發行項

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

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

必要條件

設定您的環境

如果沒有現有的專案，本章節會說明如何設定專案以使用適用於 JAVA 的 Azure Blob 儲存體用戶端程式庫。 如需詳細資訊，請參閱開始使用 Azure Blob 儲存體和 JAVA (部分機器翻譯)。

若要使用本文中的程式碼範例，請遵循下列步驟來設定您的專案。

注意

本文使用 Maven 建置工具來建置和執行範例程式碼。 Gradle 等其他建置工具也能與適用於 Java 的 Azure SDK 搭配運作。

安裝套件

在文字編輯器中開啟 pom.xml 檔案。 包含 BOM 檔案或包含直接相依性以安裝套件。

新增 import 陳述式

加入下列 import 陳述式：

import com.azure.storage.blob.*;
import com.azure.storage.blob.specialized.*;

授權

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

建立用戶端物件

若要將應用程式連線至 Blob 儲存體，請建立 BlobServiceClient類別的執行個體。

下列範例會使用 BlobServiceClientBuilder，使用 DefaultAzureCredential 建置 BlobServiceClient 物件，並視需要示範如何建立容器和 Blob 用戶端：

// Azure SDK client builders accept the credential as a parameter
// TODO: Replace <storage-account-name> with your actual storage account name
BlobServiceClient blobServiceClient = new BlobServiceClientBuilder()
        .endpoint("https://<storage-account-name>.blob.core.windows.net/")
        .credential(new DefaultAzureCredentialBuilder().build())
        .buildClient();

// If needed, you can create a BlobContainerClient object from the BlobServiceClient
BlobContainerClient containerClient = blobServiceClient
        .getBlobContainerClient("<container-name>");

// If needed, you can create a BlobClient object from the BlobContainerClient
BlobClient blobClient = containerClient
        .getBlobClient("<blob-name>");

若要深入了解如何建立及管理用戶端物件，請參閱建立和管理與資料資源互動的用戶端端物件 (部分機器翻譯)。

關於從來源物件 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 的內容執行部分更新，請使用 Put Block From URL API 和 Put Block List。

若要深入了解 Put Blob From URL 作業，包括 Blob 大小限制和計費考量事項，請參閱 Put Blob From URL 備註 (部分機器翻譯)。

從來源物件 URL 複製 Blob

本節提供適用於 Java 的 Azure 儲存體用戶端程式庫提供的方法概觀，以從來源物件 URL 執行複製作業。

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

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

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

從 Azure 中的來源複製 Blob

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

下列範例顯示從 Azure 內的來源 Blob 複製的案例。 uploadFromUrl 方法可以選擇性地接受布林值參數，以指出是否應該覆寫現有的 Blob，如範例所示。

public void copyFromSourceInAzure(BlobClient sourceBlob, BlockBlobClient destinationBlob) {
    // Get the source blob URL and create the destination blob
    // set overwrite param to true if you want to overwrite an existing blob
    destinationBlob.uploadFromUrl(sourceBlob.getBlobUrl(), false);
}

uploadFromUrlWithResponse 方法也可以接受 BlobUploadFromUrlOptions 參數，以指定作業的進一步選項。

從外部來源複製 Blob

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

public void copyFromExternalSource(String sourceURL, BlockBlobClient destinationBlob) {
    // Create the destination blob from the source URL
    // set overwrite param to true if you want to overwrite an existing blob
    destinationBlob.uploadFromUrl(sourceURL, false);
}

資源

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

程式碼範例

REST API 操作

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

用戶端程式庫資源

相關內容

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