من Milvus 2.3.x

يوفر هذا الدليل عملية شاملة ومفصلة خطوة بخطوة لترحيل البيانات من Milvus 2.3.x إلى Milvus 2.3.x أو أعلى.

المتطلبات الأساسية

• إصدارات البرنامج:
  • المصدر Milvus المصدر: 2.3.0+ (تستخدم الأداة أداة التحويل لجلب بيانات المجموعة المصدرية، مما يتطلب أن يكون الإصدار 2.3.0 أو أعلى من الإصدار 2.3.0).
  • ميلفوس الهدف: 2.3.0+
• الأدوات المطلوبة:
  • أداةMilvus-migration. للحصول على تفاصيل التثبيت، راجع تثبيت أداة الترحيل.
• إعداد البيانات:
  • تأكد من تحميل مجموعة Milvus المصدر وجاهزة لتصدير البيانات.
  • إذا كان الميلفوس الهدف لا يحتوي على مجموعة مطابقة للمجموعة المصدر، ستقوم أداة الترحيل Milvus-migration بإنشائها تلقائيًا. لاحظ أنه بعد الترحيل، لن تتم فهرسة المجموعة الهدف، ويجب عليك فهرسة المجموعة يدويًا بعد ذلك.

تكوين ملف الترحيل

احفظ مثال ملف تهيئة الترحيل بصيغة migration.yaml وقم بتعديل التكوينات بناءً على ظروفك الفعلية. لك الحرية في وضع ملف التكوين في أي دليل محلي.

dumper:
  worker:
    workMode: milvus2x
    reader:
      bufferSize: 500

meta:
mode: config
version: 2.3.0
collection: src_table_name

source:
milvus2x:
endpoint: {milvus2x_domain}:{milvus2x_port}
username: xxxx
password: xxxxx

target:
milvus2x:
endpoint: {milvus2x_domain}:{milvus2x_port}
username: xxxx
password: xxxxx

يصف الجدول التالي المعلمات في ملف التكوين النموذجي. لمزيد من المعلومات، ارجع إلى Milvus Migration: Milvus2.x إلى Milvus2.x.

• dumper

  المعلمة	الوصف
  dumper.worker.workMode	الوضع التشغيلي لمهمة الترحيل. تعيين إلى milvus2x عند الترحيل من Milvus 2.x.
  dumper.worker.reader.bufferSize	حجم المخزن المؤقت للقراءة من Milvus 2.x في كل دفعة.

• meta

  المعلمة	الوصف
  meta.mode	تحديد مكان قراءة ملف التعريف. تعيين إلى تكوين، للإشارة إلى إمكانية الحصول على تكوين التعريف من ملف migration.yaml هذا.
  meta.version	مصدر إصدار ملف Milvus. تعيين إلى 2.3.0 أو أعلى.
  meta.collection	اسم مجموعة المصدر.

• source

  المعلمة	الوصف
  source.milvus2x.endpoint	عنوان مصدر خادم ملفوس المصدر.
  source.milvus2x.username	اسم المستخدم لخادم Milvus المصدر. هذه المعلمة مطلوبة إذا تم تمكين مصادقة المستخدم لخادم Milvus الخاص بك. لمزيد من المعلومات، راجع تمكين المصادقة.
  source.milvus2x.password	كلمة المرور لخادم Milvus المصدر. هذه المعلمة مطلوبة إذا تم تمكين مصادقة المستخدم لخادم Milvus الخاص بك. لمزيد من المعلومات، راجع تمكين المصادقة.

• target

  المعلمة	الوصف
  target.milvus2x.endpoint	عنوان خادم Milvus الهدف.
  target.milvus2x.username	اسم المستخدم لخادم Milvus الهدف. هذه المعلمة مطلوبة إذا تم تمكين مصادقة المستخدم لخادم Milvus الخاص بك. لمزيد من المعلومات، راجع تمكين المصادقة.
  target.milvus2x.password	كلمة المرور لخادم Milvus الهدف. هذه المعلمة مطلوبة إذا تم تمكين مصادقة المستخدم لخادم Milvus الخاص بك. لمزيد من المعلومات، راجع تمكين المصادقة.

بدء مهمة الترحيل

لديك خياران لبدء مهمة الترحيل - باستخدام CLI أو تقديم طلبات واجهة برمجة التطبيقات. اختر الخيار الذي يناسب احتياجاتك.

الخيار 1: استخدام CLI

ابدأ مهمة الترحيل باستخدام الأمر التالي. استبدل {YourConfigFilePath} بالدليل المحلي حيث يوجد ملف التهيئة migration.yaml.

./milvus-migration start --config=/{YourConfigFilePath}/migration.yaml

راقب السجلات للحصول على تحديثات التقدم. يجب أن تتضمن سجلات الترحيل الناجحة إدخالات مثل:

[INFO] [migration/milvus2x_starter.go:79] ["=================>JobProcess!"] [Percent=100]
[INFO] [migration/milvus2x_starter.go:27] ["[Starter] migration Milvus2x to Milvus2x finish!!!"] [Cost=94.877717375]
[INFO] [starter/starter.go:109] ["[Starter] Migration Success!"] [Cost=94.878243583]

الخيار 2: إجراء طلبات واجهة برمجة التطبيقات

يمكنك أيضًا استخدام واجهة برمجة التطبيقات (Restful API) لتنفيذ الترحيل. ابدأ تشغيل خادم واجهة برمجة التطبيقات باستخدام:

./milvus-migration server run -p 8080

بمجرد بدء تشغيل الخادم بنجاح، ضع الملف migration.yaml في الدليل configs/ للمشروع وابدأ الترحيل باستخدام:

curl -XPOST http://localhost:8080/api/v1/start

تحقق من النتيجة

بعد اكتمال مهمة الترحيل، استخدم Attu لعرض عدد الكيانات التي تم ترحيلها. بالإضافة إلى ذلك، يمكنك إنشاء فهارس وتحميل المجموعات في Attu. لمزيد من المعلومات، راجع Attu و get_collection_stats().

خيارات التكوين الإضافية

بالإضافة إلى التكوينات الأساسية المذكورة أعلاه، يمكنك أيضًا إضافة إعدادات إضافية بناءً على متطلباتك الخاصة.

• ترحيل الحقل الانتقائي: إذا كنت بحاجة إلى ترحيل حقول محددة فقط في مجموعة ما بدلاً من جميع الحقول، فحدد الحقول المراد ترحيلها في القسم meta من الملف migration.yaml.

  meta:
    fields:
      - name: id
      - name: title_vector
      - name: reading_time
  

• المجموعة المستهدفة المخصصة: لتخصيص خصائص المجموعة الهدف، أضف التكوينات ذات الصلة في القسم meta من الملف migration.yaml.

  meta:
    milvus:
      collection: target_collection_name
      shardNum: 2
      closeDynamicField: false
      consistencyLevel: Customized
  

للحصول على معلومات مفصلة، راجع ترحيل Milvus: Milvus2.x إلى Milvus2.x.