פתרון בעיות בייבוא של מילון המונחים הארגוני וקישורי רשומות

ב-Knowledge Catalog (לשעבר Dataplex Universal Catalog) אתם יכולים לייבא ולייצא בכמות גדולה מילוני מונחים ארגוניים וקישורים לרשומות, כדי לנהל את אוצר המילים של העסק בקנה מידה נרחב. כשמריצים את הסקריפטים של כלי הייבוא או הייצוא, אפשר לאבחן ולפתור בעיות נפוצות כמו קישורים חסרים לערכים, ייצוא של מילוני מונחים ריקים, כתובות URL לא חוקיות של מילוני מונחים או גיליונות אלקטרוניים, משימות ייבוא שהופסקו וזמן קצוב לתפוגה של רשת הסקריפטים. מידע נוסף זמין במאמר ייבוא וייצוא של מילוני מונחים וקישורים לערכים.

אם אתם צריכים עזרה בפתרון בעיה שלא מופיעה במאמר הזה, תוכלו להיעזר ב-Cloud Customer Care.

תיקון קישורים חסרים לרשומות ב-Knowledge Catalog

אחרי שמייצאים קישורים לרשומות מ-Knowledge Catalog לגיליון אלקטרוני ב-Google Sheets באמצעות כלי השירות לייצוא קישורים לרשומות, שמים לב שחלק מהקישורים לרשומות (השיוכים) חסרים בגיליון האלקטרוני שנוצר ב-Google Sheets.

הבעיה הזו מתרחשת אם כלי הייצוא מדלג באופן אוטומטי על קישורים לרשומות בגלל התנאים הבאים:

• הרשאות לא מספיקות (משאבים מצונזרים): אין לכם את הרשאות ה-IAM הנדרשות כדי לראות את רשומת המקור או את רשומת היעד שמשויכות לקישור.

• סוג קישור לא חוקי לרשומה: הקישור לרשומה משתמש בסוג קשר לא נתמך או לא מזוהה. הסוגים התקינים מוגבלים ל-definition,‏ related ו-synonym.

• הפניות לא שלמות לרשומות: במטא-נתונים של הרשומה חסרים שדות סכימה נדרשים, ולכן בדיקת האימות מדלגת על המשאב.

כדי לפתור את הבעיה, מבצעים את הבדיקות הבאות:

• בדיקת ההרשאות: ודאו שיש לכם הרשאות לצפות בקישורים החסרים. מוודאים שחשבון המשתמש שמריץ את הסקריפט קיבל את התפקידים הנדרשים.

• בודקים את יומני הביצוע: בודקים אם יש ביומני הטרמינל או הסקריפט אזהרות שמכילות את הערך Skipping redacted entrylink. ביומנים מוצגים מזהי המשאבים הספציפיים של הקישורים לרשומות שהמערכת דילגה עליהם, והסיבה להשמטה שלהם.

• בודקים את תקינות הסכימה של הקישורים: אם שיניתם בעבר את הקישורים האלה באופן פרוגרמטי, ודאו שהמאפיינים שלהם תואמים לדרישות הסכימה.

שגיאה: לא נמצאו מונחים במילון המונחים

כשמייצאים מילוני מונחים לגיליון אלקטרוני ב-Google Sheets, הפעולה נכשלת או מחזירה תוצאה ריקה עם ההודעה No terms found in the glossary, למרות שמילון המונחים הארגוני מכיל מונחים פעילים.

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

• כתובת URL שגויה של מילון המונחים: כתובת ה-URL של מילון המונחים שהוגדרה בפרמטרים של ההפעלה שגויה או מאויתת באופן שגוי.
• הרשאות IAM לא מספיקות: לחשבון השירות המאומת או לפרטי הכניסה של המשתמש שמריץ את הסקריפט אין הרשאה להציג או לפרט מונחים במילון המונחים המטורגט.
• מזהה מילון המונחים לא תואם: מזהה מילון המונחים שצוין בפקודת הסקריפט לא תואם למזהה המשאב של מילון המונחים בפועל ב-Knowledge Catalog.

כדי לפתור את הבעיה, צריך לבדוק את ההגדרות וההרשאות:

• בודקים את מזהה מילון המונחים: במסוף Google Cloud , נכנסים לדף Glossaries ב-Knowledge Catalog, בוחרים את מילון המונחים ומוודאים שמזהה המשאב תואם למזהה שאתם מעבירים לסקריפט של כלי השירות.

• אימות הרשאות IAM: מוודאים שלפרטי הכניסה המאומתים (חשבון השירות או חשבון המשתמש שאליו אתם מתחזים) הוקצו התפקידים הנדרשים.

• מאמתים את מבנה כתובת ה-URL של מילון המונחים: אם מעבירים נתיב משאב ישיר או כתובת URL לסקריפט, צריך לוודא שהם תואמים לפורמט המשאב הנכון של Knowledge Catalog:

  projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID

אזהרה: הרשומות לא נמצאו ב-Knowledge Catalog

במהלך פעולת ייבוא של קישור כניסה, הסקריפט מושהה ומוצגת אזהרה דומה לזו:

Found X entries not found in Knowledge Catalog. EntryLinks associated with
these entries will be skipped. Continue with import? [y/N]:

הבעיה הזו מתרחשת אם הגיליון האלקטרוני ב-Google Sheets מכיל קישורים לרשומות שמפנים לנכסי נתונים או למונחים במילון שלא קיימים ב-Knowledge Catalog.

כדי לפתור את הבעיה, אפשר לבחור באחת מהאפשרויות הבאות:

