Blobindex-címkék használata az Azure Blob Storage-adatok kezeléséhez és kereséséhez

A blobindexcímkék kulcs-érték címkeattribútumok használatával kategorizálják a tárfiók adatait. Ezek a címkék automatikusan indexelhetők, és kereshető többdimenziós indexként jelennek meg az adatok egyszerű keresése érdekében. Ez a cikk bemutatja, hogyan állíthat be, kérhet le és kereshet meg adatokat blobindexcímkék használatával.

Ha többet szeretne megtudni erről a funkcióról, valamint az ismert problémákról és korlátozásokról, olvassa el az Azure Blob-adatok kezelése és megkeresése blobindex-címkékkel című témakört.

Új blob feltöltése indexcímkékkel

Ezt a feladatot egy Storage Blob-adattulajdonos vagy egy biztonsági tag végezheti el, aki egy egyéni Azure-szerepkörön keresztül engedélyt kapott az Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeAzure-erőforrás-szolgáltatói műveletre.

Portál

1. Az Azure Portalon válassza ki a tárfiókot.

2. Lépjen a Tárolók lehetőségre az Adattárolás területen, és válassza ki a tárolót.

3. Válassza a Feltöltés gombot, és tallózással keresse meg a helyi fájlrendszerben a blokkblobként feltöltendő fájlt.

4. Bontsa ki a Speciális legördülő menüt, és lépjen a Blob indexcímkék szakaszra.

5. Adja meg az adatokra alkalmazni kívánt kulcs-/érték blobindexcímkéket.

6. A blob feltöltéséhez válassza a Feltöltés gombot.

   

PowerShell

1. Jelentkezzen be az Azure-előfizetésbe a Connect-AzAccount paranccsal, és kövesse a képernyőn megjelenő útmutatásokat.

   Connect-AzAccount
   

2. Ha identitása egynél több előfizetéshez van társítva, állítsa be az aktív előfizetést. Ezután kérje le a tárfiók környezetét.

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

3. Blob feltöltése a Set-AzStorageBlobContent parancs használatával. Címkék beállítása a -Tag paraméterrel.

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

Azure CLI

1. Nyissa meg az Azure Cloud Shellt, vagy ha helyileg telepítette az Azure CLI-t, nyisson meg egy parancskonzolalkalmazást, például a Windows PowerShellt.

2. A(z) storage-preview bővítmény telepítése.

   az extension add -n storage-preview
   

3. Ha helyileg használja az Azure CLI-t, futtassa a bejelentkezési parancsot.

   az login
   

4. Ha identitása egynél több előfizetéshez van társítva, állítsa be az aktív előfizetést a tárfiók előfizetésére.

   az account set --subscription <subscription-id>
   

   Cserélje le a <subscription-id> helyőrző értékét az előfizetés azonosítójára.

5. Blob feltöltése a az storage blob upload parancs használatával. Címkék beállítása a --tags paraméterrel.

   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

Lásd: Feltöltés indexcímkékkel.

Blobindex-címkék lekérése, beállítása és frissítése

A blobindex-címkék lekérését egy storage blobadat-tulajdonos vagy egy biztonsági tag végezheti el, aki egy egyéni Azure-szerepkörön keresztül engedélyt kapott az Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/readAzure-erőforrás-szolgáltatói műveletre.

A blobindex-címkék beállítását és frissítését a Storage Blob-adattulajdonos vagy egy biztonsági tag végezheti el, aki egyéni Azure-szerepkörön keresztül engedélyt kapott az Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeAzure-erőforrás-szolgáltatói műveletre .

Portál

1. Az Azure Portalon válassza ki a tárfiókot.

2. Lépjen a Tárolók lehetőségre az Adattárolás területen, és válassza ki a tárolót.

3. Válassza ki a blobot a kijelölt tárolón belüli blobok listájából.

4. A blob áttekintési lapja megjeleníti a blob tulajdonságait, beleértve a blobindex-címkéket is.

5. A blob kulcs-/értékindex-címkéinek bármelyikét lekérheti, beállíthatja, módosíthatja vagy törölheti.

6. Kattintson a Mentés gombra a blob frissítéseinek megerősítéséhez.

   

PowerShell

1. Jelentkezzen be az Azure-előfizetésbe a Connect-AzAccount paranccsal, és kövesse a képernyőn megjelenő útmutatásokat.

   Connect-AzAccount
   

2. Ha identitása egynél több előfizetéshez van társítva, állítsa be az aktív előfizetést. Ezután kérje le a tárfiók környezetét.

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

3. Egy blob címkéinek lekéréséhez használja a Get-AzStorageBlobTag parancsot, és állítsa a -Blob paramétert a blob nevére.

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

