تكامل Azure Blob Storage#

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

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

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

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

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

الاتصال بالمنصة#

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

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

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

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

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

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

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

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

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

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

تعيد المحاولة إدراج محتويات المجلد بدلًا من الاستئناف: فتُلتقط كائنات blob المضافة منذ المحاولة الأولى، وتُزال من مجموعة البيانات الكائنات التي لم تعد موجودة.

التدريب#

يعمل التدريب المُدار من خلال سير عمل التدريب المعتاد. يستخدم التدريب نسخ Platform الخاصة من الصور المثبتة طوال مدة التشغيل، ولا تُكشف بيانات اعتماد 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 حاليًا الميزات التي تتطلب نسخ Platform الخاصة من صورك: التعليق التوضيحي التلقائي، وتحليل التجميع، واستنساخ مجموعة البيانات، ولقطات الإصدار غير القابلة للتغيير.

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

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

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