Теги индекса больших двоичных объектов классифицируют данные в учетной записи хранения с помощью атрибутов тегов типа "ключ-значение". Эти теги автоматически индексируются и представляются в виде многомерного индекса с поддержкой поиска для упрощения нахождения данных. В этой статье показано, как задавать, получать и находить данные с помощью тегов индекса больших двоичных объектов.
Дополнительные сведения об этой функции, а также известных проблемах и ограничениях см. в статье Управление данными в хранилище BLOB-объектов Azure и их поиск с помощью индекса больших двоичных объектов.
Эту задачу может выполнить владелец данных хранилища BLOB-объектов или субъект безопасности, которому было предоставлено разрешение на выполнение операции поставщика ресурсов Azure Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write с помощью настраиваемой роли Azure.
Выберите свою учетную запись хранения на портале Azure.
Перейдите к параметру Контейнеры в разделе Хранилище данных и выберите свой контейнер.
Нажмите кнопку Отправить и в локальной файловой системе найдите файл для передачи в виде блочного 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
Получение тегов индекса больших двоичных объектов может выполнить владелец данных хранилища BLOB-объектов или субъект безопасности, которому было предоставлено разрешение на выполнение операции поставщика ресурсов Azure Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read с помощью настраиваемой роли Azure.
Получение и обновление тегов индекса больших двоичных объектов может выполнить владелец данных хранилища BLOB-объектов или субъект безопасности, которому было предоставлено разрешение на выполнение операции поставщика ресурсов Azure Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write с помощью настраиваемой роли Azure.
Выберите свою учетную запись хранения на портале Azure.
Перейдите к параметру Контейнеры в разделе Хранилище данных и выберите свой контейнер.
Выберите 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-объектов или субъект безопасности, которому было предоставлено разрешение на выполнение операции поставщика ресурсов Azure Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action с помощью настраиваемой роли Azure.
Примечание.
Вы не можете запросить теги индекса для получения предыдущих версий. Теги для предыдущих версий не передаются в обработчик индекса больших двоичных объектов. Дополнительные сведения см. в разделе Ограничения и известные проблемы.
На портале Azure фильтр тегов индекса больших двоичных объектов автоматически применяет параметр @container для ограничения области выбранным контейнером. Если необходимо отфильтровать и найти данные с тегами во всей учетной записи хранения, используйте REST API, пакеты SDK или другие средства.
Выберите свою учетную запись хранения на портале Azure.
Перейдите к параметру Контейнеры в разделе Хранилище данных и выберите свой контейнер.
Нажмите кнопку Фильтр тегов индекса больших двоичных объектов для фильтрации в выбранном контейнере.
Введите ключ и значение тега индекса больших двоичных объектов.
Нажмите кнопку Фильтр тегов индекса больших двоичных объектов, чтобы добавить дополнительные фильтры тегов (до 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
Следующие шаги