BLOB インデックス タグを使用して Azure Blob Storage でデータを管理および検索する

キーと値のタグ属性を使用して、BLOB インデックス タグによってストレージ アカウント内のデータが分類されます。 これらのタグには自動的にインデックスが付けられ、検索可能な多次元インデックスとして公開されるため、データを簡単に見つけることができます。 この記事では、BLOB インデックス タグを使用してデータを設定、取得、および検索する方法について説明します。

この機能と既知の問題および制限の詳細については、「BLOB インデックス タグを使用して Azure BLOB データを管理および検索する」を参照してください。

インデックス タグを使用して新しい BLOB をアップロードする

このタスクは、ストレージ BLOB データ所有者か、カスタム Azure ロール経由で Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write Azure リソース プロバイダー操作にアクセスする権利が与えられているセキュリティ プリンシパルが実行できます。

ポータル

1. Azure portal で、ストレージ アカウントを選択します。

2. [データ ストレージ] の [コンテナー] オプションに移動し、コンテナーを選択します

3. [アップロード] ボタンを選択してローカル ファイル システムを参照し、ブロック BLOB としてアップロードするファイルを探します。

4. [詳細] ドロップダウンを展開し、 [Blob Index Tags](BLOB インデックス タグ) セクションに移動します

5. データに適用する、キーと値の BLOB インデックス タグを入力します。

6. [アップロード] ボタンを選択して、BLOB をアップロードします。

   

PowerShell

1. Connect-AzAccount コマンドを使用して Azure サブスクリプションにサインインし、画面上の指示に従います。

   Connect-AzAccount
   

2. 自分の ID が複数のサブスクリプションに関連付けられている場合は、アクティブなサブスクリプションを設定します。 その後、ストレージ アカウント コンテキストを取得します。

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

3. 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 CLI

1. Azure Cloud Shell を開きます。または、Azure CLI をローカルにインストールした場合は、Windows PowerShell などのコマンド コンソール アプリケーションを開きます。

2. storage-preview 拡張機能をインストールします。

   az extension add -n storage-preview
   

3. Azure CLI をローカルで使用している場合は、login コマンドを実行します。

   az login
   

4. 自分の ID が複数のサブスクリプションに関連付けられている場合は、アクティブなサブスクリプションをストレージ アカウントのサブスクリプションに設定します。

   az account set --subscription <subscription-id>
   

   <subscription-id> プレースホルダーの値をサブスクリプションの ID に置き換えます。

5. 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
   

AzCopy

「インデックス タグを使用してアップロードする」を参照してください。

BLOB インデックス タグを取得、設定、および更新する

BLOB インデックス タグを取得できるのは、ストレージ BLOB データ所有者か、カスタム Azure ロール経由で Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read Azure リソース プロバイダー操作にアクセスする権利が与えられているセキュリティ プリンシパルです。

BLOB インデックス タグを設定し、更新できるのは、ストレージ BLOB データ所有者か、カスタム Azure ロール経由で Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write Azure リソース プロバイダー操作にアクセスする権利が与えられているセキュリティ プリンシパルです。

ポータル

1. Azure portal で、ストレージ アカウントを選択します。

2. [データ ストレージ] の [コンテナー] オプションに移動し、コンテナーを選択します

3. 選択したコンテナー内の BLOB の一覧から BLOB を選択します。

4. BLOB の概要タブに、すべての BLOB インデックス タグを含む、BLOB のプロパティが表示されます。

5. BLOB の任意のキーと値のインデックス タグを取得、設定、変更、または削除できます。

6. [保存] を選択して、BLOB の更新を確定します。

   

PowerShell

1. Connect-AzAccount コマンドを使用して Azure サブスクリプションにサインインし、画面上の指示に従います。

   Connect-AzAccount
   

2. 自分の ID が複数のサブスクリプションに関連付けられている場合は、アクティブなサブスクリプションを設定します。 その後、ストレージ アカウント コンテキストを取得します。

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

3. BLOB のタグを取得するには、Get-AzStorageBlobTag コマンドを使い、-Blob パラメーターに BLOB の名前を設定します。

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

