Tích hợp Azure Blob Storage#

Tích hợp Azure Blob Storage kết nối các container trong tài khoản lưu trữ 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 tại chỗ, nhờ đó bạn có thể duyệt, gắn nhãn và huấn luyện model YOLO mà không cần tải lên bản sao.

Lấy chuỗi kết nối#

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

1. Trong Azure portal, mở tài khoản lưu trữ của bạn.
2. Đi đến Security + networking > Access keys.
3. Sao chép chuỗi kết nối.

Chuỗi phải có AccountName, AccountKey và HTTPS làm giao thức — theo định dạng Azure cung cấp trong Access keys. Chuỗi kết nối dùng SAS token, chứa SharedAccessSignature thay vì AccountKey, sẽ bị từ chối.

Kết nối với Platform#

1. Đi đến Settings > Integrations và chọn Azure Blob Storage trong danh sách tích hợp.
2. Dán chuỗi kết nối.
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 tên container thủ công.
4. Nhấp Connect. Platform xác minh rằng có thể liệt kê và đọc từng container đã chọn trước khi lưu bất cứ thông tin nào.

Bạn cần có [vai trò](https://ultralytics-translation-0.invalid 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 tìm kiếm liệt kê tối đa 300 container trong tài khoản lưu trữ.

Kết nối lại cùng tài khoản lưu trữ sau này sẽ thêm các container mới vào tích hợp hiện có. Thông tin xác thực đã lưu chỉ được thay thế khi thông tin thay thế vẫn có thể đọc mọi container bạn đã kết nối.

Tạo dataset từ blob container#

1. Nhấp New Dataset rồi mở tab Cloud.
2. Chọn một container đã kết nối và duyệt đến thư mục 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:

• Hình ảnh — blob có phần mở rộng .jpg, .jpeg, .png, .webp và .avif được lập chỉ mục; kích thước được đọc thông qua các request có giới hạn. Platform không lưu một bản sao thứ hai của ảnh nguồn.
• Nhãn — Các tệp phụ .txt YOLO được phân tích cú pháp thành annotation trong Platform, ghép theo cấu trúc chuẩn images/ → labels/ hoặc theo các tệp cùng thư mục.
• Metadata — Tệp YAML cung cấp tên lớp và hình dạng keypoint pose, giống hệt như khi tải lên archive. Ưu tiên data.yaml và data.yml nếu thư mục chứa nhiều tệp.
• Tác vụ — Một mẫu tệp nhãn sẽ xác định tác vụ, 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 nhãn thay vì tác vụ bạn chọn trong hộp thoại.
• Các tập dữ liệu — tên thư mục train, val và test trong đường dẫn blob tự động xác định các tập dữ liệu.

Sau đó, dataset hoạt động như mọi dataset khác: duyệt và gắn nhãn, đặt chế độ công khai hoặc riêng tư, chia sẻ với nhóm của bạn và huấn luyện bằng dịch vụ huấn luyện được quản lý. Các tệp gốc được truyền trực tuyến theo yêu cầu và hình ảnh đã lập chỉ mục không sử dụng hạn mức bộ nhớ trên Platform của bạn.

Lần nhập thất bại#

Nếu lần nhập thất bại — do thư mục trống, đường dẫn bị nhập sai hoặc quyền bị thu hồi — dataset sẽ hiển thị lỗi trên trang của dataset. Biên tập viên có thể nhấp Retry import để khởi động lại bằng container và thư mục đã lưu, hoặc tạo dataset mới trỏ đến đường dẫn chính xác.

Thử lại sẽ liệt kê lại thư mục thay vì tiếp tục từ lần trước: các blob được thêm kể từ lần thử đầu tiên sẽ được đưa vào, còn các blob không còn ở đó sẽ bị loại khỏi dataset.

Huấn luyện#

Huấn luyện được quản lý hoạt động theo quy trình huấn luyện thông thường. Trong suốt thời gian chạy, quá trình huấn luyện sử dụng các bản sao riêng của những ảnh đã ghim do Platform lưu giữ; thông tin xác thực Azure của bạn không bao giờ bị lộ cho workload huấn luyện.

Ngắt kết nối#

Ngắt kết nối sẽ xóa chuỗi kết nối đã lưu mà không tác động đến bất cứ thứ gì trong Azure. Dataset được tạo từ các container đó vẫn nằm trong workspace cùng với class, nhãn và chú thích, nhưng không thể tải, xem trước hoặc huấn luyện trên hình ảnh cho đến khi kết nối lại cùng tài khoản lưu trữ.

Sử dụng REST API với ID tích hợp được trả về bởi GET /api/integrations/buckets:

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")

Để thu hồi quyền truy cập trực tiếp tại nguồn, hãy xoay vòng access key của tài khoản lưu trữ trong Azure.

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

Dataset sử dụng Azure hiện không hỗ trợ các tính năng yêu cầu Platform lưu bản sao hình ảnh: tự động gắn nhãn, phân tích phân cụm, sao chép dataset và snapshot phiên bản bất biến.

Xóa dataset sử dụng Azure hoặc từng ảnh trong dataset chỉ xóa các tham chiếu của Platform — blob của bạn không bị tác động.

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

Câu hỏi thường gặp#