יצירה והעלאה ידנית של טבלאות נתונים

בעזרת Migration Center אפשר להעלות טבלאות של נתונים שאתם ממלאים באופן ידני באמצעות התבניות שסופקו. האפשרות הזו שימושית אם יש לכם מספר מוגבל של נכסים בתשתית ואתם רוצים ליצור את הנתונים באופן ידני.

כדי ליצור ולהעלות טבלאות נתונים באופן ידני, פועלים לפי השלבים הבאים:

1. מורידים את התבניות מרשימת התבניות הזמינות.
2. ממלאים את הטבלאות באופן ידני עם הנתונים מהתשתית.
3. מעלים את הטבלאות ל-Migration Center.

מגבלות

• הגודל המקסימלי של קובץ להעלאה הוא 100MB.

תבניות נתונים זמינות

בטבלה הבאה מפורטות תבניות הקבצים שבהן אפשר להשתמש כדי להעלות את נתוני התשתית ל-Migration Center. התבניות מכילות נתונים לדוגמה, כדי להציע לכם איך למלא את הטבלה. תיאור מפורט של פורמט הנתונים הנדרש זמין במאמר בנושא מפרטים של קבצים לייבוא.

שם הקובץ	סוג הנתונים	תיאור
vmInfo.csv	פרטי המכשיר	אפשר להשתמש בתבנית הזו כדי לספק מידע על נכסים ספציפיים, כולל מעבד, זיכרון ופרמטרים אחרים של ההגדרה. צריך להשתמש בטבלה הזו בכל פעם שיוצרים ייבוא חדש.
perfInfo.csv	נתוני ביצועים	אופציונלי: אפשר להשתמש בתבנית הזו כדי לספק נתוני ביצועים של הנכסים בפורמט של סדרת זמנים.
diskInfo.csv	נתוני הדיסק	אופציונלי: אפשר להשתמש בתבנית הזו כדי לספק מידע על דיסקים ועל השימוש בהם.
tagInfo.csv	תגי מערכת	אופציונלי: אפשר להשתמש בתבנית הזו כדי להקצות מאפיינים של צמדי מפתח/ערך לנכסי Amazon Web Services ‏ (AWS). הפורמט של המאפיינים הוא "tag:KEY" : "VALUE". לדוגמה, "tag:Name" : "AWS-example".

מידע נוסף על המפרטים של כל קובץ זמין במאמר מפרטים של קבצים לייבוא.

העלאת הטבלאות

כדי להעלות את הקבצים:

המסוף

1. עוברים לדף ייבוא נתונים.

   מעבר אל ייבוא נתונים

2. לוחצים על הוספת נתונים > העלאת קבצים.

3. בקטע הגדרת העלאת קובץ, מזינים את השם של העלאת הקובץ.

4. ברשימה פורמט קובץ, בוחרים באפשרות תבניות CSV עם נתונים שהוזנו ידנית.

5. לוחצים על בחירת קבצים להעלאה ובוחרים את כל הקבצים שרוצים להעלות.

6. כדי לאשר ולהתחיל להעלות את הקבצים, לוחצים על העלאת קבצים.

7. אם הקבצים אומתו בצורה תקינה, כדי ליצור את הנכסים מהקבצים, לוחצים על ייבוא נתונים ואז על אישור.

API

1. יוצרים עבודת ייבוא.

   POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs?importJobId=IMPORT_JOB_ID
   
   {
     "asset_source": "projects/PROJECT_ID/locations/REGION/sources/SOURCE_ID"
   }
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PROJECT_ID: מזהה הפרויקט שבו רוצים ליצור את משימת הייבוא.
   • ‫REGION: האזור שבו רוצים ליצור את עבודת הייבוא.
   • ‫IMPORT_JOB_ID: המזהה של עבודת הייבוא החדשה.
   • ‫SOURCE_ID: המזהה של מקור קיים שאותו רוצים לשייך למשימת הייבוא.

2. אופציונלי: כדי לוודא שמשימת הייבוא נוצרה בצורה נכונה, צריך לקבל את משימת הייבוא.

   GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
   

3. יוצרים קובץ לייבוא נתונים שמצורף למשימת הייבוא.

   POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles?import_data_file_id=DATA_FILE_ID
   
   {
     "format": "IMPORT_JOB_FORMAT"
   }
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫DATA_FILE_ID: המזהה של קובץ הנתונים החדש
   • IMPORT_JOB_FORMAT: IMPORT_JOB_FORMAT_MANUAL_CSV

