استخدام خادم 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": "google.offer",
  "data_file": [
    "offers_1524606581_1.json",
    "offers_1524606581_2.json"
  ]
}

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

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

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

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

• مثال: offers_1524606581_1.json

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

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

تحديد المشاكل وحلّها

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

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

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