Link to this sectionتكامل Azure Blob Storage#

يربط تكامل Azure Blob Storage حاويات حساب التخزين الخاصة بك بـ Ultralytics Platform. تظل صورك في حاوياتك — حيث تقوم المنصة بفهرستها في مكانها، مما يتيح لك تصفح صورك، وتسميتها، وتدريب نماذج YOLO دون الحاجة إلى تحميل نسخة منها.

ميزة Pro

تتطلب مجموعات بيانات Azure Blob Storage خطة Pro أو Enterprise. يمكن لمساحات العمل المجانية رؤية التكامل ولكن ستظهر لها مطالبة بالترقية عند الاتصال. تظل مجموعات بيانات Azure Blob Storage الحالية قابلة للوصول بالكامل إذا انتهى الاشتراك — فقط الاتصالات وعمليات الاستيراد الجديدة هي التي تتطلب خطة Pro.

Link to this sectionالحصول على سلسلة الاتصال (Connection String)#

لا تقوم المنصة إلا بالقراءة من مساحة التخزين الخاصة بك — فهي لا تقوم أبداً بالكتابة، أو التعديل، أو حذف الـ blobs الخاصة بك. يتطلب التكامل الحالي سلسلة اتصال بمفتاح وصول للحساب، والتي تمنح امتيازات على مستوى الحساب بالكامل على الرغم من أن المنصة تستخدم عمليات القائمة (list) والقراءة (read) فقط:

1. في بوابة Azure، افتح حساب التخزين الخاص بك.
2. اذهب إلى الأمان + الشبكات > مفاتيح الوصول (Security + networking > Access keys).
3. انسخ سلسلة الاتصال (connection string).

سحابة Azure العامة فقط

تستخدم الاتصالات نقطة النهاية القياسية blob.core.windows.net. السحب السيادية (Azure China و Azure Government) ونقاط نهاية الـ blob المخصصة غير مدعومة.

Link to this sectionالاتصال بالمنصة#

1. اذهب إلى الإعدادات > التكاملات وابحث عن بطاقة Microsoft Azure.
2. انقر على اتصال (Connect) والصق سلسلة الاتصال.
3. تسرد المنصة الحاويات الموجودة في حساب التخزين. حدد الحاويات التي تريد توصيلها، أو أدخل اسم حاوية يدوياً.
4. انقر على اتصال (Connect). تتحقق المنصة من قدرتها على سرد وقراءة كل حاوية محددة قبل حفظ أي شيء.

تؤدي إعادة توصيل نفس حساب التخزين لاحقاً إلى إضافة حاويات جديدة إلى التكامل الحالي. يتم استبدال بيانات الاعتماد المحفوظة فقط عندما يتم التأكد من أن البديل لا يزال قادراً على قراءة كل حاوية قمت بتوصيلها بالفعل.

أمان بيانات الاعتماد

يمكن لمفتاح الحساب تخويل عمليات الكتابة والحذف أو إنشاء رموز SAS إذا تم كشفه خارج المنصة. يتم تشفير بيانات الاعتماد في حالة السكون باستخدام AES-256-GCM، ولا يتم إرجاعها مطلقاً إلى المتصفح، ولا تدخل مطلقاً في حمولات مهام التدريب. استخدم حساب تخزين مخصص حيثما كان ذلك عملياً. لإلغاء الوصول، قم بتدوير مفاتيح الوصول لحساب التخزين في Azure.

Link to this sectionإنشاء مجموعة بيانات من حاوية blob#

1. انقر فوق New Dataset وافتح علامة التبويب Cloud storage.
2. اختر حاوية متصلة وتصفح للوصول إلى المجلد الذي يحتوي على بياناتك.
3. أكد المجلد، واضبط اسم مجموعة البيانات، وأنشئ مجموعة البيانات.

تدرج المنصة المجلد مرة واحدة وتفهرس ما تجده:

• الصور — تتم فهرسة الـ blobs من أنواع .jpg و .jpeg و .png و .webp و .avif مع قراءة الأبعاد من طلبات الترويسة المحدودة. لا يتم نسخ وحدات البكسل المصدرية أبداً من حاويتك.
• Labels — يتم تحليل ملفات YOLO الجانبية بتنسيق .txt إلى تعليقات توضيحية (annotations) في المنصة، ويتم مطابقتها حسب التخطيط القياسي images/ → labels/ أو كملفات مصاحبة في المجلد نفسه.
• Metadata — يوفر ملف data.yaml/data.yml أسماء الفئات، ونوع المهمة، وشكل النقاط الرئيسية (keypoint shape)، تماماً مثل تحميل الأرشيف.
• التقسيمات (Splits) — تقوم أسماء المجلدات train و val و test في مسار الـ blob بتعيين التقسيمات تلقائياً.

تعمل مجموعة البيانات بعد ذلك مثل أي مجموعة أخرى: يمكنك تصفحها وتسميتها، وتعيينها كعامة أو خاصة، ومشاركتها مع فريقك، والتدريب عليها من خلال التدريب المُدار. يتم بث النسخ الأصلية عند الطلب، ولا تستهلك الصور المفهرسة حصة التخزين الخاصة بك على المنصة.

القيود

يقوم الاستيراد الواحد بفهرسة ما يصل إلى 50,000 blob، وملفات التسميات أو YAML يصل حجم كل منها إلى 1 ميجابايت. يجب تقسيم الحاويات الأكبر عبر مجموعات بيانات متعددة.

الحفاظ على الـ blobs المفهرسة غير قابلة للتغيير (immutable)

يتم تثبيت كل صورة مفهرسة بـ ETag الخاص بـ blob الخاص بها، وتفشل المنصة في حالة تغير الـ blob تحتها. أضف blobs جديدة بدلاً من الكتابة فوق الموجودة حالياً.

Link to this sectionإخفاقات الاستيراد#

إذا فشل الاستيراد — بسبب مجلد فارغ، أو خطأ مطبعي في المسار، أو أذونات ملغاة — تظهر مجموعة البيانات الخطأ في صفحتها. يمكن للمحررين النقر على إعادة محاولة الاستيراد (Retry import) لإعادة تشغيله باستخدام الحاوية والمجلد المخزنين، أو إنشاء مجموعة بيانات جديدة تشير إلى المسار المصحح.

Link to this sectionالتدريب#

يعمل التدريب المُدار من خلال تدفق التدريب العادي. يقوم العمال بتنزيل النسخ الأصلية المثبتة في تخزين مؤقت للوظيفة من أجل التشغيل، ثم إزالتها عند تنظيف الوظيفة — بيانات اعتماد Azure الخاصة بك لا تصل أبداً إلى مساحة الحوسبة.

Link to this sectionالقيود الحالية#

تستبعد مجموعات البيانات المدعومة بـ Azure حالياً الميزات التي تتطلب نسخاً مملوكة للمنصة من صورك: التسمية التلقائية (auto-annotation)، تحليل التجميع، استنساخ مجموعات البيانات، ولقطات الإصدارات غير القابلة للتغيير.

حذف مجموعة بيانات مدعومة بـ Azure، أو صور فردية منها، يزيل مراجع المنصة فقط — لا يتم لمس الـ blobs الخاصة بك أبداً.

راجع أيضاً تكاملات Google Cloud Storage و Amazon S3.