4. מורידים את קובץ הנתונים.

   GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles/DATA_FILE_ID
   

5. מעתיקים את כתובת ה-URL מהשדה signedUrl בתשובה.

6. מעלים קובץ לכתובת ה-URL שהועתקה.

   PUT -H 'Content-Type: application/octet-stream' --upload-file UPLOAD_FILE_PATH 'COPIED_URL'
   

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫UPLOAD_FILE_PATH: הנתיב המקומי של הקובץ שמועלה.
   • ‫COPIED_URL: כתובת ה-URL החתומה שהועתקה מהשלבים הקודמים.

7. אופציונלי: חוזרים על שלבים 3-6 כדי ליצור עוד קובצי נתונים באותו תהליך ייבוא.

8. אופציונלי: מקבלים את כל קובצי הנתונים של משימת ייבוא.

   GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID/importDataFiles
   

9. מאמתים את משימת הייבוא.

   POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:validate
   

10. מקבלים את עבודת הייבוא וצופים בדוח האימות. אם המצב הוא READY, אפשר להמשיך לשלבים הבאים. אם לא, צריך לתקן את המשימה או קבצים ספציפיים. יכול להיות שתצטרכו למחוק קבצים או להעלות קבצים חדשים.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
    

11. מריצים את משימת הייבוא.

    POST https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID:run
    

12. מקבלים את משימת הייבוא וצופים בדוח הביצוע. אם המצב הוא COMPLETED, סימן שהעבודה בוצעה בהצלחה. אחרת, אם העבודה נכשלה והיא במצב סופי, דוח הביצוע כולל את השגיאות. יוצרים משימת ייבוא חדשה ומחילים את השינויים הנדרשים.

    GET https://migrationcenter.googleapis.com/v1alpha1/projects/PROJECT_ID/locations/REGION/importJobs/IMPORT_JOB_ID
    

נתקלתם בבעיות בהעלאת הקובץ? כאן תוכלו לקרוא איך לפתור אותן.

בדיקת ההעלאה

אחרי שמעלים את הקבצים, Migration Center מאמת אותם כדי לבדוק אם הם תקינים מבחינה פורמלית. אם האימות מצליח, Migration Center מעבד את הנתונים כדי ליצור נכסים חדשים או לעדכן נכסים קיימים. אפשר לבדוק את הסטטוס של עבודות ההעלאה במסוף Google Cloud .

כדי לבדוק את הסטטוס של משימת ההעלאה:

1. נכנסים לדף Data import במסוף Google Cloud .

   מעבר אל ייבוא נתונים

2. בכרטיסייה File uploads (העלאות קבצים), ברשימת הייבוא של הקבצים, לוחצים על משימת הייבוא שרוצים לבדוק.

3. בודקים את הסטטוס של הקבצים שהועלו.

   הסטטוס של הקבצים יכול להיות אחד מהבאים:

   • הושלם. הייבוא של הקובץ שלך הצליח.
   • מוכן. הקובץ עבר אימות ומוכן לייבוא.
   • בהמתנה. הקובץ נמצא בהמתנה עד שעיבוד של קובץ אחר יסתיים.
   • ריצה. הקובץ שלך נמצא בתהליך עיבוד.
   • מתבצע אימות. הקובץ נמצא בשלב האימות.
   • האימות נכשל. הקובץ מכיל כמה שגיאות. צריך לתקן את השגיאות ואז לנסות להעלות את הקובץ שוב.
   • נכשל. לא הייתה אפשרות לייבא את הקובץ.

בדיקת פרטי השגיאה

אם נתקלתם בשגיאות אחרי ייבוא הקבצים, תוכלו לעיין בהודעת השגיאה ישירות במסוף Google Cloud .

כדי לבדוק את השגיאות של משימת ההעלאה:

1. נכנסים לדף Data import במסוף Google Cloud .

   מעבר אל ייבוא נתונים

2. בכרטיסייה העלאות קבצים, ברשימת ייבוא הקבצים, לוחצים על קובץ הייבוא שמוצגת לגביו אזהרה או שגיאה.

   בדף הפרטים של קובץ הייבוא מוצגת רשימה מלאה של השגיאות.

בדף הפרטים של קובץ הייבוא אפשר לבדוק את הנכסים ואת שדות הנתונים שגורמים לשגיאות, ולראות תיאור של השגיאה. שגיאות בתהליך ייבוא הקובץ עשויות למנוע מ-Migration Center ליצור נכסים חדשים או לעדכן נכסים קיימים בשינויים החדשים. כדי לתקן את השגיאה, צריך לערוך את הקבצים וליצור משימת ייבוא קבצים חדשה כדי להעלות אותם מחדש.

