Uso de etiquetas de índice de blobs para administrar y buscar datos en Azure Blob Storage

Las etiquetas de índice de blobs clasifican los datos de la cuenta de almacenamiento mediante atributos de etiqueta clave-valor. Estas etiquetas se indexan y se exponen automáticamente como un índice multidimensional que se puede buscar para encontrar fácilmente los datos. En este artículo se muestra cómo establecer, obtener y buscar datos mediante etiquetas de índice de blobs.

Para obtener más información sobre esta característica junto con las limitaciones y los problemas conocidos, vea Administración y búsqueda de datos de Azure Blob con etiquetas de índice de blobs.

Carga de un nuevo blob con etiquetas de índice

Esta tarea puede realizarla un propietario de datos de Storage Blob o una entidad de seguridad a la que se haya concedido permiso para la operación de proveedor de recursos de Azure Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write a través de un rol personalizado de Azure.

Portal

1. En Azure Portal, seleccione la cuenta de almacenamiento.

2. Vaya a la opción Contenedores de Almacenamiento de datos y seleccione el contenedor.

3. Seleccione el botón Cargar y examine el sistema de archivos local para buscar un archivo para cargarlo como un blob en bloques.

4. Expanda la lista desplegable Opciones avanzadas y vaya a la sección Blob Index Tags (Etiquetas de índice de blobs).

5. Escriba las etiquetas de índice de blobs de clave-valor que quiera aplicar a los datos.

6. Seleccione botón Upload para cargar el blob.

   

PowerShell

1. Inicie sesión en la suscripción a Azure con el comando Connect-AzAccount y siga las instrucciones de la pantalla.

   Connect-AzAccount
   

2. Si su identidad está asociada a más de una suscripción, establezca la suscripción activa. Después, obtenga el contexto de la cuenta de almacenamiento.

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

3. Cargue un blob con el comando Set-AzStorageBlobContent. Establezca etiquetas mediante el parámetro -Tag.

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

CLI de Azure

1. Abra Azure Cloud Shell o, si ha instalado la CLI de Azure localmente, abra una aplicación de consola de comandos como Windows PowerShell.

2. Instale la extensión storage-preview.

   az extension add -n storage-preview
   

3. Si usa la CLI de Azure localmente, ejecute el comando de inicio de sesión.

   az login
   

4. Si su identidad se asocia a más de una suscripción, establezca su suscripción activa en la suscripción de la cuenta de almacenamiento.

   az account set --subscription <subscription-id>
   

   Reemplace el valor de marcador de posición <subscription-id> por el identificador de la suscripción.

5. Cargue un blob con el comando az storage blob upload. Establezca etiquetas mediante el 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
   

AzCopy

Consulte Carga con etiquetas de índice.

Obtención, establecimiento y actualización de etiquetas de índice de blobs

La obtención de las etiquetas de índice de blob puede realizarla un propietario de datos de Storage Blob o una entidad de seguridad a la que se haya concedido permiso para la operación de proveedor de recursos de Azure Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read a través de un rol personalizado de Azure.

El establecimiento y actualización de las etiquetas de índice de blob puede realizarla un propietario de datos de Storage Blob o una entidad de seguridad a la que se haya concedido permiso para la operación de proveedor de recursos de Azure Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write a través de un rol personalizado de Azure.

Portal

1. En Azure Portal, seleccione la cuenta de almacenamiento.

2. Vaya a la opción Contenedores de Almacenamiento de datos y seleccione el contenedor.

3. Seleccione el blob en la lista de blobs dentro del contenedor seleccionado.

4. En la pestaña Información general del blob se mostrarán las propiedades del blob, incluida cualquier etiqueta de índice de blobs.

5. Puede obtener, establecer, modificar o eliminar cualquiera de las etiquetas de índice de clave-valor del blob.

6. Seleccione el botón Guardar para confirmar las actualizaciones del blob.

   

PowerShell

1. Inicie sesión en la suscripción a Azure con el comando Connect-AzAccount y siga las instrucciones de la pantalla.

   Connect-AzAccount
   

2. Si su identidad está asociada a más de una suscripción, establezca la suscripción activa. Después, obtenga el contexto de la cuenta de almacenamiento.

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

3. Para obtener las etiquetas de un blob, use el comando Get-AzStorageBlobTag y establezca el parámetro -Blob en el nombre del blob.

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

