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

במאמר הזה מוסבר איך לנהל מינויים ב-BigQuery sharing (לשעבר Analytics Hub). המאמר כולל הסברים על משימות שרלוונטיות למנויים ולמפרסמים.

משתמשים שרשומים לשיתוף ב-BigQuery יכולים:

  • נרשמים למוצר.
  • הצגת רשימה של המינויים הנוכחיים בפרויקט Google Cloud מסוים.
  • מחיקת מינוי.

בעלי אתרים שמשתפים נתונים ב-BigQuery sharing יכולים:

  • לעיון בכל המינויים לכרטיס המוצר.
  • ביטול הגישה למינוי ספציפי.

מינוי לשיתוף ב-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) בפרויקט. להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

תהליכי עבודה של מנויים לניהול מינויים

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

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

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

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

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

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

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

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

מחיקת מינוי

כדי למחוק מינוי, משתמשים בשיטה projects.locations.subscriptions.delete:

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

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

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

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

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

כשמוחקים מינוי מרישום רב-אזורי (בשלב טרום-השקה), נמחקים גם כל העותקים המשוכפלים של מערך הנתונים הראשי והמשני מהפרויקט של המנוי.

מידע נוסף על ניהול מינויים באמצעות ה-API זמין במאמר בנושא שיטות projects.locations.subscriptions.

תהליכי עבודה לבעלי אתרים לניהול מינויים

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

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

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

המסוף

  1. נכנסים לדף Sharing (Analytics Hub) במסוף Google Cloud .

    מעבר אל 'שיתוף' (Analytics Hub)

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

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

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

API

כדי להציג רשימה של מינויים לכרטיסי מוצר בבורסת נתונים מסוימת, משתמשים בשיטה projects.locations.dataExchanges.listSubscriptions.

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

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

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

ביטול מינוי

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

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

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

המסוף

  1. נכנסים לדף Sharing (Analytics Hub) במסוף Google Cloud .

    מעבר אל 'שיתוף' (Analytics Hub)

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

  2. בוחרים את השם של חילופי הנתונים שרוצים לבטל את הרישום שלהם.

  3. בוחרים בכרטיסייה מינויים כדי לראות את כל המינויים להחלפת הנתונים.

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

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

API

כדי לבטל מינוי, משתמשים ב-‎projects.locations.subscriptions.revoke method.

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

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

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

מגבלות

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

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

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