מידע נוסף על הודעות השגיאה האפשריות זמין במאמר פתרון בעיות שקשורות לייבוא קבצים.

מפרטים לייבוא קבצים

בטבלאות הבאות מפורטים המפרטים הטכניים של קובצי התבניות שמשמשים לייבוא ידני.

קובץ vmInfo

עמודה	הסוג הנדרש	תיאור
MachineId	מחרוזת	המזהה הייחודי של המכונה הווירטואלית.
MachineName	מחרוזת	השם המוצג של המכונה הווירטואלית.
PrimaryIPAddress	מחרוזת	כתובת ה-IP של המכונה.
PrimaryMACAddress	מחרוזת	כתובת ה-MAC של המחשב. הוא משמש רק לזיהוי המכונה.
PublicIPAddress	מחרוזת	כתובת ה-IP הציבורית של המכונה.
IpAddressListSemiColonDelimited	רשימת ההודעות	רשימת כתובות הרשת שהוקצו או שויכו.
TotalDiskAllocatedGiB	int64	הקיבולת הכוללת של הדיסק.
TotalDiskUsedGiB	int64	הכמות הכוללת של השטח בשימוש בדיסק.
MachineTypeLabel	מחרוזת	תווית סוג המכונה של AWS או Azure.
AllocatedProcessorCoreCount	int64	מספר ליבות המעבד (CPU) במכונה הווירטואלית.
MemoryGiB	int32	נפח הזיכרון של המכונה הווירטואלית.
HostingLocation	מחרוזת	המיקום של המכונה בפורמט AWS או Azure.
OsType	מחרוזת	מערכת ההפעלה של המכונה.
OsName	מחרוזת	מערכת ההפעלה של המכונה.
OsVersion	מחרוזת	גרסת מערכת ההפעלה של המכונה.
MachineStatus	מחרוזת	מצב ההפעלה של המכונה.
ProvisioningState	מחרוזת	מצב ההקצאה, רק למכונות וירטואליות של Azure.
CreateDate	חותמת הזמן	חותמת הזמן של יצירת המכונה.
IsPhysical	מחרוזת	אם המכונה היא פיזית או וירטואלית.
מקור	הודעה	פרטי המקור של מכונות AWS או Azure.

קובץ diskInfo

עמודה	הסוג הנדרש	תיאור
MachineId	מחרוזת	המזהה הייחודי של המכונה הווירטואלית.
DiskLabel	מחרוזת	התווית של הדיסק.
SizeInGib	int64	הקיבולת הכוללת של הדיסק.
UsedInGib	int64	הכמות הכוללת של השטח בשימוש בדיסק.
StorageTypeLabel	מחרוזת	סוג התווית של הדיסק (לדוגמה, BIOS או GPT).

קובץ perfInfo

עמודה	הסוג הנדרש	תיאור
MachineId	מחרוזת	המזהה הייחודי של המכונה הווירטואלית.
TimeStamp		חותמת הזמן שבה הדגימה נאספה.
CpuUtilizationPercentage	מספר ממשי (float)	אחוז הניצול של קיבולת המעבד הכוללת. הערך חייב להיות בטווח 0-100.
MemoryUtilizationPercentage	מספר ממשי (float)	אחוז זיכרון המערכת בשימוש. הערך חייב להיות בטווח 0-100.
UtilizedMemoryBytes	מספר ממשי (float)	סך הזיכרון שבו נעשה שימוש בבייטים.
DiskReadOperationsPerSec	מספר ממשי (float)	הערך הממוצע של IOPS שנדגם בחלון קצר.
DiskWriteOperationsPerSec	מספר ממשי (float)	הערך הממוצע של IOPS שנדגם בחלון קצר.
NetworkBytesPerSecSent	מספר ממשי (float)	תעבורת הנתונים היוצאת הממוצעת מהרשת בבייט לשנייה, שנדגמה בחלון קצר.
NetworkBytesPerSecReceived	מספר ממשי (float)	התעבורה הממוצעת שנכנסת לרשת בבייט לשנייה, שנדגמת בחלון קצר.

קובץ tagInfo

עמודה	הסוג הנדרש	תיאור
מפתח	מחרוזת	מפתח המאפיין.
ערך	מחרוזת	ערך המאפיין.

המאמרים הבאים

• מידע נוסף על שיטות האיסוף של Migration Center
• איך מנהלים את העלאות הקבצים