4. Egy blob címkéinek beállításához használja a Set-AzStorageBlobTag parancsot. Állítsa a paramétert -Blob a blob nevére, és állítsa a -Tag paramétert név- és értékpárok gyűjteményére.

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

Azure CLI

1. Nyissa meg az Azure Cloud Shellt, vagy ha helyileg telepítette az Azure CLI-t, nyisson meg egy parancskonzolalkalmazást, például a Windows PowerShellt.

2. A(z) storage-preview bővítmény telepítése.

   az extension add -n storage-preview
   

3. Ha helyileg használja az Azure CLI-t, futtassa a bejelentkezési parancsot.

   az login
   

4. Ha identitása egynél több előfizetéshez van társítva, állítsa be az aktív előfizetést a tárfiók előfizetésére.

   az account set --subscription <subscription-id>
   

   Cserélje le a <subscription-id> helyőrző értékét az előfizetés azonosítójára.

5. Egy blob címkéinek lekéréséhez használja a az storage blob tag list parancsot, és állítsa a --name paramétert a blob nevére.

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

6. Egy blob címkéinek beállításához használja a az storage blob tag set parancsot. Állítsa a paramétert --name a blob nevére, és állítsa a --tags paramétert név- és értékpárok gyűjteményére.

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

AzCopy

Lásd: Indexcímkék cseréje

Adatok szűrése és keresése blobindexcímkék használatával

Ezt a feladatot egy Storage Blob-adattulajdonos vagy egy biztonsági tag végezheti el, aki egy egyéni Azure-szerepkörön keresztül engedélyt kapott az Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/actionAzure-erőforrás-szolgáltatói műveletre.

Feljegyzés

Nem használhat indexcímkéket a korábbi verziók lekéréséhez. A korábbi verziók címkéi nem lesznek átadva a blobindexmotornak. További információ: Feltételek és ismert problémák.

Portál

Az Azure Portalon a blobindexcímkék szűrője automatikusan alkalmazza a paramétert a @container kiválasztott tároló hatókörére. Ha a teljes tárfiókban szeretné szűrni és megtalálni a címkézett adatokat, használja a REST API-t, az SDK-kat vagy az eszközöket.

1. Az Azure Portalon válassza ki a tárfiókot.

2. Lépjen a Tárolók lehetőségre az Adattárolás területen, és válassza ki a tárolót.

3. A blobindexcímkék szűrő gombját választva szűrhet a kijelölt tárolón belül.

4. Adjon meg egy blobindexcímkekulcsot és egy címkeértéket.

5. Válassza a Blob Index címkeszűrő gombját további címkeszűrők hozzáadásához (legfeljebb 10).

   

PowerShell

1. Jelentkezzen be az Azure-előfizetésbe a Connect-AzAccount paranccsal, és kövesse a képernyőn megjelenő útmutatásokat.

   Connect-AzAccount
   

2. Ha identitása egynél több előfizetéshez van társítva, állítsa be az aktív előfizetést. Ezután kérje le a tárfiók környezetét.

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

3. Az adott blobcímkének megfelelő összes blob megkereséséhez használja a Get-AzStorageBlobByTag parancsot.

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

4. Ha csak egy adott tárolóban szeretne blobokat keresni, adja meg a tároló nevét a -TagFilterSqlExpression.

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

Azure CLI

1. Nyissa meg az Azure Cloud Shellt, vagy ha helyileg telepítette az Azure CLI-t, nyisson meg egy parancskonzolalkalmazást, például a Windows PowerShellt.

2. A(z) storage-preview bővítmény telepítése.

   az extension add -n storage-preview
   

3. Ha helyileg használja az Azure CLI-t, futtassa a bejelentkezési parancsot.

   az login
   

4. Ha identitása egynél több előfizetéshez van társítva, állítsa be az aktív előfizetést a tárfiók előfizetésére.

   az account set --subscription <subscription-id>
   

   Cserélje le a <subscription-id> helyőrző értékét az előfizetés azonosítójára.

5. Az adott blobcímkének megfelelő összes blob megkereséséhez használja a az storage blob filter parancsot.

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

6. Ha csak egy adott tárolóban szeretne blobokat keresni, adja meg a tároló nevét a --tag-filter paraméterben.

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

AzCopy

n/a

Következő lépések

• További információ a blobindexek címkéiről: Azure Blob-adatok kezelése és keresése blobindexcímkékkel
• További információ az életciklus-kezelésről: Az Azure Blob Storage életciklusának kezelése
• További információ arról, hogyan állíthat be indexcímkéket több tárfiókban nagy méretű objektumokon. Lásd : Mi az Azure Storage Actions?