ייצוא מילוני מונחים עסקיים לגיליון אלקטרוני ב-Google

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

לפני שמתחילים

לפני שאתם מייצאים מילוני מונחים, אתם צריכים לבצע את הפעולות הבאות.

הגדרת חשבון השירות

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

  1. מאתרים או יוצרים חשבון שירות.

    בוחרים חשבון שירות קיים או יוצרים חשבון שירות חדש בפרויקט שבו מפעילים את כלי הייבוא. למידע נוסף, קראו את המאמר יצירת חשבונות שירות. שימו לב לכתובת האימייל של חשבון השירות (לדוגמה, SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com).

  2. מגדירים התחזות לחשבון שירות.

    כדי להריץ את הסקריפט של כלי הייצוא באופן מקומי, לחשבון המשתמש שלכם צריכה להיות הרשאה להתחזות לחשבון השירות. מקצים לחשבון המשתמש את התפקיד יצירת אסימונים בחשבון שירות (roles/iam.serviceAccountTokenCreator) בחשבון השירות.

    איך מנהלים את הגישה לחשבונות שירות

  3. נותנים לחשבון השירות Editor גישה לגיליון האלקטרוני ב-Google Sheets.

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

התפקידים הנדרשים

כדי לוודא שלחשבון השירות יש את ההרשאות שנדרשות לייצוא של מילוני מונחים ל-Google Sheets, צריך לבקש מהאדמין לתת לחשבון השירות את תפקידי ה-IAM הבאים:

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

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

הפעלת ממשקי ה-API

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

התפקידים שנדרשים כדי להפעיל ממשקי API

כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). איך מקצים תפקידים

הפעלת ממשקי ה-API

הגדרת מאגר Git

משכפלים את המאגר של dataplex-labs:

git clone https://github.com/GoogleCloudPlatform/dataplex-labs.git
cd dataplex-labs/dataplex-quickstart-labs/00-resources/scripts/python/business-glossary-import/dataplex-glossary/export

התקנת יחסי תלות

מתקינים את יחסי התלות הנדרשים של Python:

pip3 install -r requirements.txt

אם נתקלתם בבעיות בהתקנת החבילה, הגדירו סביבת פיתוח חדשה ב-Python.

אימות והגדרה של התחזות לחשבון שירות

מפעילים את Google Cloud CLI ומבצעים אימות באמצעות Application Default Credentials ‏ (ADC) עם התחזות לחשבון שירות:

# Set your service account email address
SA_EMAIL="SERVICE_ACCOUNT_EMAIL"

# Authenticate ADC using service account impersonation and required scopes
gcloud auth application-default login \
  --impersonate-service-account="${SA_EMAIL}" \
  --scopes="https://www.googleapis.com/auth/spreadsheets"

מחליפים את SERVICE_ACCOUNT_EMAIL במזהה האימייל של חשבון השירות. לדוגמה:

SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

הגדרת גיליון היעד ב-Google Sheets לייצוא

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

ייצוא מילון המונחים לגיליון האלקטרוני ב-Google Sheets

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

python3 glossary-export.py

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

אימות נתוני מילון המונחים שיוצאו

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

שדה תיאור
id מזהה ייחודי של המונח או הקטגוריה במילון המונחים.
parent המזהה של קטגוריית ההורה.
display_name השם המוצג של המונח או הקטגוריה.
description תיאור קצר של המונח או הקטגוריה.
overview תיאור בטקסט עשיר של המונח או הקטגוריה (תומך בתגי HTML).
type סוג השורה: TERM או CATEGORY.
contact1_email כתובת האימייל של מנהל המידע הראשי של המונח או הקטגוריה.
contact1_name השם של מנהל המידע הראשי של המונח או הקטגוריה.
contact2_email כתובת האימייל של מנהל המידע המשני של המונח או הקטגוריה.
contact2_name השם של מנהל המידע המשני של המונח או הקטגוריה.
label1_key המפתח של התווית הראשונה שהוקצתה.
label1_value הערך של התווית הראשונה שהוקצתה.
label2_key המפתח של התווית השנייה שהוקצתה.
label2_value הערך של התווית השנייה שהוקצתה.

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