שיתוף סטרימינג עם Pub/Sub

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

אתם יכולים לשתף נתונים בזמן אמת כדי:

• שירותים פיננסיים:
  • שיתוף בזמן אמת של מחירים, הצעות מחיר והזמנות של מכשירים שמשתנים במהירות.
  • זיהוי הלבנת הון והונאות בתשלומים.
  • תמיכה בחישובים של סיכוני מסחר.
• קמעונאות ומוצרי צריכה ארוזים (CPG):
  • לנהל את המלאי בחנות בזמן אמת.
  • התאמה אישית של השיווק ותמיכת הלקוחות.
  • התאמת מחירים באופן דינמי.
  • מעקב אחרי ערוצים במדיה החברתית.
  • אופטימיזציה של פריסות בחנויות פיזיות.
• Healthcare:
  • הפעלת אלגוריתמים חיזויים כדי לעקוב אחרי מטופלים ולנתח סיכונים בזמן אמת.
  • מעקב אחרי מדדים חיוניים באמצעות מכשירים רפואיים לבישים.
  • רכישה, ארגון, אחסון ועיבוד אוטומטיים של נתונים מהמטופלים, מאנשי מקצוע בתחום הבריאות וממנהלי המתקנים.
• תקשורת:
  • מעקב אחרי תקינות הרשת וחיזוי כשלים.
  • כך תוכלו לגלות דפוסי התנהגות של משתמשים כדי לאתר טוב יותר מכשירים ואנטנות.

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

התפקידים לשיתוף נושאים ב-Pub/Sub דומים לתפקידים לשיתוף מערכי נתונים ב-BigQuery:

• אדמין: מנהל את ההרשאות, החשיפה והחברות בבורסות ובקטלוגים. התפקיד הזה מקביל לתפקיד IAM‏ Analytics Hub Admin‏ (roles/analyticshub.admin).
• פרסום בנושא משותף: יצירה וניהול של רשימות של נושאי Pub/Sub משותפים, והענקת גישה אליהן. התפקיד הזה מקביל לתפקיד IAM‏ Analytics Hub Publisher או Analytics Hub Listing Admin. הגורם שמפרסם הוא משתמש, ולא אפליקציית המפרסם שיוצרת ושולחת הודעות לנושא.
• מנוי לנושא משותף: נרשם כמנוי לרשימת הנושאים המשותפים. מנויים לנושאים משותפים יכולים להגדיר איך הודעות בנושאים יועברו. התפקיד הזה מקביל לתפקיד IAM‏ Analytics Hub Subscriber או Analytics Hub Subscription Owner. בהתאם לאופן שבו נתוני ההודעות מועברים, יכול להיות שיידרשו הרשאות נוספות, כמו הרשאות לחשבון השירות של Pub/Sub לכתיבת הודעות ב-BigQuery.

ארכיטקטורה

בתרשים הבא מתואר האופן שבו מפרסמים ומנויים של משאבי Pub/Sub יוצרים אינטראקציה עם שיתוף ב-BigQuery:

איור 1. תהליך עבודה משותף של אפליקציות לשליחת הודעות ואפליקציות רשומות עם נושאי Pub/Sub.

נושאים משותפים

נושא משותף הוא היחידה לשיתוף נושא Pub/Sub ב-BigQuery sharing. בתור מפרסם בנושא משותף, אתם יוצרים נושא Pub/Sub או משתמשים בנושא קיים כדי להפיץ נתוני הודעות למנויים. BigQuery sharing לא משכפל את נושא המקור ב-Pub/Sub.

כרטיסי מוצר

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

בורסות

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

מינויים מקושרים ל-Pub/Sub

כשנרשמים למינוי של כרטיס מוצר עם נושא משותף, נוצר מינוי Pub/Sub מקושר בפרויקט המינוי של הנושא המשותף. הפרויקט של בעל ההרשאה לפרסום בנושא המשותף מייצג גם מינוי ל-Pub/Sub כמינוי ל-Pub/Sub וגם מינוי לרשימת שיתוף.

מגבלות

ההגבלות הבאות חלות על שיתוף נתונים בסטרימינג באמצעות Pub/Sub:

• נושא משותף יכול לתמוך בעד 10,000 מינויים ל-Pub/Sub. המגבלה הזו כוללת מינויים מקושרים ל-Pub/Sub ומינויים ל-Pub/Sub שנוצרו מחוץ לשיתוף, למשל מינויים שנוצרו ישירות מ-Pub/Sub.

• נושאים משותפים עוברים אינדוקס ב-Data Catalog (הוצא משימוש) וב-Dataplex Universal Catalog, אבל אי אפשר לסנן במיוחד לפי סוג המשאב שלהם.

