Tích hợp Azure Blob Storage#

Tích hợp Azure Blob Storage kết nối các container trong storage account của bạn với Ultralytics Platform. Hình ảnh vẫn nằm trong các container của bạn — Platform lập chỉ mục trực tiếp tại đó, vì vậy bạn có thể duyệt, gắn nhãn và train các model YOLO mà không cần upload bản sao.

Lấy Connection String#

Platform chỉ đọc dữ liệu từ storage của bạn — không bao giờ ghi, sửa đổi hoặc xóa các blob. Tích hợp hiện tại yêu cầu connection string dùng account access key, cấp quyền trên toàn account dù Platform chỉ sử dụng các thao tác list và read:

1. Trong Azure portal, mở storage account của bạn.
2. Đi tới Security + networking > Access keys.
3. Sao chép connection string.

Chuỗi này phải chứa AccountName, AccountKey và HTTPS làm protocol — đúng biểu mẫu Azure cung cấp trong Access keys. Connection string dùng SAS token, chứa SharedAccessSignature thay vì AccountKey, sẽ bị từ chối.

Kết nối với Platform#

1. Đi tới Settings > Integrations và chọn Azure Blob Storage từ danh sách tích hợp.
2. Dán connection string.
3. Nhấp Find available containers, sau đó chọn các container cần kết nối. Bạn cũng có thể nhập thủ công tên container .
4. Nhấp Connect. Platform xác minh rằng có thể list và read từng container đã chọn trước khi lưu bất kỳ dữ liệu nào.

Bạn cần vai trò quản trị viên hoặc chủ sở hữu workspace để kết nối cloud storage. Một kết nối hỗ trợ tối đa 50 container và quá trình discovery liệt kê tối đa 300 container trong storage account.

Khi kết nối lại cùng storage account sau đó, các container mới sẽ được thêm vào tích hợp hiện có. Credential đã lưu chỉ được thay thế sau khi credential thay thế vẫn có thể read mọi container mà bạn đã kết nối trước đó.

Tạo Dataset từ Blob Container#

1. Nhấp New Dataset và mở tab Cloud.
2. Chọn một container đã kết nối và duyệt đến folder chứa dữ liệu của bạn.
3. Xác nhận thư mục, điều chỉnh tên dataset rồi tạo dataset.

Platform liệt kê thư mục một lần và lập chỉ mục các nội dung tìm thấy:

• Images — Các blob .jpg, .jpeg, .png, .webp và .avif được lập chỉ mục với kích thước đọc qua các request có giới hạn. Platform không lưu một bản sao thứ hai của image nguồn.
• Labels — các file sidecar YOLO .txt được phân tích thành annotation của Platform, khớp theo bố cục chuẩn images/ → labels/ hoặc dưới dạng các file cùng thư mục.
• Metadata — một file YAML cung cấp tên class và hình dạng keypoint cho pose, giống hệt như upload archive. data.yaml và data.yml được ưu tiên khi thư mục chứa nhiều file.
• Task — một mẫu các file label quyết định task, vì vậy các thư mục segment, pose và OBB được nhận diện dựa trên cấu trúc label thay vì task bạn chọn trong hộp thoại.
• Splits — Tên folder train, val và test trong blob path sẽ tự động gán các split.

Dataset sau đó hoạt động như mọi dataset khác: duyệt và annotate, đặt ở chế độ public hoặc private, chia sẻ với team của bạn và train trên đó thông qua managed training. Các file gốc được stream theo nhu cầu, và hình ảnh đã lập chỉ mục không tiêu tốn storage quota của Platform.

Import thất bại#

Nếu một lần import thất bại — do folder rỗng, lỗi chính tả trong path hoặc quyền đã bị thu hồi — dataset sẽ hiển thị lỗi trên trang của nó. Editor có thể nhấp Retry import để khởi động lại bằng container và folder đã lưu, hoặc tạo dataset mới trỏ đến path đã sửa.

Thao tác retry sẽ list lại folder thay vì tiếp tục từ trạng thái trước đó: các blob được thêm từ lần thử đầu tiên sẽ được nhận diện, còn các blob không còn tồn tại sẽ bị loại khỏi dataset.

Training#

Managed training hoạt động thông qua training flow thông thường. Quá trình training sử dụng các bản sao riêng của Platform đối với những image đã ghim trong suốt thời gian run, và Azure credential của bạn không bao giờ bị expose cho training workload.

Ngắt kết nối một Connection#

Ngắt kết nối sẽ xóa connection string đã lưu mà không tác động đến bất kỳ dữ liệu nào trong Azure. Các dataset được tạo từ những container đó vẫn nằm trong workspace của bạn cùng với class, label và annotation, nhưng không thể load, preview hoặc train trên image cho đến khi cùng storage account được kết nối lại.

Sử dụng REST API với integration ID do GET /api/integrations/buckets trả về:

curl -X DELETE \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://platform.ultralytics.com/api/integrations/buckets/INTEGRATION_ID

from ultralytics_platform import Platform

client = Platform()  # reads ULTRALYTICS_API_KEY
integrations = client.storage_integrations.list()
client.storage_integrations.delete("INTEGRATION_ID")

Thay vào đó, để thu hồi quyền truy cập tại nguồn, hãy rotate access key của storage account trong Azure.

Các giới hạn hiện tại#

Các dataset được hỗ trợ bởi Azure hiện không bao gồm những tính năng yêu cầu Platform sở hữu bản sao của image: auto-annotation, phân tích clustering, nhân bản dataset và snapshot phiên bản bất biến.

Xóa dataset được hỗ trợ bởi Azure hoặc từng image trong đó chỉ xóa các reference của Platform — các blob của bạn không bao giờ bị tác động.

Xem thêm các tích hợp Google Cloud Storage và Amazon S3.

FAQ#