Utiliser des balises d’index de blob pour gérer et rechercher des données sur Stockage Blob Azure

Les balises d’index de blob catégorisent les données de votre compte de stockage à l’aide d’attributs de balise clé-valeur. Ces balises sont automatiquement indexées et exposées en tant qu’index multidimensionnel pouvant faire l’objet d’une recherche pour trouver facilement des données. Cet article explique comment définir, obtenir et trouver des données à l’aide de balises d’index d’objets blob.

Pour en savoir plus sur cette fonctionnalité ainsi que sur les problèmes et limitations connus, consultez Gérer et rechercher des données blob Azure avec des balises d’index de blob.

Charger un nouvel objet blob avec des balises d’index

Cette tâche peut être effectuée par un Propriétaire des données Blob du stockage ou un principal de sécurité disposant de l’autorisation appropriée pour l’opération du fournisseur de ressources AzureMicrosoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write via un rôle Azure personnalisé.

Portail

1. Dans le Portail Azure, sélectionnez votre compte de stockage.

2. Sous Stockage de données, accédez à l’option Conteneurs, puis sélectionnez votre conteneur.

3. Sélectionnez le bouton Charger et naviguez dans votre système de fichiers local pour rechercher un fichier à charger en tant qu’objet blob de blocs.

4. Développez la liste déroulante Avancé, puis accédez à la section Balises d’index d’objets blob.

5. Entrez les balises d’index d’objets blob clé/valeur que vous souhaitez appliquer à vos données.

6. Sélectionnez le bouton Charger pour charger l’objet blob.

   

PowerShell

1. Connectez-vous à votre abonnement Azure avec la commande Connect-AzAccount et suivez les instructions à l’écran.

   Connect-AzAccount
   

2. Si votre identité est associée à plusieurs abonnements, définissez votre abonnement actif. Ensuite, obtenez le contexte du compte de stockage.

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

3. Chargez un blob à l'aide de la commande Set-AzStorageBlobContent. Définissez des étiquettes à l’aide du paramètre -Tag.

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

Azure CLI

1. Ouvrez Azure Cloud Shell ou, si vous avez installé Azure CLI localement, ouvrez une application console de commandes telle que Windows PowerShell.

2. Installer l’extension storage-preview.

   az extension add -n storage-preview
   

3. Si vous utilisez Azure CLI localement, exécutez la commande login.

   az login
   

4. Si votre identité est associée à plusieurs abonnements, définissez l’abonnement actif comme abonnement du compte de stockage.

   az account set --subscription <subscription-id>
   

   Remplacez la valeur d’espace réservé <subscription-id> par l’ID de votre abonnement.

5. Chargez un blob à l'aide de la commande az storage blob upload. Définissez des étiquettes à l’aide du paramètre --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

Voir Charger avec des balises d’index.

Obtenir, définir et mettre à jour des balises d’index d’objets blob

L’obtention des balises d’index d’objets blob peut être effectuée par un Propriétaire des données Blob du stockage ou un principal de sécurité disposant de l’autorisation appropriée pour l’opération du fournisseur de ressources AzureMicrosoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read via un rôle Azure personnalisé.

La définition et la mise à jour des balises d’index d’objets blob peuvent être effectuées par un Propriétaire des données Blob du stockage ou un principal de sécurité disposant de l’autorisation appropriée pour l’opération du fournisseur de ressources AzureMicrosoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write via un rôle Azure personnalisé.

Portail

1. Dans le Portail Azure, sélectionnez votre compte de stockage.

2. Sous Stockage de données, accédez à l’option Conteneurs, sélectionnez votre conteneur.

3. Sélectionnez votre blob dans la liste des blobs du conteneur sélectionné.

4. L’onglet Vue d’ensemble de l’objet blob affiche les propriétés de votre objet blob, dont les balises d’index d’objets blob.

5. Vous pouvez obtenir, définir, modifier ou supprimer n’importe quelle balise d’index clé/valeur pour votre objet blob.

6. Sélectionnez le bouton Enregistrer pour confirmer les mises à jour de votre objet blob.

   

PowerShell

1. Connectez-vous à votre abonnement Azure avec la commande Connect-AzAccount et suivez les instructions à l’écran.

   Connect-AzAccount
   

2. Si votre identité est associée à plusieurs abonnements, définissez votre abonnement actif. Ensuite, obtenez le contexte du compte de stockage.

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

3. Pour obtenir les étiquettes d’un blob, utilisez la commande Get-AzStorageBlobTag et définissez le paramètre -Blob sur le nom du blob.

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

