使用 Blob 索引標記來管理和尋找 Azure Blob 儲存體上的資料

發行項
06/01/2023

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

若要深入了解這項功能以及已知的問題和限制，請參閱使用 Blob 索引標記來管理和尋找 Azure Blob 資料。

使用索引標記上傳新的 Blob

這項工作可由儲存體 Blob 資料擁有者或透過自訂 Azure 角色授與 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeAzure 資源提供者作業權限的安全性主體來執行。

在 Azure 入口網站中，選取您的儲存體帳戶。
瀏覽至 [資料儲存體] 底下的 [容器] 選項，然後選取您的容器。
選取 [上傳] 按鈕，然後瀏覽您的本機檔案系統，尋找要上傳做為區塊 Blob 的檔案。
展開 [進階] 下拉式清單，並移至 [Blob 索引標記] 區段。
輸入您想要套用至資料的索引鍵/值 Blob 索引標記。
選取 [上傳] 按鈕上傳 Blob。

使用 Connect-AzAccount 命令登入 Azure 訂用帳戶並遵循畫面上的指示。
```
Connect-AzAccount
```

如果您的身分識別與多個訂用帳戶相關聯，請設定使用中的訂用帳戶。然後，取得儲存體帳戶內容。

$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context

使用 Set-AzStorageBlobContent 命令上傳 Blob。使用 -Tag 參數設定標記。

$containerName = "myContainer"
$file = "C:\demo-file.txt"

Set-AzStorageBlobContent -File $file -Container $containerName -Context $ctx -Tag @{"tag1" = "value1"; "tag2" = "value2" }

開啟 Azure Cloud Shell，或如果您已在本機安裝 Azure CLI，請開啟命令主控台應用程式，例如 Windows PowerShell。
安裝 storage-preview 延伸模組。
```
az extension add -n storage-preview
```
如果您在本機使用 Azure CLI，請執行登入命令。
```
az login
```
若身分識別與多個訂用帳戶建立關聯，請將使用中訂用帳戶設為儲存體帳戶的訂用帳戶。
```
az account set --subscription <subscription-id>
```
使用訂閱識別碼取代 <subscription-id> 預留位置值。

使用 az storage blob upload 命令上傳 Blob。使用 --tags 參數設定標記。

az storage blob upload --account-name mystorageaccount --container-name myContainer --name demo-file.txt --file C:\demo-file.txt --tags tag1=value1 tag2=value2 --auth-mode login

取得、設定和更新 Blob 索引標記

取得 Blob 索引標記可由儲存體 Blob 資料擁有者或透過自訂 Azure 角色授與 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/readAzure 資源提供者作業權限的安全性主體來執行。

設定和更新 Blob 索引標記可由儲存體 Blob 資料擁有者或透過自訂 Azure 角色授與 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeAzure 資源提供者作業權限的安全性主體來執行。

在 Azure 入口網站中，選取您的儲存體帳戶。
瀏覽至 [資料儲存體] 底下的 [容器] 選項，然後選取您的容器。
從所選容器內的 Blob 清單中選取您的 Blob。
[Blob 概觀] 索引標籤會顯示您的 Blob 屬性，包括任何 Blob 索引標記。
您可以取得、設定、修改或刪除 Blob 的任何索引鍵/值索引標記。
選取 [儲存] 按鈕，以確認您 Blob 的任何更新。

使用 Connect-AzAccount 命令登入 Azure 訂用帳戶並遵循畫面上的指示。
```
Connect-AzAccount
```

如果您的身分識別與多個訂用帳戶相關聯，請設定使用中的訂用帳戶。然後，取得儲存體帳戶內容。

$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context

若要取得 Blob 的標記，請使用 Get-AzStorageBlobTag 命令，並將 -Blob 參數設定為 Blob 的名稱。

$containerName = "myContainer"
$blobName = "myBlob" 
Get-AzStorageBlobTag -Context $ctx -Container $containerName -Blob $blobName

若要設定 Blob 的標記，請使用 Set-AzStorageBlobTag 命令。將 -Blob 參數設定為 Blob 的名稱，並將 -Tag 參數設定為名稱和值組的集合。

$containerName = "myContainer"
$blobName = "myBlob" 
$tags = @{"tag1" = "value1"; "tag2" = "value2" }
Set-AzStorageBlobTag -Context $ctx -Container $containerName -Blob $blobName -Tag $tags

