Use as marcas de índice de blob para gerenciar e localizar dados no Armazenamento de Blobs do Azure
Artigo
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.
Procure a opção Contêineres em Armazenamento de dados e selecione seu contêiner.
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.
Expanda o menu suspenso Avançado e acesse a seção Marcas de Índice de Blob.
Insira as marcas de índice de blob de chave/valor que deseja aplicar aos dados.
Selecione o botão Carregar para carregar o blob.
Entre na sua assinatura do Azure com o comando Connect-AzAccount e siga as instruções na tela.
Connect-AzAccount
Se sua identidade estiver associada a mais de uma assinatura, defina a assinatura como ativa. Em seguida, obtenha o contexto da conta de armazenamento.
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 AzureMicrosoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write por meio de uma função personalizada do Azure.
Procure a opção Contêineres em Armazenamento de dados e selecione seu contêiner.
Escolha seu blob na lista de blobs no contêiner selecionado.
A guia de visão geral do blob exibirá as propriedades do blob, incluindo as Marcas de Índice de Blob.
Você pode obter, definir, modificar ou excluir uma das marcas de índice de chave/valor do blob.
Selecione o botão Salvar para confirmar as atualizações no blob.
Entre na sua assinatura do Azure com o comando Connect-AzAccount e siga as instruções na tela.
Connect-AzAccount
Se sua identidade estiver associada a mais de uma assinatura, defina a assinatura como ativa. Em seguida, obtenha o contexto da conta de armazenamento.
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.
Abra o Azure Cloud Shell ou, se você instalou a CLI do Azure localmente, abra um aplicativo de console de comando, como Windows PowerShell.
Instale a extensão storage-preview.
az extension add -n storage-preview
Se você estiver usando a CLI do Azure localmente, execute o comando de logon.
az login
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.
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
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
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.
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.
Procure a opção Contêineres em Armazenamento de dados e selecione seu contêiner.
Selecione o botão Filtro de marcas de índice de blob para aplicar o filtro dentro do contêiner selecionado.
Insira o valor da marca e a chave da marca de índice de blob.
Selecione o botão Filtro de marcas de índice de blob para adicionar filtros de marca adicionais (até dez).
Entre na sua assinatura do Azure com o comando Connect-AzAccount e siga as instruções na tela.
Connect-AzAccount
Se sua identidade estiver associada a mais de uma assinatura, defina a assinatura como ativa. Em seguida, obtenha o contexto da conta de armazenamento.
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
Abra o Azure Cloud Shell ou, se você instalou a CLI do Azure localmente, abra um aplicativo de console de comando, como Windows PowerShell.
Instale a extensão storage-preview.
az extension add -n storage-preview
Se você estiver usando a CLI do Azure localmente, execute o comando de logon.
az login
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.
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
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