Использование тегов индекса больших двоичных объектов для поиска данных и управления ими в хранилище BLOB-объектов Azure

Теги индекса больших двоичных объектов классифицируют данные в учетной записи хранения с помощью атрибутов тегов типа "ключ-значение". Эти теги автоматически индексируются и представляются в виде многомерного индекса с поддержкой поиска для упрощения нахождения данных. В этой статье показано, как задавать, получать и находить данные с помощью тегов индекса больших двоичных объектов.

Дополнительные сведения об этой функции, а также известных проблемах и ограничениях см. в статье Управление данными в хранилище BLOB-объектов Azure и их поиск с помощью индекса больших двоичных объектов.

Отправка нового большого двоичного объекта с тегами индекса

Эту задачу может выполнить владелец данных хранилища BLOB-объектов или субъект безопасности, которому было предоставлено разрешение на выполнение операции поставщика ресурсов Azure Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write с помощью настраиваемой роли Azure.

Портал

1. Выберите свою учетную запись хранения на портале Azure.

2. Перейдите к параметру Контейнеры в разделе Хранилище данных и выберите свой контейнер.

3. Нажмите кнопку Отправить и в локальной файловой системе найдите файл для передачи в виде блочного BLOB-объекта.

4. Разверните раскрывающийся список Дополнительно и перейдите к разделу Теги индекса больших двоичных объектов.

5. Введите теги индекса больших двоичных объектов, которые необходимо применить к данным, в виде пар "ключ-значение".

6. Нажмите кнопку Отправить, чтобы отправить BLOB-объект.

   

PowerShell

1. Войдите в подписку Azure с помощью команды Connect-AzAccount и следуйте инструкциям на экране.

   Connect-AzAccount
   

2. Если ваш идентификатор связан с несколькими подписками, установите активную подписку. Затем получите контекст учетной записи хранения.

   $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-объект с помощью команды Set-AzStorageBlobContent. Задайте теги с помощью параметра -Tag.

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

Azure CLI

1. Откройте Azure Cloud Shell или, если вы установили Azure CLI локально, командное консольное приложение (например, Windows PowerShell).

2. Установите расширение storage-preview.

   az extension add -n storage-preview
   

3. Если вы используете Azure CLI локально, выполните команду для входа.

   az login
   

4. Если ваше удостоверение связано с более чем одной подпиской, сделайте активной ту из них, которая связана с учетной записью хранения.

   az account set --subscription <subscription-id>
   

   Замените значение заполнителя <subscription-id> идентификатором своей подписки.

5. Отправьте 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
   

AzCopy

См. раздел Отправка с тегами индекса.

Получение, задание и обновление тегов индекса больших двоичных объектов

Получение тегов индекса больших двоичных объектов может выполнить владелец данных хранилища BLOB-объектов или субъект безопасности, которому было предоставлено разрешение на выполнение операции поставщика ресурсов Azure Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/read с помощью настраиваемой роли Azure.

Получение и обновление тегов индекса больших двоичных объектов может выполнить владелец данных хранилища BLOB-объектов или субъект безопасности, которому было предоставлено разрешение на выполнение операции поставщика ресурсов Azure Microsoft.Storage/storageAccounts/blobServices/containers/blobs/tags/write с помощью настраиваемой роли Azure.

Портал

1. Выберите свою учетную запись хранения на портале Azure.

2. Перейдите к параметру Контейнеры в разделе Хранилище данных и выберите свой контейнер.

3. Выберите BLOB-объект из списка больших двоичных объектов в выбранном контейнере.

4. На вкладке общих сведений о большом двоичном объекте отображаются его свойства, включая все теги индекса больших двоичных объектов.

5. Вы можете получить, задать, изменить или удалить любые теги индекса в виде пар "ключ-значение" для большого двоичного объекта.

6. Нажмите кнопку Сохранить, чтобы подтвердить изменения большого двоичного объекта.

   

PowerShell

1. Войдите в подписку Azure с помощью команды Connect-AzAccount и следуйте инструкциям на экране.

   Connect-AzAccount
   

