共用方式為

透過 .NET 使用 Blob 索引標籤來管理和尋找資料

  • 發行項

本文說明如何利用適用於 .NET 的 Azure 儲存體用戶端程式庫來使用 Blob 索引標籤以管理和尋找資料。

必要條件

關於 Blob 索引標籤

Blob 索引標記會使用索引鍵/值標記屬性，將儲存體帳戶中的資料分類。 這些標記會自動編製索引，並公開為可搜尋的多維度索引，以便輕鬆地尋找資料。 本文說明如何使用 Blob 索引標記來設定、取得及尋找資料。

已啟用階層命名空間的儲存體帳戶不支援 Blob 索引標籤。 若要深入了解 Blob 索引標籤功能以及已知問題和限制，請參閱使用 Blob 索引標籤來管理及尋找 Azure Blob 資料。

設定標記

如果您的程式碼透過以下其中一種機制獲得授權可以存取 Blob 資料，則您可以設定索引標籤：

如需詳細資訊，請參閱設定 Blob 索引標籤。

您可以使用下列任一方法來設定標籤：

以下範例會執行此工作。

public static async Task SetTags(BlobClient blobClient)
{
    Dictionary<string, string> tags = 
        new Dictionary<string, string>
    {
        { "Sealed", "false" },
        { "Content", "image" },
        { "Date", "2020-04-20" }
    };

    await blobClient.SetTagsAsync(tags);
}

您可以透過將空白 [Dictionary] 傳遞至 SetTags 或 SetTagsAsync 方法來刪除所有標籤，如下列範例所示。

Dictionary<string, string> noTags = new Dictionary<string, string>();
await blobClient.SetTagsAsync(noTags);
相關文章
使用 Blob 索引標籤來管理及尋找 Azure Blob 資料
設定 Blob 標籤 (REST API)

取得標籤

如果您的程式碼透過以下其中一種機制獲得授權可以存取 Blob 資料，則您可以取得索引標籤：

如需詳細資訊，請參閱取得和列出 Blob 索引標籤。

您可以使用下列任一方法來取得標籤：

以下範例會執行此工作。

public static async Task GetTags(BlobClient blobClient)
{
    Response<GetBlobTagResult> tagsResponse = await blobClient.GetTagsAsync();

    foreach (KeyValuePair<string, string> tag in tagsResponse.Value.Tags)
    {
        Console.WriteLine($"{tag.Key}={tag.Value}");
    }
}

使用 Blob 索引標記篩選和尋找資料

如果您的程式碼透過以下其中一種機制獲得授權可以存取 Blob 資料，則您可以使用索引標籤來尋找和篩選資料：

如需詳細資訊，請參閱使用 Blob 索引標籤來尋找資料。

注意

您無法使用索引標籤來擷取先前的版本。 先前版本的標記不會傳遞至 Blob 索引引擎。 如需詳細資訊，請參閱條件和已知問題。

您可以使用下列任一方法來尋找資料：

下列範例會尋找標記於特定日期範圍之間的所有 Blob。

public static async Task FindBlobsbyTags(BlobServiceClient serviceClient)
{
    string query = @"""Date"" >= '2020-04-20' AND ""Date"" <= '2020-04-30'";

    // Find Blobs given a tags query
    Console.WriteLine("Find Blob by Tags query: " + query + Environment.NewLine);

    List<TaggedBlobItem> blobs = new List<TaggedBlobItem>();
    await foreach (TaggedBlobItem taggedBlobItem in serviceClient.FindBlobsByTagsAsync(query))
    {
        blobs.Add(taggedBlobItem);
    }

    foreach (var filteredBlob in blobs)
    {
        
        Console.WriteLine($"BlobIndex result: ContainerName= {filteredBlob.BlobContainerName}, " +
            $"BlobName= {filteredBlob.BlobName}");
    }

}

資源

若要深入了解如何利用適用於 .NET 的 Azure Blob 儲存體用戶端程式庫來使用索引標籤管理及尋找資料，請參閱下列資源。

REST API 操作

Azure SDK for .NET 包含建置在 Azure REST API 之上的程式庫，可讓您透過熟悉的 .NET 範例與 REST API 作業進行互動。 用來管理和使用 Blob 索引標籤的用戶端程式庫方法會使用下列 REST API 作業：

用戶端程式庫資源

另請參閱