4. Pour définir les étiquettes d’un blob, utilisez la commande Set-AzStorageBlobTag. Définissez le paramètre -Blob sur le nom du blob, et le paramètre -Tag sur une collection de paires nom/valeur.

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

Azure CLI

1. Ouvrez Azure Cloud Shell ou, si vous avez installé Azure CLI localement, ouvrez une application console de commandes telle que Windows PowerShell.

2. Installer l’extension storage-preview.

   az extension add -n storage-preview
   

3. Si vous utilisez Azure CLI localement, exécutez la commande login.

   az login
   

4. Si votre identité est associée à plusieurs abonnements, définissez l’abonnement actif comme abonnement du compte de stockage.

   az account set --subscription <subscription-id>
   

   Remplacez la valeur d’espace réservé <subscription-id> par l’ID de votre abonnement.

5. Pour obtenir les étiquettes d’un blob, utilisez la commande az storage blob tag list et définissez le paramètre --name sur le nom du blob.

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

6. Pour définir les étiquettes d’un blob, utilisez la commande az storage blob tag set. Définissez le paramètre --name sur le nom du blob, et le paramètre --tags sur une collection de paires nom/valeur.

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

AZCopy

Voir Remplacer des balises d’index

Filtrer et rechercher des données avec des balises d’index de blobs

Cette tâche peut être effectuée par un Propriétaire des données Blob du stockage ou un principal de sécurité disposant de l’autorisation appropriée pour l’opération du fournisseur de ressources AzureMicrosoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action via un rôle Azure personnalisé.

Notes

Vous ne pouvez pas utiliser de balises d’index pour récupérer des versions précédentes. Les balises pour les versions précédentes ne sont pas passées au moteur d’index de blob. Pour plus d’informations, consultez Conditions et problèmes connus.

Portail

Dans le portail Azure, le filtre des balises d’index de blobs applique automatiquement le paramètre @container pour définir l’étendue de votre conteneur sélectionné. Si vous souhaitez filtrer et rechercher des données balisées dans votre compte de stockage, utilisez nos API REST, nos Kits de développement logiciel (SDK) ou nos outils.

1. Dans le Portail Azure, sélectionnez votre compte de stockage.

2. Sous Stockage de données, accédez à l’option Conteneurs, sélectionnez votre conteneur.

3. Sélectionnez le bouton Filtre des balises d’index d’objets blob pour filtrer à l’intérieur du conteneur sélectionné.

4. Entrez une clé de balise d’index de blobs et une valeur de balise.

5. Sélectionnez le bouton Filtre des balises d’index d’objets blob pour ajouter des filtres de balises (jusqu’à 10).

   

PowerShell

1. Connectez-vous à votre abonnement Azure avec la commande Connect-AzAccount et suivez les instructions à l’écran.

   Connect-AzAccount
   

2. Si votre identité est associée à plusieurs abonnements, définissez votre abonnement actif. Ensuite, obtenez le contexte du compte de stockage.

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

3. Pour rechercher tous les blobs correspondant à une étiquette de blob spécifique, utilisez la commande Get-AzStorageBlobByTag.

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

4. Pour rechercher des blobs uniquement dans un conteneur spécifique, incluez le nom du conteneur dans -TagFilterSqlExpression.

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

Azure CLI

1. Ouvrez Azure Cloud Shell ou, si vous avez installé Azure CLI localement, ouvrez une application console de commandes telle que Windows PowerShell.

2. Installer l’extension storage-preview.

   az extension add -n storage-preview
   

3. Si vous utilisez Azure CLI localement, exécutez la commande login.

   az login
   

4. Si votre identité est associée à plusieurs abonnements, définissez l’abonnement actif comme abonnement du compte de stockage.

   az account set --subscription <subscription-id>
   

   Remplacez la valeur d’espace réservé <subscription-id> par l’ID de votre abonnement.

5. Pour rechercher tous les blobs correspondant à une étiquette de blob spécifique, utilisez la commande az storage blob filter.

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

6. Pour rechercher des blobs uniquement dans un conteneur spécifique, incluez le nom du conteneur dans le paramètre --tag-filter.

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

AZCopy

N/A

Étapes suivantes

• Pour en savoir plus sur les balises d’index de blob, consultez Gérer et rechercher des données blob Azure avec des balises d’index de blob.
• Pour en savoir plus sur la gestion de cycle de vie, consultez Gérer le cycle de vie de Stockage Blob Azure.
• Découvrez plus en détail comment définir des balises d’index sur des objets à grande échelle dans plusieurs comptes de stockage. Consultez Qu’est-ce qu’Azure Storage Actions ?