共用方式為

使用 JAVA 設定或變更區塊 Blob 的存取層

  • 發行項

本文說明如何使用適用於 JAVA 的 Azure 儲存體用戶端程式庫來設定或變更區塊 Blob 的存取層。

必要條件

設定您的環境

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

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

注意

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

安裝套件

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

新增 import 陳述式

加入下列 import 陳述式：

import com.azure.core.util.polling.LongRunningOperationStatus;
import com.azure.core.util.polling.PollResponse;
import com.azure.core.util.polling.SyncPoller;
import com.azure.storage.blob.*;
import com.azure.storage.blob.models.*;
import com.azure.storage.blob.options.BlobBeginCopyOptions;

授權

授權機制必須具有設定 Blob 存取層所需的權限。 如需使用 Microsoft Entra ID 授權 (建議使用)，您需要 Azure RBAC 內建角色儲存體 Blob 資料參與者或更高權限。 若要深入了解，請參閱設定 Blob 階層的授權指導。

建立用戶端物件

若要將應用程式連線至 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>");

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

關於區塊 Blob 存取層

為了管理儲存體需求的成本，根據資料的存取頻率和資料需要保留的時間長度來組織資料會很有幫助。 Azure 儲存體提供不同的存取層，讓您可以根據 Blob 資料的使用方式，以最符合成本效益的方式來儲存 Blob 資料。

blob 資料的存取層

Azure 儲存體存取層包括：

  • 經常性存取層：已針對儲存經常存取或修改的資料最佳化的線上層。 經常性存取層的儲存體成本最高，但存取成本最低。
  • 非經常性儲存層：已針對儲存不常存取或修改的資料最佳化的線上層。 非經常性存取層中的資料至少應儲存 30 天。 相較於經常性存取層，非經常性儲存層的儲存體成本較低且存取成本較高。
  • 非經常性儲存層 - 已針對儲存不常存取或修改的資料最佳化的線上層。 極非經常性存取層中的資料至少應儲存 90 天。 相較於非經常性存取層，極非經常性存取層的儲存體成本較低但存取成本較高。
  • 封存層：已針對儲存極少存取且具有彈性延遲需求的資料最佳化 (以小時為單位) 的離線層。 封存層中的資料至少應儲存 180 天。

若要深入了解存取層，請參閱 Blob 資料的存取層。

位於封存存取層的 Blob 會被視為離線，而且無法讀取或修改。 若要讀取或修改封存 Blob 中的資料，您必須先將 Blob 解除凍結至線上層。 如需有關將 Blob 從封存層解除凍結至線上層的詳細資訊，請參閱將 Blob 自封存層解除凍結。

限制

只有區塊 Blob 才能設定存取層。 若要深入了解設定區塊 Blob 存取層的限制，請參閱設定 Blob 層 (REST API)。

注意

若要使用 JAVA 將存取層設定為 Cold，您必須至少使用用戶端程式庫版本 12.21.0。

在 Blob 上傳期間設定存取層

您可以使用 BlobUploadFromFileOptions 類別在 Blob 上傳時設定存取層。 下列程式碼範例說明如何在上傳 Blob 時設定存取層：

public void uploadBlobWithAccessTier(BlobContainerClient blobContainerClient, Path filePath) {
    String fileName = filePath.getFileName().toString();
    BlobClient blobClient = blobContainerClient.getBlobClient(fileName);

    BlobUploadFromFileOptions options = new BlobUploadFromFileOptions(filePath.toString())
            .setTier(AccessTier.COOL);

    try {
        Response<BlockBlobItem> blockBlob = blobClient.uploadFromFileWithResponse(options, null, null);
    } catch (UncheckedIOException ex) {
        System.err.printf("Failed to upload from file: %s%n", ex.getMessage());
    }
}

若要深入了解使用 JAVA 上傳 Blob，請參閱使用 JAVA 上傳 Blob (部分機器翻譯)。

為現有的區塊 Blob 變更存取層

您可以使用下列其中一項方法來變更現有區塊 Blob 的存取層：

下列程式碼範例說明如何將現有 Blob 的存取層變更為非經常性存取層：

public void changeBlobAccessTier(BlobClient blobClient) {
    // Change the blob's access tier to cool
    blobClient.setAccessTier(AccessTier.COOL);
}

如果您要解除凍結封存的 Blob，請使用 setAccessTierWithResponse 方法。 將 tier 參數設定為有效的 AccessTier 值：HOT、COOL、COLD 或 ARCHIVE。 您可以選擇性地將 priority 參數設定為有效的 RehydratePriority 值：HIGH 或 STANDARD。

下列程式碼範例說明如何將存取層變更為經常性存取層，以將封存的 Blob 解除凍結：

public void rehydrateBlobSetAccessTier(BlobClient blobClient) {
    // Rehydrate the blob to hot tier using a standard rehydrate priority
    blobClient.setAccessTierWithResponse(
        AccessTier.HOT,
        RehydratePriority.STANDARD,
        null, 
        null, 
        null);
}

setAccessTierWithResponse 方法也可以接受 BlobSetAccessTierOptions 參數來指定設定選項。

將 Blob 複製到不同的存取層

您可以將存取層指定為複製作業的一部分，以變更現有區塊 Blob 的存取層。 若要在複製作業期間變更存取層，請使用 BlobBeginCopyOptions 類別。

您可以使用 setTier 方法，將 AccessTier 值指定為 HOT、COOL、COLD 或 ARCHIVE。 如果您使用複製作業從封存層解除凍結 Blob，請使用 setRehydratePriority 方法以將 RehydratePriority 值指定為 HIGH 或 STANDARD。

下列程式碼範例說明如何使用複製作業，將封存的 Blob 解除凍結為經常性存取層：

public void rehydrateBlobUsingCopy(
    BlobClient sourceArchiveBlob,
    BlobClient destinationRehydratedBlob) {
    // Note: the destination blob must have a different name than the archived source blob

    // Start the copy operation and wait for it to complete
    final SyncPoller<BlobCopyInfo, Void> poller = destinationRehydratedBlob.beginCopy(
            new BlobBeginCopyOptions(sourceArchiveBlob.getBlobUrl())
                    .setTier(AccessTier.HOT)
                    .setRehydratePriority(RehydratePriority.STANDARD));
                    
    PollResponse<BlobCopyInfo> response = poller
            .waitUntil(LongRunningOperationStatus.SUCCESSFULLY_COMPLETED);
}

若要深入了解使用 JAVA 複製 Blob，請參閱使用 JAVA 複製 Blob (部分機器翻譯)。

資源

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

程式碼範例

REST API 操作

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

用戶端程式庫資源

另請參閱

相關內容

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