Usare i tag indice BLOB per gestire e trovare dati nell’archiviazione BLOB di Azure

I tag indice BLOB categorizzano i dati nell'account di archiviazione usando gli attributi di tag chiave-valore. Questi tag vengono indicizzati e esposti automaticamente come indice multidimensionale ricercabile per facilitare la ricerca di dati. Questo articolo illustra come impostare, ottenere e trovare i dati usando i tag indice BLOB.

Per ulteriori informazioni su questa funzionalità e su problemi e limitazioni noti, consultare Gestire e trovare i dati BLOB di Azure con tag indice BLOB.

Caricare un nuovo BLOB con tag indice

Questa attività può essere eseguita da un proprietario dei dati dei BLOB di archiviazione o da un’entità di sicurezza a cui è stata concessa l’autorizzazione per Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeoperare il provider di risorse di Azure tramite un ruolo personalizzato di Azure.

Portale

1. Selezionare l'account di archiviazione nel portale di Azure.

2. Passare all'opzione Contenitori in Archiviazione dati e selezionare il contenitore.

3. Selezionare il pulsante Carica ed esplorare il file system locale per trovare un file da caricare come BLOB in blocchi.

4. Espandere il menu a discesa Avanzate e passare alla sezione Tag indice BLOB.

5. Immettere i tag indice BLOB con i dati chiave/valore che si vogliono applicare ai dati.

6. Selezionare il pulsante Carica per caricare il BLOB.

   

PowerShell

1. Accedere alla sottoscrizione di Azure con il comando Connect-AzAccount e seguire le istruzioni visualizzate.

   Connect-AzAccount
   

2. Se l'identità è associata a più di una sottoscrizione, impostare la sottoscrizione attiva. Quindi, ottenere il contesto dell'account di archiviazione.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context   
   

3. Caricare un BLOB usando il comando Set-AzStorageBlobContent. Impostare i tag usando il parametro -Tag.

   $containerName = "myContainer"
   $file = "C:\demo-file.txt"
   
   Set-AzStorageBlobContent -File $file -Container $containerName -Context $ctx -Tag @{"tag1" = "value1"; "tag2" = "value2" }
   

Interfaccia della riga di comando di Azure

1. Aprire Azure Cloud Shello aprire un'applicazione console comando come Windows PowerShell, se è stata installata l'interfaccia della riga di comando di Azure in locale.

2. Installare l'estensione storage-preview.

   az extension add -n storage-preview
   

3. Se si usa l'interfaccia della riga di comando di Azure in locale, eseguire il comando di accesso.

   az login
   

4. Se l'identità è associata a più sottoscrizioni, impostare la sottoscrizione attiva come sottoscrizione dell'account di archiviazione.

   az account set --subscription <subscription-id>
   

   Sostituire il valore segnaposto <subscription-id> con l'ID della sottoscrizione.

5. Caricare un BLOB usando il comando az storage blob upload. Impostare i tag usando il parametro --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

Consultare Caricare con tag indice.

Ottenere, impostare e aggiornare i tag indice BLOB

Il recupero dei tag indice BLOB può essere eseguito da un proprietario dei dati dei BLOB di archiviazione o da un’entità di sicurezza a cui è stata concessa l’autorizzazione per Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/readoperare il provider di risorse di Azure tramite un ruolo personalizzato di Azure.

L’impostazione e l’aggiornamento dei tag indice BLOB può essere eseguito da un proprietario dei dati dei BLOB di archiviazione o da un’entità di sicurezza a cui è stata concessa l’autorizzazione per Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeoperare il provider di risorse di Azure tramite un ruolo personalizzato di Azure.

Portale

1. Selezionare l'account di archiviazione nel portale di Azure.

2. Passare all’opzione Contenitori in Archiviazione dati e selezionare il contenitore.

3. Selezionare il BLOB dall'elenco di BLOB all'interno del contenitore selezionato.

4. La scheda panoramica del BLOB mostrerà le proprietà del BLOB, inclusi eventuali tag indice BLOB.

5. È possibile ottenere, impostare, modificare o eliminare qualsiasi tag indice con chiave/valore per il BLOB.

6. Selezionare il pulsante Salva per confermare eventuali aggiornamenti apportati al BLOB.

   

PowerShell

1. Accedere alla sottoscrizione di Azure con il comando Connect-AzAccount e seguire le istruzioni visualizzate.

   Connect-AzAccount
   

2. Se l'identità è associata a più di una sottoscrizione, impostare la sottoscrizione attiva. Quindi, ottenere il contesto dell'account di archiviazione.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context   
   

3. Per ottenere i tag di un BLOB, usare il comando Get-AzStorageBlobTag e impostare il parametro -Blob sul nome del BLOB.

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

4. Per impostare i tag di un BLOB, usare il comando Set-AzStorageBlobTag. Impostare il parametro -Blob sul nome del BLOB e il parametro -Tag su una raccolta di coppie di nomi e valori.

   $containerName = "myContainer"
   $blobName = "myBlob" 
   $tags = @{"tag1" = "value1"; "tag2" = "value2" }
   Set-AzStorageBlobTag -Context $ctx -Container $containerName -Blob $blobName -Tag $tags
   

