Använda blobindextaggar för att hantera och hitta data i Azure Blob Storage

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.

Ladda upp en ny blob med indextaggar

Den här uppgiften kan utföras av en lagringsblobdataägare eller ett säkerhetsobjekt som har fått behörighet till Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write Azure-resursproviderns åtgärd via en anpassad Azure-roll.

Portal

1. I Azure-portalen väljer du ditt lagringskonto.

2. Gå till alternativet Containrar under Datalagring och välj din container.

3. 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.

4. Expandera listrutan Avancerat och gå till avsnittet blobindextaggar .

5. Ange de taggar för nyckel/värde-blobindex som du vill använda för dina data.

6. Välj knappen Ladda upp för att ladda upp bloben.

   

PowerShell

1. Logga in på din Azure-prenumeration med kommandot Connect-AzAccount och följ anvisningarna på skärmen.

   Connect-AzAccount
   

2. 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   
   

3. 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" }
   

Azure CLI

1. Öppna Azure Cloud Shell, eller om du har installerat Azure CLI lokalt öppnar du ett kommandokonsolprogram som Windows PowerShell.

2. Installera tillägget storage-preview.

   az extension add -n storage-preview
   

3. Om du använder Azure CLI lokalt kör du inloggningskommandot.

   az login
   

4. Om din identitet är associerad med mer än en prenumeration ställer du in din aktiva prenumeration på prenumerationen på lagringskontot.

   az account set --subscription <subscription-id>
   

   <subscription-id> Ersätt platshållarvärdet med ID:t för din prenumeration.

5. 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
   

AzCopy

Se Ladda upp med indextaggar.

Hämta, ange och uppdatera blobindextaggar

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.

Inställning och uppdatering av 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/write via en anpassad Azure-roll.

Portal

1. I Azure-portalen väljer du ditt lagringskonto.

2. Gå till alternativet Containrar under Datalagring och välj din container.

3. Välj din blob i listan över blobar i den valda containern.

4. Fliken Bloböversikt visar blobens egenskaper, inklusive eventuella blobindextaggar.

5. Du kan hämta, ange, ändra eller ta bort någon av nyckel/värde-indextaggar för din blob.

6. Välj knappen Spara för att bekräfta eventuella uppdateringar av bloben.

   

PowerShell

1. Logga in på din Azure-prenumeration med kommandot Connect-AzAccount och följ anvisningarna på skärmen.

   Connect-AzAccount
   

2. 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   
   

3. 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
   

4. 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
   

Azure CLI

1. Öppna Azure Cloud Shell, eller om du har installerat Azure CLI lokalt öppnar du ett kommandokonsolprogram som Windows PowerShell.

2. Installera tillägget storage-preview.

   az extension add -n storage-preview
   

3. Om du använder Azure CLI lokalt kör du inloggningskommandot.

   az login
   

4. Om din identitet är associerad med mer än en prenumeration ställer du in din aktiva prenumeration på prenumerationen på lagringskontot.

   az account set --subscription <subscription-id>
   

   <subscription-id> Ersätt platshållarvärdet med ID:t för din prenumeration.

5. 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
   

6. 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
   

AzCopy

Se Ersätt indextaggar

Filtrera och hitta data med blobindextaggar

Den här uppgiften kan utföras av en lagringsblobdataägare eller ett säkerhetsobjekt som har fått behörighet till Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action Azure-resursproviderns åtgärd 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.

Portal

I Azure-portalen tillämpar filtret för blobindextaggar automatiskt parametern @container för att omfånget för 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.

1. I Azure-portalen väljer du ditt lagringskonto.

2. Gå till alternativet Containrar under Datalagring och välj din container.

3. Välj filterknappen blobindextaggar för att filtrera i den valda containern.

4. Ange en blobindextaggnyckel och taggvärde.

5. Välj filterknappen blobindextaggar för att lägga till ytterligare taggfilter (upp till 10).

   

PowerShell

1. Logga in på din Azure-prenumeration med kommandot Connect-AzAccount och följ anvisningarna på skärmen.

   Connect-AzAccount
   

2. 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   
   

3. 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
   

4. 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
   

Azure CLI

1. Öppna Azure Cloud Shell, eller om du har installerat Azure CLI lokalt öppnar du ett kommandokonsolprogram som Windows PowerShell.

2. Installera tillägget storage-preview.

   az extension add -n storage-preview
   

3. Om du använder Azure CLI lokalt kör du inloggningskommandot.

   az login
   

4. Om din identitet är associerad med mer än en prenumeration ställer du in din aktiva prenumeration på prenumerationen på lagringskontot.

   az account set --subscription <subscription-id>
   

   <subscription-id> Ersätt platshållarvärdet med ID:t för din prenumeration.

5. 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
   

6. 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
   

AzCopy

Ej tillämpligt

Nästa steg

• Läs mer om blobindextaggar i Hantera och hitta Azure Blob-data med blobindextaggar
• Läs mer om livscykelhantering i Hantera livscykeln för Azure Blob Storage
• Läs mer om hur du anger indextaggar för objekt i stor skala över flera lagringskonton. Se Vad är Azure Storage Actions?