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

אתם יכולים לנהל את המינויים שלכם ב-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 Subscription Owner (roles/analyticshub.subscriptionOwner) בפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

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

מגבלות

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

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

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

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

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

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

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

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

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

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

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

מחיקת מינוי

כדי למחוק מינוי, מבצעים קריאה ל-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. נכנסים לדף Sharing (Analytics Hub) במסוף Google Cloud .

    מעבר אל 'שיתוף' (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 sharing, המנוי לא יכול יותר להריץ שאילתות על מערך הנתונים המקושר. מכיוון שאתם מפעילים את הפעולה הזו במשאב שבבעלות המנוי, מערך הנתונים המקושר נשאר בפרויקט של המנוי. המנוי יכול למחוק את קבוצת הנתונים כדי להסיר אותה.

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

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

המסוף

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

    מעבר אל 'שיתוף' (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: המזהה של המינוי שרוצים לבטל.

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