4. 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 CLI

1. Azure Cloud Shell を開きます。または、Azure CLI をローカルにインストールした場合は、Windows PowerShell などのコマンド コンソール アプリケーションを開きます。

2. storage-preview 拡張機能をインストールします。

   az extension add -n storage-preview
   

3. Azure CLI をローカルで使用している場合は、login コマンドを実行します。

   az login
   

4. 自分の ID が複数のサブスクリプションに関連付けられている場合は、アクティブなサブスクリプションをストレージ アカウントのサブスクリプションに設定します。

   az account set --subscription <subscription-id>
   

   <subscription-id> プレースホルダーの値をサブスクリプションの ID に置き換えます。

5. 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
   

6. 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
   

AzCopy

「インデックス タグを置換する」を参照してください

BLOB インデックス タグを使用してデータをフィルター処理および検索する

このタスクは、ストレージ BLOB データ所有者か、カスタム Azure ロール経由で Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action Azure リソース プロバイダー操作にアクセスする権利が与えられているセキュリティ プリンシパルが実行できます。

Note

インデックス タグを使用して以前のバージョンを取得することはできません。 以前のバージョンのタグは BLOB インデックス エンジンに渡されません。 詳細については、条件と既知の問題に関するページを参照してください。

ポータル

Azure portal 内では、BLOB インデックス タグ フィルターによって @container パラメーターが自動的に適用され、選択したコンテナーがスコープになります。 ストレージ アカウント全体で、タグ付けされたデータをフィルター処理して検索する場合は、REST API、SDK、またはツールを使用してください。

1. Azure portal で、ストレージ アカウントを選択します。

2. [データ ストレージ] の [コンテナー] オプションに移動し、コンテナーを選択します

3. [Blob Index tags filter](BLOB インデックス タグのフィルター) を選択し、選択したコンテナー内でフィルター処理を行います。

4. BLOB のインデックス タグ キーとタグ値を入力します。

5. 追加のタグ フィルター (最大 10 個) を追加するには、 [Blob Index tags filter](BLOB インデックス タグのフィルター) を選択します。

   

PowerShell

1. Connect-AzAccount コマンドを使用して Azure サブスクリプションにサインインし、画面上の指示に従います。

   Connect-AzAccount
   

2. 自分の ID が複数のサブスクリプションに関連付けられている場合は、アクティブなサブスクリプションを設定します。 その後、ストレージ アカウント コンテキストを取得します。

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

3. 特定の BLOB タグに一致するすべての BLOB を検索するには、Get-AzStorageBlobByTag コマンドを使います。

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

4. 特定のコンテナー内の BLOB のみを検索するには、-TagFilterSqlExpression にコンテナー名を含めます。

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

Azure CLI

1. Azure Cloud Shell を開きます。または、Azure CLI をローカルにインストールした場合は、Windows PowerShell などのコマンド コンソール アプリケーションを開きます。

2. storage-preview 拡張機能をインストールします。

   az extension add -n storage-preview
   

3. Azure CLI をローカルで使用している場合は、login コマンドを実行します。

   az login
   

4. 自分の ID が複数のサブスクリプションに関連付けられている場合は、アクティブなサブスクリプションをストレージ アカウントのサブスクリプションに設定します。

   az account set --subscription <subscription-id>
   

   <subscription-id> プレースホルダーの値をサブスクリプションの ID に置き換えます。

5. 特定の BLOB タグに一致するすべての BLOB を検索するには、az storage blob filter コマンドを使います。

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

6. 特定のコンテナー内の BLOB のみを検索するには、--tag-filter パラメーターにコンテナー名を含めます。

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

AzCopy

該当なし

次のステップ

• BLOB インデックス タグの詳細については、「BLOB インデックス タグを使用して Azure BLOB データを管理および検索する」を参照してください
• ライフサイクル管理の詳細については、「Azure Blob Storage のライフサイクルを管理する」を参照してください
• 複数のストレージ アカウント間で大規模にオブジェクトにインデックス タグを設定する方法について説明します。 「Azure Storage Actions とは」を参照してください。