ניהול מינויים

אתם יכולים לנהל את המינויים שלכם ב-BigQuery sharing (לשעבר Analytics Hub) כדי לשלוט בגישה לנתונים ובשיתוף שלהם. כמנויים, אתם יכולים להירשם כמנויים לרישומים, לראות את המינויים שלכם ולמחוק אותם. כבעלי תוכן דיגיטלי, אתם יכולים לעקוב אחרי המשתמשים שיש להם גישה לפרטי המוצרים שלכם ולבטל מינויים לפי הצורך. מינוי לשיתוף ב-BigQuery הוא משאב אזורי שנמצא בפרויקט של המנוי. המינויים מאחסנים מידע על המנוי ומייצגים את החוזה בין בעל האתר לבין המנוי.

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

כדי להתחיל להשתמש ב-BigQuery sharing (לשעבר Analytics Hub), צריך להפעיל את Analytics Hub API בפרויקט ב- Google Cloud .

כדי להפעיל את Analytics Hub API, צריך את ההרשאות הבאות בממשק לניהול זהויות והרשאות גישה (IAM):

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

התפקיד המוגדר מראש הבא ב-IAM כולל את ההרשאות שנדרשות כדי להפעיל את Analytics Hub API:

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

המסוף

נכנסים לדף Analytics Hub API ומפעילים את Analytics Hub API בפרויקט ב- Google Cloud .

הפעלת Analytics Hub API

gcloud

מריצים את הפקודה gcloud services enable:

gcloud services enable analyticshub.googleapis.com

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

כדי לקבל את ההרשאות שנדרשות לניהול מינויים, צריך לבקש מהאדמין להקצות לכם ב-IAM את התפקיד בעלים של מינוי ב-Analytics Hub (roles/analyticshub.subscriptionOwner) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

מגבלות

למינויים יש את המגבלות הבאות:

  • אפשר להשתמש ב-Analytics Hub API רק כדי לנהל מינויים שנוצרו אחרי 25 ביולי 2023. אי אפשר להשתמש בקבוצות נתונים מקושרות שנוצרו לפני התאריך הזה, כי אין להן את משאב המינוי הנדרש.

ניהול המינויים כמנויים

בקטעים הבאים מוסבר איך מנויים של BigQuery sharing מנהלים את המינויים.

הרשמה לדפי אפליקציה

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

הצגת רשימת המינויים

כדי להציג את המינויים בפרויקט, צריך להפעיל את ה-method‏ projects.locations.subscriptions.list:

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud שמכיל את המינויים שרוצים להציג.
  • ‫LOCATION: המיקום של המינויים שרוצים להציג ברשימה. מידע נוסף על מיקומים שתומכים בשיתוף זמין במאמר אזורים נתמכים.

רענון מינוי

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

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

המסוף

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

    כניסה ל-BigQuery

  2. בחלונית השמאלית, לוחצים על database Data Explorer:

    הכפתור המודגש של חלונית הנתונים.

    אם החלונית השמאלית לא מוצגת, לוחצים על Expand left pane כדי לפתוח אותה.

  3. בחלונית Data, לוחצים על Add data.

  4. בוחרים באפשרות שיתוף (Analytics Hub). נפתח דף Discovery.

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

  6. לוחצים על הרשמה. בגלל שכבר יש לכם מינוי פעיל, במסוף מוצגת האפשרות Refresh.

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

API

כדי לרענן מינוי, משתמשים ב-projects.locations.subscriptions.refresh method:

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions/SUBSCRIPTION_ID:refresh

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט של המינוי שרוצים לרענן.
  • ‫LOCATION: המיקום של המינוי שרוצים לרענן.
  • ‫SUBSCRIPTION_ID: המזהה של המינוי שרוצים לרענן.

גוף הבקשה צריך להיות ריק. אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של פעולה.

מחיקת מינוי

כדי למחוק מינוי, מפעילים את ה-method‏ projects.locations.subscriptions.delete:

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions/SUBSCRIPTION_ID

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: Google Cloud מזהה הפרויקט שמכיל את המינוי שרוצים למחוק.
  • ‫LOCATION: המיקום של המינוי שרוצים למחוק.
  • ‫SUBSCRIPTION_ID: המזהה של המינוי שרוצים למחוק.

גוף הבקשה צריך להיות ריק. אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של פעולה.

כשמוחקים מינוי, גם מערך הנתונים המקושר נמחק מהפרויקט.

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

למידע נוסף על ניהול מינויים באמצעות Analytics Hub API, קראו על השיטות של projects.locations.subscriptions.

ניהול מינויים כמוציא לאור

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

הצגת רשימת המינויים

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

המסוף

  1. במסוף Google Cloud , נכנסים לדף שיתוף (מאגר הניתוחים ב-Analysis).

    מעבר אל Sharing (Analytics Hub)

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

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

  3. לוחצים על הכרטיסייה מינויים.

API

כדי להציג את המינויים למוצרים שמופיעים במאגר נתונים מסוים, מפעילים את ה-method‏ projects.locations.dataExchanges.listSubscriptions:

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:listSubscriptions

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud שמכיל את חילופי הנתונים.
  • ‫LOCATION: המיקום של המאגר שבו נמצאים המינויים שרוצים להציג.
  • ‫DATAEXCHANGE_ID: המזהה של המאגר שרוצים להציג את המינויים שלו.

ביטול מינוי

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

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

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

המסוף

  1. במסוף Google Cloud , נכנסים לדף שיתוף (מאגר הניתוחים ב-Analysis).

    מעבר אל Sharing (Analytics Hub)

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

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

  3. לוחצים על הכרטיסייה מינויים.

  4. מסמנים את התיבה לצד כל מינוי שרוצים לבטל.

  5. לוחצים על ביטול המינויים.

API

כדי לבטל מינוי, צריך להפעיל את ה-method‏ projects.locations.subscriptions.revoke:

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

מחליפים את מה שכתוב בשדות הבאים:

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud שמכיל את המינוי שרוצים לבטל.
  • ‫LOCATION: המיקום של המינוי שרוצים לבטל.
  • ‫SUBSCRIPTION_ID: המזהה של המינוי שרוצים לבטל.

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