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

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

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

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

אחרי שמייצאים קישורים לרשומות מ-Knowledge Catalog לגיליון אלקטרוני ב-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 שממנו מייבאים.

כדי לעקוב אחרי קבוצות של נתונים שיובאו בהצלחה, כלי השירות משתמש בתיקיית ארכיון בקטגוריית הביניים של 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 מגבילה את התנועה היוצאת לנקודות קצה מסוימות של Google Cloud API או של Google Sheets.
• חוסר יציבות ברשת המקומית: נפילה זמנית בקישוריות לאינטרנט קטעה את הסשן.

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

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

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

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

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

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

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

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

• כתובת 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/ בנתיב ההפעלה המקומי.
• פורמט היומן: לכל קובץ יומן מצורף חותמת זמן, כדי שתוכלו לאתר יומנים של הפעלה ספציפית.