• מדדי השימוש נאספים ומוצגים בלוח הבקרה 'מדדים' עבור נושאים ומינויים משותפים ב-Pub/Sub, אבל הם לא זמינים ב-INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

  כדי לעקוב אחרי מדדים, אפשר לעיין במאמר בנושא מעקב אחרי Pub/Sub ב-Cloud Monitoring.

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

  • ספירת הודעות שפורסמו
  • פרסום בקשות
  • קצב העברת נתונים (throughput) בבייטים
  • 5 המינויים המובילים
  • בייטים שהועברו
  • אחרים

הפעלת Analytics Hub API

כדי להפעיל את Analytics Hub API:

המסוף

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

הפעלת Analytics Hub API

gcloud

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

gcloud services enable analyticshub.googleapis.com

הפעלת Pub/Sub API

נכנסים לספריית ה-API ומפעילים את Pub/Sub API בפרויקט Google Cloud .

הפעלת Pub/Sub API

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

מוציאים לאור של נושאים משותפים יכולים:

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

הרשאות נוספות לבעלי תוכן דיגיטלי

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

בנוסף, צריך את ההרשאה pubsub.topics.setIamPolicy בנושא Pub/Sub שרוצים לראות את הרשימה שלו. כדי לשתף נושאים עם סכימה מצורפת, צריך להעניק למנויים של BigQuery sharing את ההרשאה pubsub.schemas.get בסכימה שמצורפת לנושא. ההרשאה הזו מאפשרת למנויים ב-BigQuery sharing לנתח כראוי הודעות מהמינוי ל-Pub/Sub.

יצירת כרטיס מוצר (כדי להוסיף נושא משותף)

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

המסוף

1. עוברים לדף שיתוף (מרכז Analytics).

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

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

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

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

4. בדף Create listing, בוחרים באפשרות Pub/Sub Topic מהרשימה Resource type.

5. בוחרים נושא קיים של Pub/Sub מהרשימה נושא משותף או לוחצים על יצירת נושא.

6. בדף פרטי כרטיס המוצר, בשדה שם מוצג, מזינים את שם כרטיס המוצר.

7. מזינים את הפרטים האופציונליים הבאים:

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

   • זיקה לנתונים: האזור או האזורים שבהם מפרסם הנושא המשותף משתמש כדי לפרסם נתונים. המידע הזה עוזר למנויים בנושאים משותפים לצמצם את עלויות היציאה מהרשת של Pub/Sub או להימנע מהן, על ידי קריאת נתונים מאותו אזור. מידע נוסף על עלויות תעבורת נתונים יוצאת (egress) אפשר למצוא במאמר בנושא עלויות העברת נתונים.

   • סמל: סמל לכרטיס העסק. אפשר להשתמש בפורמטים של קובצי PNG ו-JPEG. הסמלים צריכים להיות קטנים מ-512 KiB והמידות שלהם לא יכולות להיות גדולות מ-512 x 512 פיקסלים.

   • תיאור: תיאור קצר של כרטיס המוצר. מנויים לנושא משותף יכולים לחפש כרטיסי מוצר על סמך התיאור.

   • גילוי ציבורי: הפעלת גילוי ציבורי של כרטיס המוצר בקטלוג השיתוף של BigQuery. צריך גם להגדיר הרשאות לכרטיס המוצר. לוחצים על פעולות בבורסה ואז על הגדרת הרשאות. נותנים למשתמשים allUsers או allAuthenticatedusers את התפקיד 'צפייה ב-Analytics Hub' (roles/analyticshub.viewer). לוחצים על מתן גישה לכולם.

   • מסמכי תיעוד > Markdown: מידע נוסף, כמו קישורים למסמכי תיעוד רלוונטיים ופרטים אחרים שיעזרו למנויים של נושא משותף להשתמש בנושא.

8. בדף פרטים ליצירת קשר, מזינים את הפרטים האופציונליים הבאים:

   • איש קשר ראשי: מזינים כתובת אימייל או כתובת URL של איש הקשר הראשי של כרטיס המוצר.

   • איש קשר לבקשת גישה: מזינים כתובת אימייל או כתובת URL של טופס שדרכו מנויים לנושא משותף יכולים ליצור איתכם קשר.

   • ספק: מרחיבים את הקטע ספק ומזינים פרטים בשדות הבאים:

     • Provider name: השם של ספק הנושא.
     • איש קשר ראשי של הספק: כתובת אימייל או כתובת URL של איש הקשר הראשי של ספק הנושא.

     מנויים לנושאים משותפים יכולים לסנן את כרטיסי המוצר על סמך ספקי הנתונים.

   • בעל תוכן דיגיטלי: מרחיבים את הקטע בעל תוכן דיגיטלי ומציינים פרטים בשדות הבאים:

     • שם בעל האפליקציה: השם של בעל האפליקציה שמשתף את הנושא ויוצר את הרשימה.
     • איש הקשר הראשי של בעל התוכן הדיגיטלי: כתובת אימייל או כתובת URL של איש הקשר הראשי של בעל התוכן הדיגיטלי שמשתף את הנושא.

