Używanie tagów indeksu obiektów blob do zarządzania danymi i znajdowania ich w usłudze Azure Blob Storage

Tagi indeksu obiektów blob kategoryzują dane na koncie magazynu przy użyciu atrybutów tagów klucz-wartość. Te tagi są automatycznie indeksowane i uwidaczniane jako indeks wielowymiarowy z możliwością wyszukiwania w celu łatwego znajdowania danych. W tym artykule przedstawiono sposób ustawiania, pobierania i znajdowania danych przy użyciu tagów indeksu obiektów blob.

Aby dowiedzieć się więcej o tej funkcji wraz ze znanymi problemami i ograniczeniami, zobacz Zarządzanie danymi obiektów blob platformy Azure i znajdowanie ich za pomocą tagów indeksu obiektów blob.

Przekazywanie nowego obiektu blob z tagami indeksu

To zadanie może być wykonywane przez właściciela danych obiektu blob usługi Storage lub podmiotu zabezpieczeń, który otrzymał uprawnienia do Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write operacji dostawcy zasobów platformy Azure za pośrednictwem niestandardowej roli platformy Azure.

Portal

1. W witrynie Azure Portal wybierz konto magazynu.

2. Przejdź do opcji Kontenery w obszarze Magazyn danych i wybierz kontener.

3. Wybierz przycisk Przekaż i przeglądaj lokalny system plików, aby znaleźć plik do przekazania jako blokowy obiekt blob.

4. Rozwiń listę rozwijaną Zaawansowane i przejdź do sekcji Tagi indeksu obiektów blob.

5. Wprowadź tagi indeksu obiektu blob klucza/wartości, które mają zostać zastosowane do danych.

6. Wybierz przycisk Przekaż, aby przekazać obiekt blob.

   

Program PowerShell

1. Zaloguj się do subskrypcji platformy Azure za pomocą polecenia Connect-AzAccount i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

   Connect-AzAccount
   

2. Jeśli tożsamość jest skojarzona z więcej niż jedną subskrypcją, ustaw aktywną subskrypcję. Następnie pobierz kontekst konta magazynu.

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

3. Przekaż obiekt blob przy użyciu Set-AzStorageBlobContent polecenia . Ustaw tagi przy użyciu parametru -Tag .

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

Interfejs wiersza polecenia platformy Azure

1. Otwórz usługę Azure Cloud Shell lub jeśli interfejs wiersza polecenia platformy Azure został zainstalowany lokalnie, otwórz aplikację konsolową poleceń, taką jak program Windows PowerShell.

2. Należy zainstalować rozszerzenie storage-preview.

   az extension add -n storage-preview
   

3. Jeśli używasz interfejsu wiersza polecenia platformy Azure lokalnie, uruchom polecenie logowania.

   az login
   

4. Jeśli tożsamość jest skojarzona z więcej niż jedną subskrypcją, ustaw aktywną subskrypcję na subskrypcję konta magazynu.

   az account set --subscription <subscription-id>
   

   Zastąp wartość symbolu <subscription-id> zastępczego identyfikatorem subskrypcji.

5. Przekaż obiekt blob przy użyciu az storage blob upload polecenia . Ustaw tagi przy użyciu parametru --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

Zobacz Przekazywanie za pomocą tagów indeksu.

Pobieranie, ustawianie i aktualizowanie tagów indeksów obiektów blob

Pobieranie tagów indeksu obiektów blob może być wykonywane przez właściciela danych obiektu blob usługi Storage lub podmiotu zabezpieczeń, który otrzymał uprawnienia do Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read operacji dostawcy zasobów platformy Azure za pośrednictwem niestandardowej roli platformy Azure.

Ustawianie i aktualizowanie tagów indeksu obiektów blob może być wykonywane przez właściciela danych obiektu blob usługi Storage lub podmiotu zabezpieczeń, który otrzymał uprawnienie do Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write operacji dostawcy zasobów platformy Azure za pośrednictwem niestandardowej roli platformy Azure.

Portal

1. W witrynie Azure Portal wybierz konto magazynu.

2. Przejdź do opcji Kontenery w obszarze Magazyn danych, wybierz kontener.

3. Wybierz obiekt blob z listy obiektów blob w wybranym kontenerze.

4. Karta Przegląd obiektu blob wyświetli właściwości obiektu blob, w tym tagi indeksu obiektów blob.

5. Możesz pobrać, ustawić, zmodyfikować lub usunąć dowolne tagi indeksu klucza/wartości dla obiektu blob.

6. Wybierz przycisk Zapisz, aby potwierdzić wszystkie aktualizacje obiektu blob.

   

Program PowerShell

1. Zaloguj się do subskrypcji platformy Azure za pomocą polecenia Connect-AzAccount i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

   Connect-AzAccount
   

2. Jeśli tożsamość jest skojarzona z więcej niż jedną subskrypcją, ustaw aktywną subskrypcję. Następnie pobierz kontekst konta magazynu.

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

3. Aby uzyskać tagi obiektu blob, użyj Get-AzStorageBlobTag polecenia i ustaw -Blob parametr na nazwę obiektu blob.

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

