Интеграция с Azure Blob Storage#

Интеграция с Azure Blob Storage подключает контейнеры твоей учетной записи хранения к Ultralytics Platform. Твои изображения остаются в твоих контейнерах — Platform индексирует их на месте, поэтому ты можешь просматривать, размечать и обучать модели YOLO без загрузки копий.

Pro-функция

Для наборов данных Azure Blob Storage требуется план Pro или Enterprise. Бесплатные рабочие пространства видят эту интеграцию, и им будет предложено обновить план при подключении. Существующие наборы данных Azure Blob Storage остаются полностью доступными в случае окончания подписки — Pro требуется только для новых подключений и импорта.

Получи строку подключения#

Platform только читает данные из твоего хранилища — она никогда не записывает, не изменяет и не удаляет твои блобы. Текущая интеграция требует строку подключения с ключом доступа к учетной записи, которая предоставляет привилегии на уровне всей учетной записи, хотя Platform использует только операции просмотра списка и чтения:

1. На портале Azure открой свою учетную запись хранения.
2. Перейди в Security + networking > Access keys (Безопасность и сеть > Ключи доступа).
3. Скопируй connection string (строку подключения).

Только общедоступное облако Azure

Подключения используют стандартную конечную точку blob.core.windows.net. Суверенные облака (Azure China, Azure Government) и пользовательские конечные точки для блобов не поддерживаются.

Подключение к Platform#

1. Перейди в Settings > Integrations и выбери Microsoft Azure из списка интеграций.
2. Вставь строку подключения.
3. Нажми Find available containers, а затем выбери контейнеры для подключения. Ты также можешь ввести имя контейнера вручную.
4. Нажми Connect (Подключить). Перед сохранением данных Platform проверяет, может ли она просматривать список и читать каждый выбранный контейнер.

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

Безопасность учетных данных

Ключ учетной записи может авторизовать операции записи и удаления или создавать SAS-токены, если он окажется за пределами Platform. Учетные данные шифруются в состоянии покоя с помощью AES-256-GCM, никогда не возвращаются в браузер и не попадают в полезную нагрузку заданий обучения. По возможности используй выделенную учетную запись хранения. Чтобы отозвать доступ, смени ключи доступа к учетной записи хранения в Azure.

Создай набор данных из контейнера блобов#

1. Нажми New Dataset и открой вкладку Cloud storage.
2. Выбери подключенный контейнер и перейди к папке, содержащей твои данные.
3. Подтверди выбор папки, укажи название набора данных и создай его.

Platform просканирует папку один раз и проиндексирует найденное:

• Images — брыбы .jpg, .jpeg, .png, .webp и .avif индексируются с чтением размеров через ограниченные запросы. Platform не сохраняет вторую копию исходного изображения.
• Labels — YOLO .txt файлы-сайдкары парсятся в аннотации Platform, сопоставляются по стандартной структуре images/ → labels/ или как файлы, лежащие в той же папке.
• Metadata — файл data.yaml/data.yml содержит имена классов, тип задачи и параметры ключевых точек, в точности как при загрузке архива.
• Разделы (Splits) — имена папок train, val и test в пути к блобу автоматически назначают разделы.

После этого набор данных ведет себя как любой другой: просматривай и размечай его, делай его публичным или приватным, делись им со своей командой и обучай модели с помощью управляемого обучения. Оригиналы передаются по запросу, а проиндексированные изображения не расходуют твою квоту хранилища на Platform.

Ограничения

Один импорт индексирует до 50 000 блобов, а файлы меток или YAML — до 1 МБ каждый. Более крупные контейнеры следует разбивать на несколько наборов данных.

Сохраняй индексированные блобы неизменяемыми

Каждое индексированное изображение привязано к своему ETag блоба, и Platform выдает ошибку, если блоб изменяется без ее ведома. Добавляй новые блобы вместо перезаписи существующих.

Ошибки импорта#

Если импорт завершается с ошибкой — пустая папка, опечатка в пути или отозванные права доступа — набор данных показывает ошибку на своей странице. Редакторы могут нажать Retry import (Повторить импорт), чтобы перезапустить его с сохраненным контейнером и папкой, или создать новый набор данных, указывающий на исправленный путь.

Training#

Управляемое обучение работает через стандартный процесс обучения. Рабочие узлы загружают привязанные оригиналы во временное хранилище заданий для выполнения запуска и удаляют их после очистки задания — твои учетные данные Azure никогда не попадают в вычислительную среду.

Текущие ограничения#

Наборы данных на базе Azure в настоящее время не поддерживают функции, требующие наличия копий твоих изображений на платформе: автоматическая разметка, кластерный анализ, клонирование набора данных и неизменяемые версионные снимки.

Удаление набора данных на базе Azure или отдельных изображений из него удаляет только ссылки Platform — твои блобы никогда не затрагиваются.

Смотри также интеграции Google Cloud Storage и Amazon S3.