Usar marcas de índice de blob para gerenciar e localizar dados no Armazenamento de Blobs do Azure

As tags de índice de Blob categorizam os dados em sua conta de armazenamento usando atributos de tag chave-valor. Essas tags são automaticamente indexadas e expostas como um índice multidimensional pesquisável para encontrar dados facilmente. Este artigo mostra como definir, obter e localizar dados usando tags de índice de blob.

Para saber mais sobre esse recurso, juntamente com problemas e limitações conhecidos, consulte Gerenciar e localizar dados de Blob do Azure com tags de índice de blob.

Carregar um novo blob com tags de índice

Essa tarefa pode ser executada por um Proprietário de Dados de Blob de Armazenamento ou por uma entidade de segurança que tenha recebido permissão para a operação do provedor de recursos do Azure por meio de uma função personalizada do Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write Azure.

Portal

1. No portal do Azure, selecione sua conta de armazenamento.

2. Navegue até a opção Contêineres em Armazenamento de dados e selecione seu contêiner.

3. Selecione o botão Carregar e navegue pelo sistema de arquivos local para encontrar um arquivo para carregar como um blob de bloco.

4. Expanda a lista suspensa Avançado e vá para a seção Tags de índice de Blob.

5. Insira as tags de índice de blob de chave/valor que você deseja aplicar aos seus dados.

6. Selecione o botão Carregar para carregar o blob.

   

PowerShell

1. Inicie sessão na sua subscrição do Azure com o comando Connect-AzAccount e siga as instruções no ecrã.

   Connect-AzAccount
   

2. Se a sua identidade estiver associada a mais do que uma subscrição, defina a sua subscrição ativa. Em seguida, obtenha o contexto da conta de armazenamento.

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

3. Carregue um blob usando o Set-AzStorageBlobContent comando. Defina tags usando o -Tag parâmetro.

   $containerName = "myContainer"
   $file = "C:\demo-file.txt"
   
   Set-AzStorageBlobContent -File $file -Container $containerName -Context $ctx -Tag @{"tag1" = "value1"; "tag2" = "value2" }
   

CLI do Azure

1. Abra o Azure Cloud Shell ou, se tiver instalado a CLI do Azure localmente, abra um aplicativo de console de comando, como o Windows PowerShell.

2. Instale a extensão storage-preview.

   az extension add -n storage-preview
   

3. Se você estiver usando a CLI do Azure localmente, execute o comando logon.

   az login
   

4. Se a sua identidade estiver associada a mais do que uma subscrição, defina a sua subscrição ativa como subscrição da conta de armazenamento.

   az account set --subscription <subscription-id>
   

   Substitua o valor do espaço reservado <subscription-id> pelo ID da sua assinatura.

5. Carregue um blob usando o az storage blob upload comando. Defina tags usando o --tags parâmetro.

   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

Consulte Carregar com tags de índice.

Obter, definir e atualizar tags de índice de blob

A obtenção de tags de índice de blob pode ser executada por um Proprietário de Dados de Blob de Armazenamento ou por uma entidade de segurança que tenha recebido permissão para a operação do provedor de recursos do Azure por meio de uma função personalizada do Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read Azure.

A definição e a atualização de marcas de índice de blob podem ser executadas por um Proprietário de Dados de Blob de Armazenamento ou por uma entidade de segurança que tenha recebido permissão para a operação do provedor de recursos do Azure por meio de uma função personalizada do Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write Azure.

Portal

1. No portal do Azure, selecione sua conta de armazenamento.

2. Navegue até a opção Contêineres em Armazenamento de dados, selecione seu contêiner.

3. Selecione seu blob na lista de blobs dentro do contêiner selecionado.

4. A guia de visão geral do blob exibirá as propriedades do seu blob, incluindo quaisquer tags de índice de blob.

5. Você pode obter, definir, modificar ou excluir qualquer uma das tags de índice de chave/valor do seu blob.

6. Selecione o botão Salvar para confirmar quaisquer atualizações no seu blob.

   

PowerShell

1. Inicie sessão na sua subscrição do Azure com o comando Connect-AzAccount e siga as instruções no ecrã.

   Connect-AzAccount
   

2. Se a sua identidade estiver associada a mais do que uma subscrição, defina a sua subscrição ativa. Em seguida, obtenha o contexto da conta de armazenamento.

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

3. Para obter as tags de um blob, use o Get-AzStorageBlobTag comando e defina o -Blob parâmetro como o nome do blob.

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