9. מעיינים בדף תצוגה מקדימה של כרטיס המוצר.

10. לוחצים על פרסום.

API

משתמשים בשיטה projects.locations.dataExchanges.listings.create.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings?listingId=LISTING_ID

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

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

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

מידע נוסף על המשימות שאפשר לבצע בדפי מידע באמצעות ממשקי API זמין במאמר בנושא שיטות projects.locations.dataExchanges.listings.

עדכון כרטיס מוצר

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

המסוף

1. עוברים לדף שיתוף (מרכז Analytics).

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

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

3. לוחצים על כרטיס העסק שרוצים לעדכן.

4. לוחצים על עריכת כרטיס העסק.

5. משנים את ערכי השדות. אפשר לשנות את כל הערכים חוץ מהנושא המשותף של כרטיס המוצר.

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

API

משתמשים בשיטה projects.locations.dataExchanges.listings.patch.

PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID?updateMask=UPDATEMASK

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

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

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

מידע נוסף על המשימות שאפשר לבצע בדפי מידע באמצעות ממשקי API זמין במאמר בנושא שיטות projects.locations.dataExchanges.listings.

מחיקת דף מוצר

אי אפשר למחוק כרטיסי מוצר עם נושאי Pub/Sub משותפים שיש להם מנויים פעילים. לפני שמנסים למחוק רשימה של נושאים משותפים, צריך לבטל את כל המינויים הפעילים. אי אפשר לבטל מחיקה של כרטיס מוצר.

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

המסוף

1. עוברים לדף שיתוף (מרכז Analytics).

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

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

3. לוחצים על הרשומה שרוצים למחוק.

4. לוחצים על מחיקה.

5. בתיבת הדו-שיח למחוק את כרטיס המוצר?, מקלידים delete כדי לאשר את המחיקה.

6. לוחצים על Delete.

API

משתמשים בשיטה projects.locations.dataExchanges.listings.delete.

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID

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

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

מידע נוסף על המשימות שאפשר לבצע בדפי מידע באמצעות ממשקי API זמין במאמר בנושא שיטות projects.locations.dataExchanges.listings.

שיתוף כרטיס מוצר

כדי לתת למשתמשים גישה לכרטיס פרטי, צריך להגדיר מדיניות IAM למשתמש או לקבוצה עבור אותו כרטיס. אם מדובר בדף עסקי מסחרי, החלפת הנתונים חייבת להיות ציבורית. רישומים בבורסת נתונים ציבורית מופיעים בשיתוף עבור כל משתמשיGoogle Cloud (allAuthenticatedUsers). כדי לאפשר למשתמשים לבקש גישה לכרטיסי מוצר מסחריים, צריך להקצות להם את התפקיד 'צפייה במרכז Analytics' (roles/analyticshub.viewer).

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

1. עוברים לדף שיתוף (מרכז Analytics).

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

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

3. לוחצים על הרשימה שרוצים להוסיף לה מנויים לנושאים משותפים.

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

5. כדי להוסיף ישויות, לוחצים על Add principal.

6. בשדה New principals, מוסיפים פרטים בהתאם לסוג כרטיס המוצר:

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

7. בתפריט Select a role, בוחרים באפשרות Analytics Hub ואז בוחרים אחד מהתפקידים הבאים בהתאם לסוג הרישום:

   • לכרטיס מוצר מסחרי, בוחרים בתפקיד Analytics Hub Viewer. התפקיד הזה מאפשר למשתמשים לצפות בכרטיס העסק ולבקש גישה.
   • לפרופיל פרטי או לפרופיל ציבורי לשימוש לא מסחרי, בוחרים בתפקיד מנוי ל-Analytics Hub. התפקיד הזה מאפשר למשתמשים להירשם למינוי של הערוץ שלכם.

8. לוחצים על Save.

מידע נוסף זמין במאמר בנושא תפקידים של מנויים וצופים ב-Analytics Hub.

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

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

1. עוברים לדף שיתוף (מרכז Analytics).

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

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

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

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

