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

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

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

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

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

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

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

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

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

כדי להפעיל את 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 בפרויקט שלכם ב- Cloud de Confiance .

הפעלת Analytics Hub API

gcloud

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

gcloud services enable analyticshub.googleapis.com

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

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

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

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

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

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

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

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

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

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

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

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

מחיקת מינוי

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

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

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

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

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

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

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

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

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

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

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

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

המסוף

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

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

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

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

המסוף

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

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

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