4. Para definir as tags de um blob, use o Set-AzStorageBlobTag comando. Defina o -Blob parâmetro como o nome do blob e defina o -Tag parâmetro como uma coleção de pares de nome e valor.

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

CLI do Azure

1. Abra o Azure Cloud Shell ou, se tiver instalado a CLI do Azure localmente, abra um aplicativo de console de comando, como o Windows PowerShell.

2. Instale a extensão storage-preview.

   az extension add -n storage-preview
   

3. Se você estiver usando a CLI do Azure localmente, execute o comando logon.

   az login
   

4. Se a sua identidade estiver associada a mais do que uma subscrição, defina a sua subscrição ativa como subscrição da conta de armazenamento.

   az account set --subscription <subscription-id>
   

   Substitua o valor do espaço reservado <subscription-id> pelo ID da sua assinatura.

5. Para obter as tags de um blob, use o az storage blob tag list comando e defina o --name parâmetro como o nome do blob.

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

6. Para definir as tags de um blob, use o az storage blob tag set comando. Defina o --name parâmetro como o nome do blob e defina o --tags parâmetro como uma coleção de pares de nome e valor.

   az storage blob tag set --account-name mystorageaccount --container-name myContainer --name demo-file.txt --tags tag1=value1 tag2=value2 --auth-mode login
   

AzCopy

Consulte Substituir tags de índice

Filtrar e localizar dados com tags de índice de blob

Essa tarefa pode ser executada por um Proprietário de Dados de Blob de Armazenamento ou por uma entidade de segurança que tenha recebido permissão para a operação do provedor de recursos do Azure por meio de uma função personalizada do Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action Azure.

Nota

Não é possível usar tags de índice para recuperar versões anteriores. As tags de versões anteriores não são passadas para o mecanismo de índice de blob. Para obter mais informações, consulte Condições e problemas conhecidos.

Portal

No portal do Azure, o filtro de marcas de índice de blob aplica automaticamente o @container parâmetro ao escopo do contêiner selecionado. Se você deseja filtrar e encontrar dados marcados em toda a sua conta de armazenamento, use nossa API REST, SDKs ou ferramentas.

1. No portal do Azure, selecione sua conta de armazenamento.

2. Navegue até a opção Contêineres em Armazenamento de dados, selecione seu contêiner.

3. Selecione o botão de filtro de tags de índice de Blob para filtrar dentro do contêiner selecionado.

4. Insira uma chave de tag de índice de blob e um valor de tag.

5. Selecione o botão de filtro de tags de índice de Blob para adicionar filtros de tags adicionais (até 10).

   

PowerShell

1. Inicie sessão na sua subscrição do Azure com o comando Connect-AzAccount e siga as instruções no ecrã.

   Connect-AzAccount
   

2. Se a sua identidade estiver associada a mais do que uma subscrição, defina a sua subscrição ativa. Em seguida, obtenha o contexto da conta de armazenamento.

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

3. Para localizar todos os blobs que correspondem a uma tag de blob específica, use o Get-AzStorageBlobByTag comando.

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

4. Para localizar blobs somente em um contêiner específico, inclua o nome do contêiner no -TagFilterSqlExpression.

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

CLI do Azure

1. Abra o Azure Cloud Shell ou, se tiver instalado a CLI do Azure localmente, abra um aplicativo de console de comando, como o Windows PowerShell.

2. Instale a extensão storage-preview.

   az extension add -n storage-preview
   

3. Se você estiver usando a CLI do Azure localmente, execute o comando logon.

   az login
   

4. Se a sua identidade estiver associada a mais do que uma subscrição, defina a sua subscrição ativa como subscrição da conta de armazenamento.

   az account set --subscription <subscription-id>
   

   Substitua o valor do espaço reservado <subscription-id> pelo ID da sua assinatura.

5. Para localizar todos os blobs que correspondem a uma tag de blob específica, use o az storage blob filter comando.

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

6. Para localizar blobs somente em um contêiner específico, inclua o nome do --tag-filter contêiner no parâmetro.

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

AzCopy

N/A

Próximos passos

• Saiba mais sobre tags de índice de blob, consulte Gerenciar e localizar dados de Blob do Azure com tags de índice de blob
• Saiba mais sobre o gerenciamento do ciclo de vida, consulte Gerenciar o ciclo de vida do Armazenamento de Blobs do Azure
• Saiba mais sobre como definir marcas de índice em objetos em escala em várias contas de armazenamento. Consulte O que são as Ações de Armazenamento do Azure?