Blobindextaggar kategoriserar data i ditt lagringskonto med hjälp av taggattribut för nyckelvärde. Dessa taggar indexeras automatiskt och exponeras som ett sökbart flerdimensionellt index för att enkelt hitta data. Den här artikeln visar hur du anger, hämtar och hittar data med hjälp av blobindextaggar.
Mer information om den här funktionen tillsammans med kända problem och begränsningar finns i Hantera och hitta Azure Blob-data med blobindextaggar.
Den här uppgiften kan utföras av en ägare till lagringsblobbdata eller en säkerhetsprincip som har fått behörighet till Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeAzure-resursleverantörens åtgärd via en anpassad Azure-roll.
I Azure Portal väljer du ditt lagringskonto.
Gå till alternativet Containrar under Datalagring och välj din container.
Välj knappen Ladda upp och bläddra i ditt lokala filsystem för att hitta en fil som ska laddas upp som en blockblob.
Expandera listrutan Avancerat och gå till avsnittet blobindextaggar .
Ange de taggar för nyckel/värde-blobindex som du vill använda för dina data.
Välj knappen Ladda upp för att ladda upp bloben.
Logga in på din Azure-prenumeration med kommandot Connect-AzAccount och följ anvisningarna på skärmen.
Connect-AzAccount
Om din identitet är associerad med mer än en prenumeration anger du din aktiva prenumeration. Hämta sedan kontexten för lagringskontot.
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
Ladda upp en blob med hjälp Set-AzStorageBlobContent av kommandot . Ange taggar med hjälp av parametern -Tag .
$containerName = "myContainer"
$file = "C:\demo-file.txt"
Set-AzStorageBlobContent -File $file -Container $containerName -Context $ctx -Tag @{"tag1" = "value1"; "tag2" = "value2" }
Öppna Azure Cloud Shell, eller om du har installerat Azure CLI lokalt öppnar du ett kommandokonsolprogram som Windows PowerShell.
Installera tillägget storage-preview.
az extension add -n storage-preview
Om du använder Azure CLI lokalt kör du inloggningskommandot.
az login
Om din identitet är associerad med mer än en prenumeration, ställ in den prenumeration för lagringskontot som din aktiva prenumeration.
az account set --subscription <subscription-id>
<subscription-id> Ersätt platshållarvärdet med ID:t för din prenumeration.
Ladda upp en blob med hjälp az storage blob upload av kommandot . Ange taggar med hjälp av parametern --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
Hämtar blobindextaggar kan utföras av en lagringsblobdataägare eller ett säkerhetsobjekt som har fått behörighet till Azure-resursprovideråtgärden Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read via en anpassad Azure-roll.
Att ställa in och uppdatera blobindextaggar kan utföras av en Storage Blob Data Owner eller ett säkerhetsobjekt som har fått behörighet till Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeAzure-resursleverantörsåtgärden genom en anpassad Azure-roll.
I Azure Portal väljer du ditt lagringskonto.
Gå till alternativet Containrar under Datalagring och välj din container.
Välj din blob i listan över blobar i den valda containern.
Fliken Bloböversikt visar blobens egenskaper, inklusive eventuella blobindextaggar.
Du kan hämta, ange, ändra eller ta bort någon av nyckel/värde-indextaggar för din blob.
Välj knappen Spara för att bekräfta eventuella uppdateringar av bloben.
Logga in på din Azure-prenumeration med kommandot Connect-AzAccount och följ anvisningarna på skärmen.
Connect-AzAccount
Om din identitet är associerad med mer än en prenumeration anger du din aktiva prenumeration. Hämta sedan kontexten för lagringskontot.
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
Om du vill hämta taggarna för en blob använder du Get-AzStorageBlobTag kommandot och anger parametern -Blob till namnet på bloben.
$containerName = "myContainer"
$blobName = "myBlob"
Get-AzStorageBlobTag -Context $ctx -Container $containerName -Blob $blobName
Om du vill ange taggarna för en blob använder du Set-AzStorageBlobTag kommandot . Ange parametern -Blob till blobens namn och ange parametern -Tag till en samling namn- och värdepar.
$containerName = "myContainer"
$blobName = "myBlob"
$tags = @{"tag1" = "value1"; "tag2" = "value2" }
Set-AzStorageBlobTag -Context $ctx -Container $containerName -Blob $blobName -Tag $tags
Öppna Azure Cloud Shell, eller om du har installerat Azure CLI lokalt öppnar du ett kommandokonsolprogram som Windows PowerShell.
Installera tillägget storage-preview.
az extension add -n storage-preview
Om du använder Azure CLI lokalt kör du inloggningskommandot.
az login
Om din identitet är kopplad till fler än en prenumeration, ställ in din aktiva prenumeration på den som hör till lagringskontot.
az account set --subscription <subscription-id>
<subscription-id> Ersätt platshållarvärdet med ID:t för din prenumeration.
Om du vill hämta taggarna för en blob använder du az storage blob tag list kommandot och anger parametern --name till namnet på bloben.
az storage blob tag list --account-name mystorageaccount --container-name myContainer --name demo-file.txt --auth-mode login
Om du vill ange taggarna för en blob använder du az storage blob tag set kommandot . Ange parametern --name till blobens namn och ange parametern --tags till en samling namn- och värdepar.
az storage blob tag set --account-name mystorageaccount --container-name myContainer --name demo-file.txt --tags tag1=value1 tag2=value2 --auth-mode login
Den här uppgiften kan utföras av en lagringsblobdataägare eller en säkerhetsprincip som har getts behörighet att utföra Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/actionAzure-resursproviderns operation via en anpassad Azure-roll.
Kommentar
Du kan inte använda indextaggar för att hämta tidigare versioner. Taggar för tidigare versioner skickas inte till blobindexmotorn. Mer information finns i Villkor och kända problem.
I Azure-portalen tillämpar filtret för blobindextaggar automatiskt parametern @container för att avgränsa den valda containern. Om du vill filtrera och hitta taggade data i hela lagringskontot använder du vårt REST API, SDK:er eller verktyg.
I Azure Portal väljer du ditt lagringskonto.
Gå till alternativet Containrar under Datalagring och välj din container.
Välj knappen "Blob Index-tagsfiltret" för att filtrera inom den valda containern.
Ange en blobindextaggnyckel och taggvärde.
Välj knappen Blob Index taggar-filter för att lägga till ytterligare taggfilter (upp till 10).
Logga in på din Azure-prenumeration med kommandot Connect-AzAccount och följ anvisningarna på skärmen.
Connect-AzAccount
Om din identitet är associerad med mer än en prenumeration anger du din aktiva prenumeration. Hämta sedan kontexten för lagringskontot.
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
Om du vill hitta alla blobar som matchar en specifik blobtagg använder du Get-AzStorageBlobByTag kommandot .
$filterExpression = """tag1""='value1'"
Get-AzStorageBlobByTag -TagFilterSqlExpression $filterExpression -Context $ctx
Om du bara vill hitta blobar i en specifik container tar du med containernamnet i -TagFilterSqlExpression.
$filterExpression = "@container='myContainer' AND ""tag1""='value1'"
Get-AzStorageBlobByTag -TagFilterSqlExpression $filterExpression -Context $ctx
Öppna Azure Cloud Shell, eller om du har installerat Azure CLI lokalt öppnar du ett kommandokonsolprogram som Windows PowerShell.
Installera tillägget storage-preview.
az extension add -n storage-preview
Om du använder Azure CLI lokalt kör du inloggningskommandot.
az login
Om din identitet är kopplad till mer än en prenumeration, ställ in din aktiva prenumeration till den som hör till lagringskontot.
az account set --subscription <subscription-id>
<subscription-id> Ersätt platshållarvärdet med ID:t för din prenumeration.
Om du vill hitta alla blobar som matchar en specifik blobtagg använder du az storage blob filter kommandot .
az storage blob filter --account-name mystorageaccount --tag-filter """tag1""='value1' and ""tag2""='value2'" --auth-mode login
Om du bara vill hitta blobar i en specifik container tar du med containernamnet i parametern --tag-filter .
az storage blob filter --account-name mystorageaccount --tag-filter """@container""='myContainer' and ""tag1""='value1' and ""tag2""='value2'" --auth-mode login
Nästa steg