Interfaccia della riga di comando di Azure

1. Aprire Azure Cloud Shello aprire un'applicazione console comando come Windows PowerShell, se è stata installata l'interfaccia della riga di comando di Azure in locale.

2. Installare l'estensione storage-preview.

   az extension add -n storage-preview
   

3. Se si usa l'interfaccia della riga di comando di Azure in locale, eseguire il comando di accesso.

   az login
   

4. Se l'identità è associata a più sottoscrizioni, impostare la sottoscrizione attiva come sottoscrizione dell'account di archiviazione.

   az account set --subscription <subscription-id>
   

   Sostituire il valore segnaposto <subscription-id> con l'ID della sottoscrizione.

5. Per ottenere i tag di un BLOB, usare il comando az storage blob tag list e impostare il parametro --name sul nome del BLOB.

   az storage blob tag list --account-name mystorageaccount --container-name myContainer --name demo-file.txt --auth-mode login
   

6. Per impostare i tag di un BLOB, usare il comando az storage blob tag set. Impostare il parametro --name sul nome del BLOB e il parametro --tags su una raccolta di coppie di nomi e valori.

   az storage blob tag set --account-name mystorageaccount --container-name myContainer --name demo-file.txt --tags tag1=value1 tag2=value2 --auth-mode login
   

AzCopy

Consultare Sostituire i tag indice

Filtrare e trovare dati con tag indice BLOB

Questa attività può essere eseguita da un proprietario dei dati dei BLOB di archiviazione o da un’entità di sicurezza a cui è stata concessa l’autorizzazione per Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/actionoperare il provider di risorse di Azure tramite un ruolo personalizzato di Azure.

Nota

Non è possibile usare tag indice per recuperare versioni precedenti. I tag per versioni precedenti non vengono trasmessi al motore di indicizzazione BLOB. Per ulteriori informazioni, consultare Condizioni e problemi noti.

Portale

All'interno del portale di Azure, il filtro tag indice BLOB applica automaticamente il parametro @container per definire l'ambito del contenitore selezionato. Per filtrare e trovare i dati con tag nell'intero account di archiviazione, usare l'API REST, gli SDK o strumenti.

1. Selezionare l'account di archiviazione nel portale di Azure.

2. Passare all’opzione Contenitori in Archiviazione dati e selezionare il contenitore.

3. Selezionare il pulsante Filtro tag indice BLOB per applicare il filtro all'interno del contenitore selezionato.

4. Immettere un valore e una chiave del tag indice BLOB.

5. Selezionare il pulsante Filtro tag indice BLOB per aggiungere altri filtri tag (massimo 10).

   

PowerShell

1. Accedere alla sottoscrizione di Azure con il comando Connect-AzAccount e seguire le istruzioni visualizzate.

   Connect-AzAccount
   

2. Se l'identità è associata a più di una sottoscrizione, impostare la sottoscrizione attiva. Quindi, ottenere il contesto dell'account di archiviazione.

   $context = Get-AzSubscription -SubscriptionId <subscription-id>
   Set-AzContext $context
   $storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
   $ctx = $storageAccount.Context   
   

3. Per trovare tutti i BLOB che corrispondono a uno specifico tag BLOB, usare il comando Get-AzStorageBlobByTag.

   $filterExpression = """tag1""='value1'"
   Get-AzStorageBlobByTag -TagFilterSqlExpression $filterExpression -Context $ctx
   

4. Per trovare BLOB solo in uno specifico contenitore, includere il nome del contenitore in -TagFilterSqlExpression.

   $filterExpression = "@container='myContainer' AND ""tag1""='value1'"
   Get-AzStorageBlobByTag -TagFilterSqlExpression $filterExpression -Context $ctx
   

Interfaccia della riga di comando di Azure

1. Aprire Azure Cloud Shello aprire un'applicazione console comando come Windows PowerShell, se è stata installata l'interfaccia della riga di comando di Azure in locale.

2. Installare l'estensione storage-preview.

   az extension add -n storage-preview
   

3. Se si usa l'interfaccia della riga di comando di Azure in locale, eseguire il comando di accesso.

   az login
   

4. Se l'identità è associata a più sottoscrizioni, impostare la sottoscrizione attiva come sottoscrizione dell'account di archiviazione.

   az account set --subscription <subscription-id>
   

   Sostituire il valore segnaposto <subscription-id> con l'ID della sottoscrizione.

5. Per trovare tutti i BLOB che corrispondono a uno specifico tag BLOB, usare il comando az storage blob filter.

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

6. Per trovare BLOB solo in uno specifico contenitore, includere il nome del contenitore nel parametro --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

Passaggi successivi

• Per ulteriori informazioni sui tag indice BLOB, consultare Gestire e trovare dati BLOB di Azure con tag di indice BLOB
• Per ulteriori informazioni sulla gestione del ciclo di vita, vedere Gestire il ciclo di vita dell’archiviazione BLOB di Azure
• Altre informazioni su come impostare i tag di indice sugli oggetti su larga scala in più account di archiviazione. Vedere Cos'è Azioni di archiviazione di Azure?