تكامل Azure Blob Storage#

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

الحصول على سلسلة الاتصال (Connection String)#

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

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

يجب أن يحمل النص AccountName و AccountKey وبروتوكول HTTPS كبروتوكول له - بالشكل الذي يمنحه لك Azure ضمن مفاتيح الوصول (Access keys). يتم رفض سلاسل الاتصال عبر رمز SAS، والتي تحتوي على SharedAccessSignature بدلاً من AccountKey.

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

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

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

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

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

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

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

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

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

إخفاقات الاستيراد#

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

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

التدريب#

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

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

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