Używanie tagów indeksu obiektów blob do zarządzania danymi i znajdowania ich w 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 Manage and find Azure Blob data with blob index tags (Zarządzanie danymi obiektów blob 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/writeoperacji dostawcy zasobów platformy Azure za pośrednictwem niestandardowej roli platformy Azure.

Portal

1. W 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 zainstalowano interfejs wiersza polecenia platformy Azure lokalnie, otwórz aplikację konsolową poleceń, taką jak 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 indeksu 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/readoperacji 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ł uprawnienia do Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeoperacji dostawcy zasobów platformy Azure za pośrednictwem niestandardowej roli platformy Azure.

Portal

1. W Azure Portal wybierz konto magazynu.

2. Przejdź do opcji Kontenery w obszarze Magazyn danych i 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 wszystkie tagi indeksu obiektów blob.

5. Można pobrać, ustawić, zmodyfikować lub usunąć dowolny tag 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 nazwa i wartość.

   $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 zainstalowano interfejs wiersza polecenia platformy Azure lokalnie, otwórz aplikację konsolową poleceń, taką jak 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 nazwa i wartość.

   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/actionoperacji 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 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 Azure Portal wybierz konto magazynu.

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

3. Wybierz przycisk filtru Tagi indeksu obiektów blob , aby filtrować w wybranym kontenerze.

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

5. Wybierz przycisk filtru Tagi 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 Get-AzStorageBlobByTag obiektu blob, użyj 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 elemecie -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 zainstalowano interfejs wiersza polecenia platformy Azure lokalnie, otwórz aplikację konsolową poleceń, taką jak 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 az storage blob filter obiektu blob, użyj 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 indeksu 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 o zarządzaniu cyklem życia, zobacz Zarządzanie cyklem życia Azure Blob Storage