שימוש בדומיינים של נתונים

תצוגה מקדימה

השימוש במוצר או בתכונה כפוף לתנאי השימוש במוצרים בגרסת טרום-GA, בחלק "תנאים כלליים לשירות" של התנאים הספציפיים לשירות. השימוש בתכונות ובמוצרים בגרסת טרום-GA הוא "כפי שהם" (As is), ויכול להיות שהתמיכה בהם תהיה מוגבלת. מידע נוסף זמין בקטע תיאור שלבי ההשקה.

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

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

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

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

מפעילים את Dataplex API, אם הוא עדיין לא מופעל.

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

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

להפעלת ה-API

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

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

• צפייה במטא-נתונים של רשומות בדומיין לצורך גילוי: Dataplex Data Domain Entry Reader (roles/dataplex.dataDomainEntryReader)
• צפייה בהגדרות ובקשרים של הדומיין: צפייה בהגדרות של דומיין נתונים ב-Dataplex (roles/dataplex.dataDomainViewer)

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

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

עיון בהיררכיית הדומיין

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

חיפוש משאבים בדומיין נתונים

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

המסוף

1. במסוף Google Cloud , נכנסים לדף Knowledge Catalog > Search.

   מעבר אל חיפוש

2. לוחצים על ניסיון חיפוש טבעי כדי להפעיל את התכונה 'חיפוש טבעי'.

3. לוחצים על מסננים.

4. בשדה Scope (היקף), בוחרים באפשרות Domain (דומיין) מהרשימה.

5. בשדה Select domain (בחירת דומיין), בוחרים את הדומיין שרוצים לצמצם את התוצאות אליו. מוסיפים מסננים נוספים לפי הצורך.

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

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

   אל "דומיינים של נתונים"

2. בתפריט more_vert, בוחרים באפשרות חיפוש בתוך הדומיין. הפעולה הזו תפתח באופן אוטומטי חלון חיפוש עם סינון לפי דומיין.

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

REST

כדי לחפש רשומות בהיקף של דומיין נתונים, משתמשים בשיטה projects.locations.searchEntries ומספקים את נתיב הדומיין בפרמטר contexts.

הערה: המיקום בנתיב של searchEntries יכול להיות global (לשליחה לכל השרתים) או אזור ספציפי, בהתאם להגדרות של קצה העורף של החיפוש.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud .
• ‫LOCATION_ID: האזור של שאילתת החיפוש (או global).
• ‫QUERY: מחרוזת שאילתת החיפוש.
• ‫DOMAIN_ID: המזהה הייחודי של תחום הנתונים שמגדיר את ההקשר של היקף החיפוש.

ה-method של ה-HTTP וכתובת ה-URL:

POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries

תוכן בקשת JSON:

{
  "query": "QUERY",
  "contexts": [ "projects/PROJECT_ID/locations/LOCATION_ID/dataDomains/DOMAIN_ID" ],
  "semantic_search": true,
  "page_size": 100
}

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json ומריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID:searchEntries" | Select-Object -Expand Content

אמורים לקבל קוד סטטוס של הצלחה (2xx) ותגובה ריקה.

מגבלות

כשמחפשים משאבים מחוץ להקשר של הדומיין, למשל כשמשתמשים בחיפוש גלובלי, הרשאות הגילוי של הדומיין לא חלות. אתם רואים רק את המשאבים שיש לכם גישה אליהם במערכת הבסיסית, כמו BigQuery.

נניח שמערך נתונים ב-BigQuery נכלל בדומיין נתונים. יש לכם את התפקיד Dataplex Data Domain Entry Reader בדומיין, אבל אין לכם הרשאה ישירה לצפייה בקבוצת הנתונים ב-BigQuery:

• חיפוש בתוך הדומיין: מערך הנתונים מופיע בתוצאות החיפוש כי חלות עליו הרשאות הדומיין.
• חיפוש מחוץ לדומיין: מערך הנתונים לא מופיע בתוצאות החיפוש. בחיפוש כללי, הרשאות הדומיין לא חלות, ואין לכם גישה ישירה ב-BigQuery.

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

• מידע נוסף על דומיינים של נתונים
• איך יוצרים דומיינים של נתונים
• איך מנהלים משאבים של דומיין נתונים