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

אתם יכולים לנהל את המינויים שלכם ב-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. בחלונית Explorer, לוחצים על Add data.

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

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

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

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

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: המזהה של המינוי שרוצים לבטל.

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