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, incluindo problemas conhecidos e limitações, consulte Gerenciar e localizar dados de blob do Azure com tags de índice de blob.
Essa tarefa pode ser executada por um Proprietário de Dados de Blob de Armazenamento ou por um principal de segurança que tenha recebido permissão para a Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeoperação do provedor de recursos do Azure por meio de uma função personalizada do Azure.
No portal do Azure, selecione a conta de armazenamento.
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.
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
Carregue um blob usando o comando Set-AzStorageBlobContent. Defina as tags 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" }
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 do marcador <subscription-id> pelo ID da sua assinatura.
Carregue um blob usando o comando az storage blob upload. Defina as tags 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
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 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/readoperação do provedor de recursos do Azure 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 Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeoperação do provedor de recursos do Azure por meio de uma função personalizada do Azure.
No portal do Azure, selecione a conta de armazenamento.
Procure a opção Contêineres em Armazenamento de dados e selecione seu contêiner.
Selecione seu blob na lista de blobs dentro do 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 qualquer uma das tags de índice de chave/valor do seu 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.
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
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
Para definir os rótulos 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
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 do marcador <subscription-id> pelo 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 os rótulos 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
Essa tarefa pode ser executada por um Proprietário de Dados de Blob de Armazenamento ou por um principal de segurança que tenha recebido permissão para a Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/actionoperação do provedor de recursos do Azure 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 tags de versões anteriores não são passadas para o mecanismo de indexação de blobs. 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.
No portal do Azure, selecione a conta de armazenamento.
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 tags do Índice de Blobs para adicionar filtros de tag adicionais (até 10).
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.
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
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
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 do marcador <subscription-id> pelo 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
Próximas etapas