4. Aby ustawić tagi obiektu blob, użyj Set-AzStorageBlobTag polecenia . -Blob Ustaw parametr na nazwę obiektu blob i ustaw -Tag parametr na kolekcję par nazw i wartości.

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

Interfejs wiersza polecenia platformy Azure

1. Otwórz usługę Azure Cloud Shell lub jeśli interfejs wiersza polecenia platformy Azure został zainstalowany lokalnie, otwórz aplikację konsolową poleceń, taką jak program Windows PowerShell.

2. Należy zainstalować rozszerzenie storage-preview.

   az extension add -n storage-preview
   

3. Jeśli używasz interfejsu wiersza polecenia platformy Azure lokalnie, uruchom polecenie logowania.

   az login
   

4. Jeśli tożsamość jest skojarzona z więcej niż jedną subskrypcją, ustaw aktywną subskrypcję na subskrypcję konta magazynu.

   az account set --subscription <subscription-id>
   

   Zastąp wartość symbolu <subscription-id> zastępczego identyfikatorem subskrypcji.

5. Aby uzyskać tagi obiektu blob, użyj az storage blob tag list polecenia i ustaw --name parametr na nazwę obiektu blob.

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

6. Aby ustawić tagi obiektu blob, użyj az storage blob tag set polecenia . --name Ustaw parametr na nazwę obiektu blob i ustaw --tags parametr na kolekcję par nazw i wartości.

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

AzCopy

Zobacz Zastępowanie tagów indeksu

Filtrowanie i znajdowanie danych za pomocą tagów indeksu obiektów blob

To zadanie może być wykonywane przez właściciela danych obiektu blob usługi Storage lub podmiotu zabezpieczeń, który otrzymał uprawnienia do Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action operacji dostawcy zasobów platformy Azure za pośrednictwem niestandardowej roli platformy Azure.

Uwaga

Nie można użyć tagów indeksu do pobrania poprzednich wersji. Tagi dla poprzednich wersji nie są przekazywane do aparatu indeksowania obiektów blob. Aby uzyskać więcej informacji, zobacz Warunki i znane problemy.

Portal

W witrynie Azure Portal filtr tagów indeksu obiektów blob automatycznie stosuje @container parametr do zakresu wybranego kontenera. Jeśli chcesz filtrować i znajdować oznakowane dane na całym koncie magazynu, użyj naszego interfejsu API REST, zestawów SDK lub narzędzi.

1. W witrynie Azure Portal wybierz konto magazynu.

2. Przejdź do opcji Kontenery w obszarze Magazyn danych, wybierz kontener.

3. Wybierz przycisk Filtr tagów indeksu obiektów blob, aby filtrować w wybranym kontenerze.

4. Wprowadź klucz tagu indeksu obiektów blob i wartość tagu.

5. Wybierz przycisk filtrowania tagów indeksu obiektów blob, aby dodać dodatkowe filtry tagów (maksymalnie 10).

   

Program PowerShell

1. Zaloguj się do subskrypcji platformy Azure za pomocą polecenia Connect-AzAccount i postępuj zgodnie z instrukcjami wyświetlanymi na ekranie.

   Connect-AzAccount
   

2. Jeśli tożsamość jest skojarzona z więcej niż jedną subskrypcją, ustaw aktywną subskrypcję. Następnie pobierz kontekst konta magazynu.

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

3. Aby znaleźć wszystkie obiekty blob pasujące do określonego tagu obiektu blob, użyj Get-AzStorageBlobByTag polecenia .

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

4. Aby znaleźć obiekty blob tylko w określonym kontenerze, uwzględnij nazwę kontenera w obiekcie -TagFilterSqlExpression.

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

Interfejs wiersza polecenia platformy Azure

1. Otwórz usługę Azure Cloud Shell lub jeśli interfejs wiersza polecenia platformy Azure został zainstalowany lokalnie, otwórz aplikację konsolową poleceń, taką jak program Windows PowerShell.

2. Należy zainstalować rozszerzenie storage-preview.

   az extension add -n storage-preview
   

3. Jeśli używasz interfejsu wiersza polecenia platformy Azure lokalnie, uruchom polecenie logowania.

   az login
   

4. Jeśli tożsamość jest skojarzona z więcej niż jedną subskrypcją, ustaw aktywną subskrypcję na subskrypcję konta magazynu.

   az account set --subscription <subscription-id>
   

   Zastąp wartość symbolu <subscription-id> zastępczego identyfikatorem subskrypcji.

5. Aby znaleźć wszystkie obiekty blob pasujące do określonego tagu obiektu blob, użyj az storage blob filter polecenia .

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

6. Aby znaleźć obiekty blob tylko w określonym kontenerze, dołącz nazwę kontenera do parametru --tag-filter .

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

AzCopy

Nie dotyczy

Następne kroki

• Dowiedz się więcej o tagach indeksów obiektów blob, zobacz Zarządzanie danymi obiektów blob platformy Azure i znajdowanie ich za pomocą tagów indeksu obiektów blob
• Dowiedz się więcej na temat zarządzania cyklem życia, zobacz Zarządzanie cyklem życia usługi Azure Blob Storage
• Dowiedz się więcej na temat ustawiania tagów indeksów na obiektach na dużą skalę na wielu kontach magazynu. Zobacz Co to jest usługa Azure Storage Actions?