استخدام خادم SFTP العام

يسمح خادم بروتوكول النقل الآمن للملفات (SFTP) للخلاصة العامة بتحميل أنواع خلاصات متعددة إلى خادم SFTP واحد لكل بيئة. سيشرح هذا الدليل كيفية استخدام خادم SFTP العام وسيقدّم روابط إلى الدليل المناسب للخلاصة المعنيّة التي تخطّط لاستخدامها.

يعتمد خادم SFTP العام على وجود عمليتَي تحميل منفصلتَين:

1. ملف الوصف: يصف نوع الخلاصة التي سيتم تحميلها
2. ملفات الخلاصة: محتوى الخلاصة الفعلية

تنظيم حقل الوصف

يتم تحميل ملف الوصف لإعلام نظامنا بنوع الخلاصة التي تحمّلها. يتيح لنا ذلك التحقّق من صحة الخلاصة ومعالجتها بشكل صحيح. يجب تحميل ملف الوصف قبل محتوى الخلاصة، ويجب أن يستوفي متطلبات التسمية التالية:

• يجب استخدام امتداد الملف .filesetdesc.json لملف الوصف.
• يجب أن يكون اسم ملف كل وصف فريدًا ولا يمكن إعادة استخدامه في عمليات التحميل المختلفة. ننصح بتضمين الطابع الزمني لإنشاء الخلاصة واسم الخلاصة في اسم الملف.
  • مثال: offers_1524606581.filesetdesc.json
• يجب أن يسرد كل ملف وصفي جميع ملفات البيانات في آخر خلاصة لاسم الخلاصة ذي الصلة.

message FilesetDescriptor {
  // The timestamp at which this feed was generated, in Unix time format
  // (seconds since the epoch). (required)
  int64 generation_timestamp = 1;

  // Identifies the name of this feed. (required)
  string name = 2;

  // Paths (relative to the dropbox root) specifying data files included in this
  // feed. (required)
  repeated string data_file = 3;
}

تشمل القيم المحتمَلة للحقل name ما يلي:

في ما يلي مثال على ملف وصفي بتنسيق JSON لخلاصة عروض تتضمّن شذرتَين:

{
  "generation_timestamp": 1524606581,
  "name": "promote.offer",
  "data_file": [
    "offers_1524606581_1.json",
    "offers_1524606581_2.json"
  ]
}

تنظيم محتوى الخلاصة

بعد تحميل ملف الوصف، عليك تحميل جميع ملفات الخلاصة لنوع بيانات الخلاصة المطابق لملف إعدادات الخلاصة الذي يحمل اسمًا من تحديد ملف الوصف. يجب أن تتطابق أسماء الملفات ومواقع المسارات (النسبية ضمن خادم SFTP) تمامًا مع ما تم تضمينه في الحقل data_file. إذا كان أي ملف غير متوفّر أو يحمل اسمًا غير صحيح أو تم تحميله إلى موقع مختلف، لن تتم معالجة الخلاصة بأكملها.

يجب أن تتوافق محتويات ملفات بيانات الخلاصة هذه مع المواصفات ذات الصلة بالخلاصة التي تم تحديدها في ملف الوصف.

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

• مثال: offers_1524606581_1.json

أحجام ملفات الخلاصة ومعدّل تكرار التحميل

• يجب أن يكون حجم ملف الخلاصة أقل من 200 ميغابايت (بعد الضغط).
• يجب ألا يزيد حجم كل ملف بيانات غير مضغوط عن 2 غيغابايت.
• لن تحتاج معظم عمليات الدمج إلى استخدام شريحة واحدة فقط. يجب استخدام أقل عدد ممكن من الشرائح. يمكن إنشاء 1,000 شريحة كحد أقصى لكل خلاصة.
• لا يلزم إرسال السجلّات الفردية المُرسَلة في شريحة واحدة باستخدام رقم الشريحة نفسه في الخلاصات المستقبلية.
• للحصول على أداء أفضل، قسِّم البيانات بالتساوي بين الأجزاء، لجعل حجم كل ملف من أجزاء البيانات متشابهًا.
• استخدِم gzip لضغط الخلاصات إذا لزم الأمر. ومع ذلك، عليك إجراء ذلك لكل جزء من الخلاصة.

تحديد المشاكل وحلّها وتصحيح الأخطاء

بعد تحميل ملفاتك (ملفّا الوصف والخلاصة)، انتقِل إلى لوحة بيانات سجلّ الخلاصات (المستندات) في "بوابة الشركاء" (انتقِل إلى السجلّ > الخلاصات) لمتابعة مستوى تقدّم نقل الخلاصة.

ابحث عن name الذي أدخلته في ملف الوصف في عمود "اسم الخلاصة" للعثور على خلاصتك.

بعد نقل الخلاصة (عندما تكون الحالة Success أو Fail)، يمكنك النقر على صفها للاطّلاع على تفاصيل الأخطاء والتحذيرات.