• כדי להמשיך בייבוא חלקי, מקלידים y בהודעה. הכלי מייבא את כל הקישורים התקינים לרשומות, ומדלג רק על הקישורים שמפנים למשאבים החסרים.

• כדי לבטל ולתקן את המשאבים החסרים, מקלידים n כדי לבטל את הביצוע. מוודאים שמזהי הרשומות במסמך המקור תואמים בדיוק לשמות המשאבים ב-Knowledge Catalog. תקנו את המשאבים החסרים או את שגיאות ההקלדה, והריצו שוב את סקריפט הייבוא.

פתרון בעיות במשימות ייבוא שנכשלו ב-Knowledge Catalog

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

הכלי עוקב אחרי קבוצות שיובאו בהצלחה באמצעות תיקיית ארכיון בקטגוריית ה-Staging של Cloud Storage.

כדי להמשיך את המשימה:

1. מפעילים מחדש את כלי הייבוא. הכלי מזהה את המצב של ההרצה הקודמת ומציג את ההודעה הבאה:

   Found X existing file(s) in archive folder from a previous incomplete import
   Continue using existing files? [y/N]:
   

2. מקלידים y. הכלי מדלג על קבוצות הקבצים שכבר יובאו בהצלחה ומעבד רק את הקבצים שנותרו.

זמן קצוב לתפוגה של סקריפט או שגיאות SSL במהלך הביצוע

בזמן ההפעלה של סקריפט כלי הייבוא או הייצוא, ההפעלה נעצרת, חורגת מהזמן הקצוב או מחזירה שגיאות SSL בטרמינל.

הבעיה הזו נגרמת בגלל השגיאות הבאות ברמת הרשת:

• יירוט של שרת proxy או חומת אש של הארגון: שרת proxy או חומת אש לאבטחה מיירטים ובודקים את תנועת ה-HTTPS, מה שמבטל את אישורי ה-SSL.
• הגבלות VPN פעילות: הגדרת ה-VPN מגבילה את התנועה היוצאת לממשקי API מסוימים של Google Cloud או לנקודות קצה מסוימות של Google Sheets.
• חוסר יציבות ברשת המקומית: ירידה זמנית בחיבור לאינטרנט קטעה את הסשן.

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

• מוודאים שיש חיבור יציב לרשת.

• בדיקת ההגדרות של שרת ה-proxy וחומת האש

• בודקים את הגדרות ה-VPN.

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

שגיאה: כתובת ה-URL של הגיליון האלקטרוני לא תקינה

כשמנסים להריץ כלי לייבוא או לייצוא, ממשק שורת הפקודה מחזיר שגיאת Invalid spreadsheet URL ומפסיק את ההרצה.

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

• כתובת URL לא תקינה: כתובת ה-URL לא תואמת לפורמט הנתיב הרגיל של Google Sheets.
• מזהה הגיליון האלקטרוני חסר: בנתיב חסר המזהה האלפאנומרי הייחודי שמצביע על הגיליון הספציפי.
• הגבלות גישה: לחשבון השירות המאומת אין הרשאה לצפות בגיליון או לערוך אותו, ולכן הכלי לא יכול לאמת את הקישור.

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

• מאמתים את הקידומת של כתובת ה-URL: מוודאים שכתובת ה-URL של הגיליון האלקטרוני שאתם מעבירים לכלי מתחילה בנתיב הרגיל הבא של Google Sheets: https://docs.google.com/spreadsheets/

• מאמתים את מזהה הגיליון האלקטרוני: מוודאים שכתובת ה-URL כוללת את המזהה הייחודי של הגיליון. כתובת URL תקינה צריכה להיות במבנה הבא: https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit

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

פתרון שגיאות שקשורות לכתובת URL לא תקינה של מילון מונחים

כשמנסים להפעיל כלי לייבוא או לייצוא של מילוני מונחים, ממשק שורת הפקודה מחזיר שגיאת Invalid glossary URL ומפסיק את הביצוע. מוודאים שאין כתובת URL לא תקינה של מילון מונחים בפרמטרים.

הבעיה הזו מתרחשת אם הסקריפט לא יכול לנתח את נתיב המשאב של מילון המונחים שצוין ב-Knowledge Catalog, או אם אין לו הרשאה לצפות במשאב. היא מופיעה בדרך כלל מהסיבות הבאות:

• נתיב משאב לא תקין: נתיב המשאב לא תואם לפורמט הנתיב הרגיל של מילון המונחים של Knowledge Catalog.
• מזהה שגוי: הנתיב מכיל מזהה פרויקט, מיקום אזור או מזהה מילון מונחים שגויים.
• הגבלות גישה או משאב חסר: מילון המונחים לא קיים, או שלחשבון השירות המאומת אין את הרשאות ה-IAM שנדרשות כדי לגשת אליו.

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

• מאמתים את מבנה הנתיב של המשאב: מוודאים שהנתיב של מילון המונחים שמעבירים לכלי תואם לפורמט הסטנדרטי הבא של Knowledge Catalog: projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID

• אימות המזהים בנתיב: צריך להשתמש במזהה הפרויקט, במיקום ובמזהה מילון המונחים הנכונים.

• מוודאים שהמשאב קיים ושיש אליו גישה: מוודאים שמילון המונחים קיים עם המזהה שצוין, ושלחשבון השירות המאומת הוקצו תפקידי ה-IAM הנדרשים.

הצגת יומני הביצוע

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

• מיקום היומן: כלי הייבוא והייצוא כותבים קובצי יומן לספרייה logs/ בנתיב ההפעלה המקומי.
• פורמט היומן: לכל קובץ יומן מצורפת חותמת זמן, כדי שתוכלו לאתר יומנים של הפעלה ספציפית.