חשבון הפיד הכללי מאפשר להעלות כמה סוגי פידים תיקייה אחת בענן לכל סביבה. המדריך הזה מסביר איך להשתמש חשבון בענן כללי ולספק קישורים למדריך המתאים עבור שבו אתם מתכננים להשתמש.
(עיינו במאמר ייצוא פידים (מקצה לקצה) או פידים (התחלה) בתיעוד).התיקייה הכללית בענן מסתמכת על שתי העלאות נפרדות:
- קובץ תיאור: תיאור סוג הפיד שאתם רוצים ליצור ההעלאה מתבצעת...
- קובצי פיד: התוכן של הפיד עצמו.
מבנה שדה התיאור
קובץ התיאור מועלה כדי ליידע את המערכת שלנו לגבי סוג הפיד עולות. כך אנחנו יכולים לאמת ולעבד את הפיד כמו שצריך. צריך להעלות את קובץ התיאור לפני תוכן הפיד, והוא חייב לעמוד בדרישות הבאות: הדרישות הבאות למתן שמות:
- שימוש בסיומת הקובץ .filesetconv.json
- כל שם של קובץ מתאר צריך להיות ייחודי, ואי אפשר לעשות בו שימוש חוזר בהעלאות. רביעי
מומלץ לכלול את חותמת הזמן של היצירה בשם הקובץ.
- דוגמה: offer_1524606581.filesetconv.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"
]
}
המבנה של תוכן הפיד
אחרי שמעלים את קובץ התיאור, צריך להעלות את כל קובצי הפיד
לסוג נתוני הפיד שתואם לקובץ תצורת הפיד שנקרא
את קובץ המתאר. שמות הקבצים ומיקומי הנתיבים (יחסיים בתוך השדה
החשבון בענן) חייב להתאים בדיוק למה שנכלל
שדה data_file. אם חסר קובץ, קיבל שם שגוי, או
מועלה למיקום אחר, אז לא ניתן להעלות את כל הפיד
עבר עיבוד.
התוכן של קובצי נתוני הפיד האלה חייב להיות תואם למפרט הרלוונטי של הפיד שצוין בקובץ התיאור.
כל שם קובץ של פיד צריך להיות ייחודי ואי אפשר לעשות בו שימוש חוזר בהעלאות. ההמלצות שלנו כולל חותמת הזמן של הגנרציה והמספר המפוצל (מזהה מצטבר) בשם הקובץ.
- דוגמה: Offers_1524606581_1.json
גודל קובצי הפיד ותדירות ההעלאה
- קובץ הפיד צריך להיות קטן מ-200MB (לאחר דחיסה).
- ברוב השילובים צריך להשתמש רק בפיצול אחד. צריך להשתמש בתור כמה פיצולים שאפשר. ניתן ליצור עד 1,000 פיצולים לכל פיד.
- אין צורך לשלוח רשומות נפרדות שנשלחות בפיצול אחד באותו מספר המפוצל בפידים עתידיים.
- לקבלת ביצועים טובים יותר, פצל את הנתונים באופן שווה בין המפוצלים, של הקבצים המפוצלים בגודל דומה.
- אם יש צורך, אפשר להשתמש ב-gzip כדי לדחוס פידים. אבל יש לעשות זאת עבור כל של פיד אחד.
פתרון בעיות וניפוי באגים
אחרי שמעלים את הקבצים (קובצי תיאור וקובצי פיד), עוברים אל מרכז הבקרה של היסטוריית הפידים (מסמכי התיעוד) בפורטל השותפים (עוברים אל היסטוריה > פידים) כדי לעקוב אחר התקדמות הטמעת הפיד.
מחפשים את הערך name שהוזן בקובץ התיאור בשדה 'שם הפיד'. כדי למצוא את הפיד.
אחרי הטמעת הפיד (הסטטוס הוא Success או Fail), אפשר ללחוץ על
בשורה שלו כדי לראות את פרטי השגיאות והאזהרות.