تكامل Azure Blob Storage#

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

الحصول على سلسلة اتصال#

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

1. في مدخل Azure، افتح حساب التخزين.
2. انتقل إلى Security + networking > Access keys.
3. انسخ سلسلة اتصال.

يجب أن تتضمن السلسلة AccountName وAccountKey وأن تستخدم HTTPS بروتوكولًا لها — وهو التنسيق الذي يقدمه Azure ضمن Access keys. تُرفض سلاسل الاتصال التي تستخدم رموز SAS، والتي تتضمن SharedAccessSignature بدلًا من AccountKey.

الاتصال بـ Platform#

1. انتقل إلى Settings > Integrations واختر Azure Blob Storage من قائمة عمليات التكامل.
2. ألصق سلسلة الاتصال.
3. انقر على Find available containers، ثم اختر الحاويات المراد توصيلها. يمكنك أيضًا إدخال اسم حاوية يدويًا.
4. انقر على Connect. تتحقق المنصة من إمكانية إدراج كل حاوية محددة وقراءتها قبل حفظ أي شيء.

يلزم أن يكون لديك دور مسؤول مساحة العمل أو مالكها لتوصيل التخزين السحابي. يمكن للاتصال الواحد أن يضم ما يصل إلى 50 حاوية، ويعرض الاستكشاف ما يصل إلى 300 حاوية في حساب التخزين.

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

إنشاء مجموعة بيانات من حاوية ثنائية#

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

تسرد Platform محتويات المجلد مرة واحدة وتفهرس ما تجده:

• الصور — تُفهرس الحاويات الثنائية .jpg و.jpeg و.png و.webp و.avif، مع قراءة الأبعاد عبر طلبات محدودة. لا تحتفظ المنصة بنسخة ثانية من الصورة المصدر.
• التسميات — تُحلل الملفات الجانبية بتنسيق YOLO .txt إلى تعليقات توضيحية في Platform، وتُطابق وفق بنية images/ → labels/ القياسية أو باعتبارها ملفات شقيقة في المجلد نفسه.
• البيانات الوصفية — يوفر ملف YAML أسماء الفئات وبنية نقاط مفتاح الوضعية، تمامًا كما في تحميل أرشيف. ويُفضّل استخدام data.yaml وdata.yml عندما يحتوي المجلد على عدة ملفات.
• المهمة — تحدد عينة من ملفات التسميات المهمة، لذا تُعرَف مجلدات التقسيم والوضعية وOBB من بنية تسمياتها بدلًا من المهمة التي اخترتها في مربع الحوار.
• التقسيمات — تعيّن أسماء المجلدات train وval وtest في مسار الحاوية الثنائية التقسيمات تلقائيًا.

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

عمليات الاستيراد الفاشلة#

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

تعيد محاولة الاستيراد تعداد محتويات المجلد بدلًا من استئناف العمل؛ فتُضاف الحاويات الثنائية التي أُضيفت منذ المحاولة الأولى، وتُزال من مجموعة البيانات الحاويات الثنائية التي لم تعد موجودة.

التدريب#

يعمل التدريب المُدار من خلال تدفق التدريب المعتاد. يستخدم التدريب نسخ المنصة الخاصة من الصور المثبتة طوال مدة التشغيل، ولا تُكشف بيانات اعتماد Azure لأحمال التدريب مطلقًا.

قطع الاتصال#

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

استخدم REST API مع معرّف التكامل الذي تعيده 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")

لإلغاء الوصول من المصدر بدلًا من ذلك، غيّر مفاتيح الوصول إلى حساب التخزين في Azure.

القيود الحالية#

تستبعد مجموعات البيانات المدعومة من Azure حاليًا الميزات التي تتطلب أن تحتفظ المنصة بنسخ من صورك: إضافة التعليقات التوضيحية تلقائيًا، وتحليل التجميع، واستنساخ مجموعات البيانات، ولقطات الإصدارات غير القابلة للتغيير.

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

اطّلع أيضًا على عمليات تكامل Google Cloud Storage وAmazon S3.

الأسئلة الشائعة#