Теги индекса больших двоичных объектов классифицируют данные в учетной записи хранения с помощью атрибутов тегов типа "ключ-значение". Эти теги автоматически индексируются и представляются в виде многомерного индекса с поддержкой поиска для упрощения нахождения данных. В этой статье показано, как задавать, получать и находить данные с помощью тегов индекса больших двоичных объектов.
Дополнительные сведения об этой функции, а также об известных проблемах и ограничениях см. в статье Управление данными Azure Blob и их поиск с помощью тегов индекса больших двоичных объектов.
Эту задачу может выполнить владелец данных BLOB-объектов хранилища или субъект безопасности, которому было предоставлено разрешение на выполнение операции Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeпоставщика ресурсов Azure с помощью настраиваемой роли Azure.
Выберите свою учетную запись хранения на портале Azure.
Перейдите к параметру Контейнеры в разделе Хранилище данных и выберите свой контейнер.
Нажмите кнопку Отправить и в локальной файловой системе найдите файл для передачи в виде блочного BLOB-объекта.
Разверните раскрывающийся список Дополнительно и перейдите к разделу Теги индекса BLOB-объектов.
Введите теги индекса BLOB-объектов в формате «ключ-значение», которые нужно применить к вашим данным.
Нажмите кнопку Отправить, чтобы отправить BLOB-объект.
Войдите в подписку Azure с помощью команды Connect-AzAccount и следуйте инструкциям на экране.
Connect-AzAccount
Если ваш идентификатор связан с несколькими подписками, установите активную подписку. Затем получите контекст учетной записи хранения.
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
Отправьте BLOB-объект с помощью команды Set-AzStorageBlobContent. Задайте теги с помощью параметра -Tag.
$containerName = "myContainer"
$file = "C:\demo-file.txt"
Set-AzStorageBlobContent -File $file -Container $containerName -Context $ctx -Tag @{"tag1" = "value1"; "tag2" = "value2" }
Откройте Azure Cloud Shell или, если вы установили Azure CLI локально, командное консольное приложение (например, Windows PowerShell).
Установите расширение storage-preview.
az extension add -n storage-preview
Если вы используете Azure CLI локально, выполните команду для входа.
az login
Если ваши учетные данные связаны с несколькими подписками, сделайте активной подписку учетной записи хранения.
az account set --subscription <subscription-id>
Замените значение заполнителя <subscription-id> идентификатором своей подписки.
Отправьте BLOB-объект с помощью команды az storage blob upload. Задайте теги с помощью параметра --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
Получение тегов индекса больших двоичных объектов может быть выполнено пользователем с ролью владелец данных больших двоичных объектов хранилища или субъектом безопасности, которому было предоставлено разрешение на выполнение Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/readоперации поставщика ресурсов Azure с помощью настраиваемой роли Azure.
Задание и обновление тегов индекса больших двоичных объектов могут выполняться пользователем с ролью Storage Blob Data Owner или субъектом безопасности, которому было предоставлено разрешение на выполнение Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/writeоперации поставщика ресурсов Azure с помощью настраиваемой роли Azure.
Выберите свою учетную запись хранения на портале Azure.
Перейдите к параметру Контейнеры в разделе Хранилище данных и выберите свой контейнер.
Выберите нужный BLOB из списка BLOB-объектов в выбранном контейнере.
На вкладке общих сведений о большом двоичном объекте отображаются его свойства, включая все теги индекса больших двоичных объектов.
Вы можете получать, устанавливать, изменять или удалять любые теги индекса "ключ-значение" для вашего BLOB-объекта.
Нажмите кнопку Сохранить, чтобы подтвердить все изменения BLOB-объекта.
Войдите в подписку Azure с помощью команды Connect-AzAccount и следуйте инструкциям на экране.
Connect-AzAccount
Если ваш идентификатор связан с несколькими подписками, установите активную подписку. Затем получите контекст учетной записи хранения.
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
Чтобы получить теги BLOB-объекта, используйте команду Get-AzStorageBlobTag и задайте в качестве значения параметра -Blob имя BLOB-объекта.
$containerName = "myContainer"
$blobName = "myBlob"
Get-AzStorageBlobTag -Context $ctx -Container $containerName -Blob $blobName
Чтобы задать теги для BLOB-объекта, используйте команду Set-AzStorageBlobTag. Задайте в качестве значения параметра -Blob имя BLOB-объекта и задайте в качестве значения параметра -Tag коллекцию пар "имя-значение".
$containerName = "myContainer"
$blobName = "myBlob"
$tags = @{"tag1" = "value1"; "tag2" = "value2" }
Set-AzStorageBlobTag -Context $ctx -Container $containerName -Blob $blobName -Tag $tags
Откройте Azure Cloud Shell или, если вы установили Azure CLI локально, командное консольное приложение (например, Windows PowerShell).
Установите расширение storage-preview.
az extension add -n storage-preview
Если вы используете Azure CLI локально, выполните команду для входа.
az login
Если ваши учетные данные связаны с несколькими подписками, сделайте активной подписку учетной записи хранения.
az account set --subscription <subscription-id>
Замените значение заполнителя <subscription-id> идентификатором своей подписки.
Чтобы получить теги BLOB-объекта, используйте команду az storage blob tag list и задайте в качестве значения параметра --name имя BLOB-объекта.
az storage blob tag list --account-name mystorageaccount --container-name myContainer --name demo-file.txt --auth-mode login
Чтобы задать теги для BLOB-объекта, используйте команду az storage blob tag set. Задайте в качестве значения параметра --name имя BLOB-объекта и задайте в качестве значения параметра --tags коллекцию пар "имя-значение".
az storage blob tag set --account-name mystorageaccount --container-name myContainer --name demo-file.txt --tags tag1=value1 tag2=value2 --auth-mode login
Эту задачу может выполнить владелец данных BLOB-объектов хранилища или субъект безопасности, которому было предоставлено разрешение на выполнение операции Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/actionпоставщика ресурсов Azure с помощью настраиваемой роли Azure.
Примечание.
Вы не можете запросить теги индекса для получения предыдущих версий. Теги для предыдущих версий не передаются в обработчик индекса больших двоичных объектов. Дополнительные сведения см. в разделе Ограничения и известные проблемы.
В портале Azure фильтр тегов индекса BLOB-объектов автоматически применяет параметр @container, чтобы ограничить область действия выбранным контейнером. Если необходимо отфильтровать и найти данные с тегами во всей учетной записи хранения, используйте REST API, пакеты SDK или другие средства.
Выберите свою учетную запись хранения на портале Azure.
Перейдите к параметру Контейнеры в разделе Хранилище данных и выберите свой контейнер.
Выберите кнопку Фильтр тегов индекса BLOB-объектов, чтобы отфильтровать содержимое выбранного контейнера.
Введите ключ и значение тега индекса больших двоичных объектов.
Выберите кнопку Фильтр тегов индекса BLOB-объектов, чтобы добавить дополнительные фильтры тегов (до 10).
Войдите в подписку Azure с помощью команды Connect-AzAccount и следуйте инструкциям на экране.
Connect-AzAccount
Если ваш идентификатор связан с несколькими подписками, установите активную подписку. Затем получите контекст учетной записи хранения.
$context = Get-AzSubscription -SubscriptionId <subscription-id>
Set-AzContext $context
$storageAccount = Get-AzStorageAccount -ResourceGroupName "<resource-group-name>" -AccountName "<storage-account-name>"
$ctx = $storageAccount.Context
Чтобы найти все BLOB-объекты, соответствующие определённому тегу BLOB-объекта, используйте команду Get-AzStorageBlobByTag.
$filterExpression = """tag1""='value1'"
Get-AzStorageBlobByTag -TagFilterSqlExpression $filterExpression -Context $ctx
Чтобы найти BLOB-объекты только в определенном контейнере, включите имя контейнера в параметр -TagFilterSqlExpression.
$filterExpression = "@container='myContainer' AND ""tag1""='value1'"
Get-AzStorageBlobByTag -TagFilterSqlExpression $filterExpression -Context $ctx
Откройте Azure Cloud Shell или, если вы установили Azure CLI локально, командное консольное приложение (например, Windows PowerShell).
Установите расширение storage-preview.
az extension add -n storage-preview
Если вы используете Azure CLI локально, выполните команду для входа.
az login
Если ваши учетные данные связаны с несколькими подписками, сделайте активной подписку учетной записи хранения.
az account set --subscription <subscription-id>
Замените значение заполнителя <subscription-id> идентификатором своей подписки.
Чтобы найти все BLOB-объекты, соответствующие определённому тегу BLOB-объекта, используйте команду az storage blob filter.
az storage blob filter --account-name mystorageaccount --tag-filter """tag1""='value1' and ""tag2""='value2'" --auth-mode login
Чтобы найти BLOB-объекты только в определенном контейнере, включите имя контейнера в параметр --tag-filter.
az storage blob filter --account-name mystorageaccount --tag-filter """@container""='myContainer' and ""tag1""='value1' and ""tag2""='value2'" --auth-mode login
Следующие шаги