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

As marcas de índice de blob categorizam os dados na sua conta de armazenamento usando atributos de marca de chave-valor. Essas marcas são indexadas automaticamente e expostas como um índice multidimensional pesquisável para localizar dados com facilidade. Este artigo mostra como definir, obter e localizar dados usando marcas de índice de blob.

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

Carregar um novo blob com marcas de índice

Essa tarefa pode ser executada por um Proprietário de Dados do 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 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write por meio de uma função personalizada do Azure.

Portal

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

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

3. Selecione o botão Carregar e procure o seu sistema de arquivos local para encontrar um arquivo a ser carregado como um blob de blocos.

4. Expanda o menu suspenso Avançado e acesse a seção Marcas de Índice de Blob.

5. Insira as marcas de índice de blob de chave/valor que deseja aplicar aos dados.

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

   

PowerShell

1. Entre na sua assinatura do Azure com o comando Connect-AzAccount e siga as instruções na tela.

   Connect-AzAccount
   

2. Se sua identidade estiver associada a mais de uma assinatura, defina a assinatura como 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 comando Set-AzStorageBlobContent. Defina as marcas usando o parâmetro -Tag.

   $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 você instalou a CLI do Azure localmente, abra um aplicativo de console de comando, como 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 de logon.

   az login
   

4. Se sua identidade estiver associada a mais de uma assinatura, defina a assinatura ativa para a assinatura da conta de armazenamento.

   az account set --subscription <subscription-id>
   

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

5. Carregue um blob usando o comando az storage blob upload. Defina as marcas usando o parâmetro --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

Confira Carregar com marcas de índice.

Obter, definir e atualizar marcas de índice de BLOB

Obter as marcas de índice de blob pode ser executado por um Proprietário de Dados do 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 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read por meio de uma função personalizada do Azure.

A configuração e atualização das marcas de índice de blob podem ser executadas por um Proprietário de Dados do 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 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write por meio de uma função personalizada do Azure.

Portal

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

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

3. Escolha seu blob na lista de blobs no contêiner selecionado.

4. A guia de visão geral do blob exibirá as propriedades do blob, incluindo as Marcas de Índice de Blob.

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

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

   

PowerShell

1. Entre na sua assinatura do Azure com o comando Connect-AzAccount e siga as instruções na tela.

   Connect-AzAccount
   

2. Se sua identidade estiver associada a mais de uma assinatura, defina a assinatura como 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 marcas de um blob, use o comando Get-AzStorageBlobTag e defina o parâmetro -Blob como o nome do blob.

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

4. Para definir as marcas de um blob, use o comando Set-AzStorageBlobTag. Defina o parâmetro -Blob para o nome do blob e defina o parâmetro -Tag 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 você instalou a CLI do Azure localmente, abra um aplicativo de console de comando, como 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 de logon.

   az login
   

4. Se sua identidade estiver associada a mais de uma assinatura, defina a assinatura ativa para a assinatura da conta de armazenamento.

   az account set --subscription <subscription-id>
   

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

5. Para obter as marcas de um blob, use o comando az storage blob tag list e defina o parâmetro --name 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 marcas de um blob, use o comando az storage blob tag set. Defina o parâmetro --name para o nome do blob e defina o parâmetro --tags 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

Confira Substituir marcas de índice

Filtre e localize dados com marcas de índice de blob

Essa tarefa pode ser executada por um Proprietário de Dados do 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 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action por meio de uma função personalizada do Azure.

Observação

Não é possível usar marcas de índice para recuperar versões anteriores. As marcas para 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 parâmetro @container para criar o escopo do contêiner selecionado. Se você quiser filtrar e localizar dados marcados em toda a sua conta de armazenamento, use nossa API REST, nossos SDKs ou nossas ferramentas.

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

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

3. Selecione o botão Filtro de marcas de índice de blob para aplicar o filtro dentro do contêiner selecionado.

4. Insira o valor da marca e a chave da marca de índice de blob.

5. Selecione o botão Filtro de marcas de índice de blob para adicionar filtros de marca adicionais (até dez).

   

PowerShell

1. Entre na sua assinatura do Azure com o comando Connect-AzAccount e siga as instruções na tela.

   Connect-AzAccount
   

2. Se sua identidade estiver associada a mais de uma assinatura, defina a assinatura como 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 marca de blob específica, use o comando Get-AzStorageBlobByTag.

   $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 você instalou a CLI do Azure localmente, abra um aplicativo de console de comando, como 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 de logon.

   az login
   

4. Se sua identidade estiver associada a mais de uma assinatura, defina a assinatura ativa para a assinatura da conta de armazenamento.

   az account set --subscription <subscription-id>
   

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

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

   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 contêiner no parâmetro --tag-filter.

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

AzCopy

N/D

Próximas etapas

• Para saber mais sobre as marcas de índice de blob, confira Gerenciar e localizar os dados de Blob do Azure com marcas de índice de blob
• Para saber mais sobre o gerenciamento do ciclo de vida, confira 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?