開啟 Azure Cloud Shell，或如果您已在本機安裝 Azure CLI，請開啟命令主控台應用程式，例如 Windows PowerShell。
安裝 storage-preview 延伸模組。
```
az extension add -n storage-preview
```
如果您在本機使用 Azure CLI，請執行登入命令。
```
az login
```
若身分識別與多個訂用帳戶建立關聯，請將使用中訂用帳戶設為儲存體帳戶的訂用帳戶。
```
az account set --subscription <subscription-id>
```
使用訂閱識別碼取代 <subscription-id> 預留位置值。

若要取得 Blob 的標記，請使用 az storage blob tag list 命令，並將 --name 參數設定為 Blob 的名稱。

az storage blob tag list --account-name mystorageaccount --container-name myContainer --name demo-file.txt --auth-mode login

若要設定 Blob 的標記，請使用 az storage blob tag set 命令。將 --name 參數設定為 Blob 的名稱，並將 --tags 參數設定為名稱和值組的集合。
```
az storage blob tag set --account-name mystorageaccount --container-name myContainer --name demo-file.txt --tags tag1=value1 tag2=value2 --auth-mode login
```

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

這項工作可由儲存體 Blob 資料擁有者或透過自訂 Azure 角色授與 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/actionAzure 資源提供者作業權限的安全性主體來執行。

注意

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

在 Azure 入口網站內，Blob 索引標記篩選會自動套用 @container 參數，將範圍限制為所選容器。如果您想要在整個儲存體帳戶中篩選並尋找已標記的資料，請使用我們的 REST API、SDK 或工具。

在 Azure 入口網站中，選取您的儲存體帳戶。
瀏覽至 [資料儲存體] 底下的 [容器] 選項，然後選取您的容器。
選取 [Blob 索引標記篩選] 按鈕，以在所選取的容器內進行篩選。
輸入 Blob 索引標記索引鍵和標記值。
選取 [Blob 索引標記篩選] 按鈕，以新增其他標記篩選 (最多 10 個)。

使用 Connect-AzAccount 命令登入 Azure 訂用帳戶並遵循畫面上的指示。
```
Connect-AzAccount
```

如果您的身分識別與多個訂用帳戶相關聯，請設定使用中的訂用帳戶。然後，取得儲存體帳戶內容。

$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context

若要尋找符合特定 Blob 標記的所有 Blob，請使用 Get-AzStorageBlobByTag 命令。

$filterExpression = """tag1""='value1'"
Get-AzStorageBlobByTag -TagFilterSqlExpression $filterExpression -Context $ctx

若要只在特定容器中尋找 Blob，請在 -TagFilterSqlExpression 中包含容器名稱。

$filterExpression = "@container='myContainer' AND ""tag1""='value1'"
Get-AzStorageBlobByTag -TagFilterSqlExpression $filterExpression -Context $ctx

開啟 Azure Cloud Shell，或如果您已在本機安裝 Azure CLI，請開啟命令主控台應用程式，例如 Windows PowerShell。
安裝 storage-preview 延伸模組。
```
az extension add -n storage-preview
```
如果您在本機使用 Azure CLI，請執行登入命令。
```
az login
```
若身分識別與多個訂用帳戶建立關聯，請將使用中訂用帳戶設為儲存體帳戶的訂用帳戶。
```
az account set --subscription <subscription-id>
```
使用訂閱識別碼取代 <subscription-id> 預留位置值。

若要尋找符合特定 Blob 標記的所有 Blob，請使用 az storage blob filter 命令。

az storage blob filter --account-name mystorageaccount --tag-filter """tag1""='value1' and ""tag2""='value2'" --auth-mode login

若要只在特定容器中尋找 Blob，請在 --tag-filter 參數中包含容器名稱。

az storage blob filter --account-name mystorageaccount --tag-filter """@container""='myContainer' and ""tag1""='value1' and ""tag2""='value2'" --auth-mode login

下一步

深入瞭解 Blob 索引標籤，請參閱使用 Blob 索引標記管理和尋找 Azure Blob 資料
深入瞭解生命週期管理的詳細資訊，請參閱管理 Azure Blob 儲存體生命週期

使用 Blob 索引標記來管理和尋找 Azure Blob 儲存體上的資料

使用索引標記上傳新的 Blob

取得、設定和更新 Blob 索引標記

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

下一步

其他資源