4. Para establecer las etiquetas de un blob, use el comando Set-AzStorageBlobTag. Establezca el parámetro -Blob en el nombre del blob y establezca el parámetro -Tag en una colección de pares de nombre y valor.

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

CLI de Azure

1. Abra Azure Cloud Shell o, si ha instalado la CLI de Azure localmente, abra una aplicación de consola de comandos como Windows PowerShell.

2. Instale la extensión storage-preview.

   az extension add -n storage-preview
   

3. Si usa la CLI de Azure localmente, ejecute el comando de inicio de sesión.

   az login
   

4. Si su identidad se asocia a más de una suscripción, establezca su suscripción activa en la suscripción de la cuenta de almacenamiento.

   az account set --subscription <subscription-id>
   

   Reemplace el valor de marcador de posición <subscription-id> por el identificador de la suscripción.

5. Para obtener las etiquetas de un blob, use el comando az storage blob tag list y establezca el parámetro --name en el nombre del blob.

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

6. Para establecer las etiquetas de un blob, use el comando az storage blob tag set. Establezca el parámetro --name en el nombre del blob y establezca el parámetro --tags en una colección de pares de nombre y valor.

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

AzCopy

Consulte Reemplazo de etiquetas de índice.

Filtrado y búsqueda de datos con etiquetas de índice de blobs

Esta tarea puede realizarla un propietario de datos de Storage Blob o una entidad de seguridad a la que se haya concedido permiso para la operación de proveedor de recursos de Azure Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action a través de un rol personalizado de Azure.

Nota:

No se pueden utilizar etiquetas de índice para recuperar versiones anteriores. Las etiquetas de las versiones anteriores no se pasan al motor de índices de blobs. Para más información, consulte Condiciones y problemas conocidos.

Portal

En Azure Portal, el filtro de las etiquetas de índice de blobs aplica automáticamente el parámetro @container para limitar el ámbito del contenedor seleccionado. Si quiere filtrar y buscar datos etiquetados en toda la cuenta de almacenamiento, use la API REST, los SDK o las herramientas.

1. En Azure Portal, seleccione la cuenta de almacenamiento.

2. Vaya a la opción Contenedores de Almacenamiento de datos y seleccione el contenedor.

3. Seleccione el botón Blob Index tags filter (Filtro de etiquetas de índice de blobs) para filtrar en el contenedor seleccionado.

4. Escriba un valor y una clave de etiqueta de índice de blobs.

5. Seleccione el botón Blob Index tags filter (Filtro de etiquetas de índice de blobs) para agregar filtros de etiquetas adicionales (hasta diez).

   

PowerShell

1. Inicie sesión en la suscripción a Azure con el comando Connect-AzAccount y siga las instrucciones de la pantalla.

   Connect-AzAccount
   

2. Si su identidad está asociada a más de una suscripción, establezca la suscripción activa. Después, obtenga el contexto de la cuenta de almacenamiento.

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

3. Para buscar todos los blobs que coincidan con una etiqueta de blob específica, use el comando Get-AzStorageBlobByTag.

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

4. Para buscar blobs solo en un contenedor específico, incluya el nombre del contenedor en -TagFilterSqlExpression.

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

CLI de Azure

1. Abra Azure Cloud Shell o, si ha instalado la CLI de Azure localmente, abra una aplicación de consola de comandos como Windows PowerShell.

2. Instale la extensión storage-preview.

   az extension add -n storage-preview
   

3. Si usa la CLI de Azure localmente, ejecute el comando de inicio de sesión.

   az login
   

4. Si su identidad se asocia a más de una suscripción, establezca su suscripción activa en la suscripción de la cuenta de almacenamiento.

   az account set --subscription <subscription-id>
   

   Reemplace el valor de marcador de posición <subscription-id> por el identificador de la suscripción.

5. Para buscar todos los blobs que coincidan con una etiqueta de blob específica, use el comando az storage blob filter.

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

6. Para buscar blobs solo en un contenedor específico, incluya el nombre del contenedor en el parámetro --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

Pasos siguientes

• Para obtener más información sobre las etiquetas de índice de blobs, vea Administración y búsqueda de datos de Azure Blob con etiquetas de índice de blobs.
• Para obtener más información sobre la administración del ciclo de vida, vea Administración del ciclo de vida de Azure Blob Storage
• Obtenga más información sobre cómo establecer etiquetas de índice en objetos a escala en varias cuentas de almacenamiento. Consulte ¿Qué es Acciones de almacenamiento de Azure?