5. כדי להוסיף ישויות, לוחצים על Add principal.

6. בשדה New principals, מזינים את שמות המשתמשים או את כתובות האימייל של המנויים שרוצים להוסיף.

7. בשדה Select a role (בחירת תפקיד), בוחרים באפשרות Analytics Hub > Analytics Hub Subscriber (מרכז Analytics > מנוי למרכז Analytics).

8. לוחצים על הוספת תפקיד נוסף.

9. בשדה Select a role (בחירת תפקיד), בוחרים באפשרות Analytics Hub > Analytics Hub Subscription Owner (מרכז Analytics > הבעלים של המינוי למרכז Analytics).

10. לוחצים על Save.

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

ביטול מינוי

כדי להסיר מינוי לרשימת נושאים משותפת משיתוף ב-BigQuery,

המסוף

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

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

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

4. בתיבת הדו-שיח האם לבטל את המינוי?, מזינים revoke כדי לאשר.

5. לוחצים על ביטול.

API

כדי להסיר מינוי, משתמשים ב-method‏ projects.locations.subscriptions.revoke.

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

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

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

כשמבטלים את המינוי לשיתוף ב-BigQuery, המנוי לנושא משותף לא מקבל יותר נתוני הודעות מהנושא המשותף. המינוי ל-Pub/Sub מנותק מהנושא המשותף. אם מוחקים מינוי ישירות מ-Pub/Sub, המינוי לשיתוף ב-BigQuery נשאר וצריך לנקות אותו.

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

בתור מנויים ב-BigQuery sharing, אתם יכולים לראות כרטיס מוצר ולהירשם אליו. הרשמה למינוי של רשימת נושאים משותפים יוצרת מינוי Pub/Sub מקושר אחד בפרויקט של הנרשם. מינוי Pub/Sub גלוי בפרויקט של בעל הנושא המשותף.

הרשאות נוספות למנויים

כדי לבצע משימות של מנויים, צריך לקבל את התפקיד Analytics Hub Subscriber (roles/analyticshub.subscriber) ברמת הפרויקט, ברמת המרכז או ברמת הרישום.

הרשמה לרשימת נושאים משותפת

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

המסוף

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

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

3. לוחצים על Subscribe (הרשמה) כדי לפתוח את תיבת הדו-שיח Create subscription (יצירת מינוי).

4. אם לא הפעלתם את Analytics Hub API בפרויקט, תוצג הודעת שגיאה עם קישור להפעלת ה-API. לוחצים על Enable Analytics Hub API (הפעלת Analytics Hub API).

5. בתיבת הדו-שיח Create subscription, מציינים את הפרטים הבאים:

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

   מידע נוסף על מאפייני מינוי ב-Pub/Sub

6. כדי לשמור את השינויים, לוחצים על יצירה. המינוי המקושר ל-Pub/Sub נוצר בפרויקט.

API

משתמשים בשיטה projects.locations.dataExchanges.listings.subscribe.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:subscribe

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

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

בגוף הבקשה, מציינים את המינוי ל-Pub/Sub שבו רוצים ליצור את המינוי המקושר ל-Pub/Sub. אם הפעולה בוצעה ללא שגיאות, גוף התגובה יהיה ריק.

מידע נוסף על מינויים ל-Pub/Sub זמין במאמר בנושא סקירה כללית של מינויים.

תמחור

מפרסמים בנושאים ב-Pub/Sub לא מחויבים בחיוב נוסף על יצירת רשימה ושיתוף של נושאים באמצעות BigQuery sharing. מוציאים לאור של נושאים משותפים מחויבים על סך הבייטים שנכתבו (תפוקת פרסום) לנושא המשותף ועל תעבורת נתונים יוצאת (egress) מהרשת (אם רלוונטי). מנויים לנושא משותף מחויבים על סך הבייטים שנקראו (תפוקת מינוי) מהמינוי המקושר ועל תעבורת נתונים יוצאת מהרשת (אם רלוונטי). פרטים נוספים זמינים במאמר בנושא תמחור של Pub/Sub.

VPC Service Controls

כדי לקבל גישה לפרסום בנושאים משותפים ולמינוי שלהם מפרויקטים עם אזורים של VPC Service Controls, צריך להגדיר את הכללים המתאימים לתעבורת נתונים נכנסת (ingress) ויוצאת (egress).

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

• מידע נוסף על ניהול כרטיסי המוצר
• מידע נוסף על הרשמה לכרטיסי מוצר
• מידע נוסף על מעקב אחרי המשאבים שלכם ב-Pub/Sub
• מידע נוסף על הגדרת VPC Service Controls לשיתוף ב-BigQuery