2. Если ваш идентификатор связан с несколькими подписками, установите активную подписку. Затем получите контекст учетной записи хранения.

   $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-объекта, используйте команду Get-AzStorageBlobTag и задайте в качестве значения параметра -Blob имя BLOB-объекта.

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

4. Чтобы задать теги 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 CLI

1. Откройте Azure Cloud Shell или, если вы установили Azure CLI локально, командное консольное приложение (например, Windows PowerShell).

2. Установите расширение storage-preview.

   az extension add -n storage-preview
   

3. Если вы используете Azure CLI локально, выполните команду для входа.

   az login
   

4. Если ваше удостоверение связано с более чем одной подпиской, сделайте активной ту из них, которая связана с учетной записью хранения.

   az account set --subscription <subscription-id>
   

   Замените значение заполнителя <subscription-id> идентификатором своей подписки.

5. Чтобы получить теги 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
   

6. Чтобы задать теги 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
   

AzCopy

См. раздел Замена тегов индекса.

Фильтрация и поиск данных с тегами индекса больших двоичных объектов

Эту задачу может выполнить владелец данных хранилища BLOB-объектов или субъект безопасности, которому было предоставлено разрешение на выполнение операции поставщика ресурсов Azure Microsoft.Storage/storageAccounts/blobServices/containers/blobs/filter/action с помощью настраиваемой роли Azure.

Примечание.

Вы не можете запросить теги индекса для получения предыдущих версий. Теги для предыдущих версий не передаются в обработчик индекса больших двоичных объектов. Дополнительные сведения см. в разделе Ограничения и известные проблемы.

Портал

На портале Azure фильтр тегов индекса больших двоичных объектов автоматически применяет параметр @container для ограничения области выбранным контейнером. Если необходимо отфильтровать и найти данные с тегами во всей учетной записи хранения, используйте REST API, пакеты SDK или другие средства.

1. Выберите свою учетную запись хранения на портале Azure.

2. Перейдите к параметру Контейнеры в разделе Хранилище данных и выберите свой контейнер.

3. Нажмите кнопку Фильтр тегов индекса больших двоичных объектов для фильтрации в выбранном контейнере.

4. Введите ключ и значение тега индекса больших двоичных объектов.

5. Нажмите кнопку Фильтр тегов индекса больших двоичных объектов, чтобы добавить дополнительные фильтры тегов (до 10).

   

PowerShell

1. Войдите в подписку Azure с помощью команды Connect-AzAccount и следуйте инструкциям на экране.

   Connect-AzAccount
   

2. Если ваш идентификатор связан с несколькими подписками, установите активную подписку. Затем получите контекст учетной записи хранения.

   $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-объекты, соответствующие конкретному тегу BLOB-объекта, используйте команду Get-AzStorageBlobByTag.

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

4. Чтобы найти BLOB-объекты только в определенном контейнере, включите имя контейнера в параметр -TagFilterSqlExpression.

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

Azure CLI

1. Откройте Azure Cloud Shell или, если вы установили Azure CLI локально, командное консольное приложение (например, Windows PowerShell).

2. Установите расширение storage-preview.

   az extension add -n storage-preview
   

3. Если вы используете Azure CLI локально, выполните команду для входа.

   az login
   

4. Если ваше удостоверение связано с более чем одной подпиской, сделайте активной ту из них, которая связана с учетной записью хранения.

   az account set --subscription <subscription-id>
   

   Замените значение заполнителя <subscription-id> идентификатором своей подписки.

5. Чтобы найти все BLOB-объекты, соответствующие конкретному тегу BLOB-объекта, используйте команду az storage blob filter.

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

6. Чтобы найти BLOB-объекты только в определенном контейнере, включите имя контейнера в параметр --tag-filter.

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

AzCopy

Н/П

Следующие шаги

• Дополнительные сведения о тегах индексов больших двоичных объектов см. в статье Управление данными BLOB-объектов Azure и их поиск с помощью тегов индекса BLOB-объектов
• Дополнительные сведения об управлении жизненным циклом см. в статье Управление жизненным циклом хранилища BLOB-объектов Azure.
• Узнайте больше о том, как задать теги индекса для объектов в масштабе нескольких учетных записей хранения. См. статью "Что такое действия служба хранилища Azure"?