Узнайте, как приложения взаимодействуют с данными в Blob Storage

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

Клиентские библиотеки Azure Blob Storage позволяют взаимодействовать с тремя типами ресурсов, предоставляемыми службой хранения.

• Учетные записи хранения
• Контейнеры BLOB
• Blob

На следующей схеме показана связь между этими ресурсами:

Учетная запись хранения предоставляет уникальное пространство имен в Azure для ваших данных. Каждый объект, который вы храните в службе хранилища Azure, имеет адрес, содержащий уникальное имя учетной записи. Сочетание имени учетной записи и конечной точки Blob-хранилища формирует базовый адрес для объектов в учетной записи.

Например, если учетная запись хранения называется sampleaccount, то конечная точка по умолчанию для Blob-хранилища:

https://sampleaccount.blob.core.windows.net

Дополнительные сведения о типах учетных записей хранения см. в обзоре учетной записи хранения Azure.

Контейнер организует набор блобов, аналогично каталогу в файловой системе. Учетная запись хранения может включать неограниченное количество контейнеров, а контейнер может содержать неограниченное количество блобов.

Универсальный код ресурса (URI) для контейнера аналогичен:

https://sampleaccount.blob.core.windows.net/sample-container

Для получения дополнительных сведений об именовании контейнеров см. раздел «Именование и ссылки на контейнеры, блобы и метаданные».

Служба хранилища Azure поддерживает три типа объектов BLOB:

• Блочные большие двоичные объекты хранят текстовые и двоичные данные. Блобы-блоки состоят из блоков данных, которыми можно управлять отдельно. Блочные блобы могут хранить до приблизительно 190,7 ТиБ.
• Дополняемые двоичные объекты состоят из блоков, как обычные блочные объекты, но оптимизированы для операций добавления. Блобы добавления идеально подходят для сценариев, таких как ведение журналов данных с виртуальных машин.
• Страничные BLOB-объекты хранят файлы с произвольным доступом размером до 8 ТиБ. Дополнительные сведения о страничных BLOB-объектах см. в статье "Обзор страничных BLOB-объектов Azure"

Дополнительные сведения о различных типах BLOB-объектов см. в разделе Общие сведения о блобах блоков, блобах добавления и блобах страниц.

Универсальный идентификатор ресурса (URI) для BLOB аналогичен следующему:

https://sampleaccount.blob.core.windows.net/sample-container/sample-blob

Дополнительные сведения об именовании больших двоичных объектов см. в разделе Именование и ссылки на контейнеры, большие двоичные объекты и метаданные.

Пакеты SDK Azure содержат библиотеки, которые создаются на основе REST API Azure, что позволяет взаимодействовать с операциями REST API с помощью знакомых парадигм языка программирования. Пакеты SDK предназначены для упрощения взаимодействия между приложением и ресурсами Azure.

В редких случаях приложения, обновленные до последней бета-версии или общедоступной версии SDK, могут получить сообщение об ошибке InvalidHeaderValue. Эта проблема может возникнуть при использовании любой из библиотек хранения данных. Сообщение об ошибке похоже на следующий пример:

HTTP/1.1 400 The value for one of the HTTP headers is not in the correct format.
Content-Length: 328
Content-Type: application/xml
Server: Microsoft-HTTPAPI/2.0
x-ms-request-id: <REMOVED>
Date: Fri, 19 May 2023 17:10:33 GMT
 
<?xml version="1.0" encoding="utf-8"?>
<Error>
<Code>InvalidHeaderValue</Code>
<Message>
The value for one of the HTTP headers is not in the correct format.
RequestId:<REMOVED>
Time:2023-05-19T17:10:34.2972651Z
</Message>
<HeaderName>x-ms-version</HeaderName><HeaderValue>yyyy-mm-dd</HeaderValue>
</Error>

Если вы обновили SDK до последней бета-версии или общей доступной версии и сталкиваетесь с этой ошибкой, рекомендуется понизить версию до предыдущей общей доступной версии SDK, чтобы посмотреть, решится ли проблема.

Сведения о пакете SDK можно просмотреть в следующих расположениях:

• .СЕТЬ
• Java
• JS
• Питон

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

В клиентских библиотеках хранилища BLOB-объектов Azure каждый тип ресурса представлен одним или несколькими связанными классами. Эти классы предоставляют операции для работы с ресурсом службы хранилища Azure.

Работа с ресурсами Azure с помощью пакета SDK начинается с создания экземпляра клиента. Дополнительные сведения о создании и управлении клиентскими объектами см. в статье "Создание клиентских объектов и управление ими", взаимодействующих с ресурсами данных.