ייצוא קישורים לרשומות לגיליון אלקטרוני ב-Google

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

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

לפני שאתם מייצאים קישורים של רשומות לגיליון אלקטרוני ב-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
cd dataplex-glossary

אם נתקלתם בבעיות בהתקנת החבילה, הגדירו סביבת פיתוח חדשה ב-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 init
gcloud auth login
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.

הגדרת משתני סביבה

מגדירים את משתני הסביבה הבאים:

# Set your glossary URL
export GLOSSARY_URL="GLOSSARY_URL"

# Set your Google Sheet URL
export SPREADSHEET_URL="GOOGLE_SHEET_URL"

# Set the project ID
export USER_PROJECT="USER_PROJECT"

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

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

cd export
python3 entrylinks-export.py \
  --glossary-url="$GLOSSARY_URL" \
  --spreadsheet-url="$SPREADSHEET_URL" \
  --user-project="$USER_PROJECT"

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

אימות הנתונים של קישורי הרשומות שיוצאו

סקריפט הייצוא מאכלס את הגיליון האלקטרוני ב-Google Sheets בעמודות הבאות:

כותרת עמודה תיאור
entry_link_type סוג הקישור לרשומה (definition,‏ related או synonym).
source_entry נתיב המשאב המלא של רשומת המקור.
target_entry הנתיב המלא של המשאב של רשומת היעד.
source_path נתיב העמודה או השדה לקישורים להגדרות.

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