ניהול דפי מידע מקומיים

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

כשאתם מנהלים דפי אפליקציה, אתם יכולים לבצע את המשימות הבאות:

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

רשימת נתונים היא הפניה למערך נתונים משותף שבעל תוכן דיגיטלי מפרסם בהמרת נתונים. בהתאם למדיניות ניהול הזהויות והרשאות הגישה (IAM) שמוגדרת ל-listing ולסוג של חילופי הנתונים שמכיל את ה-listing, ה-listing יכול להיות אחד משני הסוגים הבאים:

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

כדי להתחיל להשתמש ב-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

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

כדי לנהל את פריטי המידע והמינויים, צריך אחד מהתפקידים הבאים ב-BigQuery sharing לניהול זהויות והרשאות גישה (IAM):

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

כדי ליצור כרטיסי מוצר או לעדכן אזורי רפליקה של כרטיס מוצר, צריך את ההרשאות bigquery.datasets.get ו-bigquery.datasets.update במערכי הנתונים של המקור. התפקידים המוגדרים מראש של BigQuery שכוללים את ההרשאה bigquery.datasets.update:

כדי לראות את כל מאגרי הנתונים בפרויקטים בארגון שיש לכם גישה אליו, אתם צריכים את ההרשאה resourcemanager.organizations.get. אין תפקידים מוגדרים מראש ב-BigQuery שכוללים את ההרשאה הזו, לכן צריך להשתמש בתפקיד בהתאמה אישית ב-IAM.

הצגת מאגרי נתונים

כדי לראות את רשימת מאגרי הנתונים בארגון שיש לכם גישה אליהם, עיינו במאמר הצגת מאגרי נתונים. אם המאגר נמצא בארגון אחר, האדמין של BigQuery sharing צריך לשתף איתכם קישור למאגר.

יצירת דף אפליקציה

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

כדי ליצור דף אפליקציה:

המסוף

  1. עוברים לדף Sharing (Analytics Hub).

    מעבר אל Sharing (Analytics Hub)

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

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

  3. לוחצים על Create listing.

  4. בקטע Configure data, בתפריט Resource type בוחרים באפשרות BigQuery dataset או Pub/Sub Topic.

    • אם בוחרים באפשרות מערך נתונים ב-BigQuery, מבצעים את הפעולות הבאות:

      1. בתפריט Shared dataset, בוחרים מערך נתונים קיים או לוחצים על Create a dataset כדי ליצור מערך נתונים. מערך הנתונים צריך להיות באותו אזור שבו נמצא מאגר הנתונים. אי אפשר לשנות את מערך הנתונים המשותף אחרי שיוצרים את דף האפליקציה. כשמנויים צופים במטא-נתונים של מערך הנתונים המקושר שלהם, התכונה "שיתוף ב-BigQuery" מחזירה את השם של מערך הנתונים המקורי ואת המזהה של הפרויקט שמכיל את מערך הנתונים.
      2. אופציונלי: כדי לאפשר למנויים לשתף פרוצדורה מאוחסנת של SQL בין כרטיסי מוצר, בוחרים באפשרות Allow stored procedure sharing (גרסת טרום-השקה (Preview)).
      3. כדי להפוך את מערך הנתונים המשותף לזמין באזורים נוספים, מרחיבים את התפריט Region data availability. בתפריט מוצגים אזורים שיש בהם עותקים קיימים של מערכי נתונים שמתויגים בתווית מוכן לשימוש. לפני שאתם מגדירים את דף האפליקציה לכמה אזורים, ודאו שהפעלתם שכפול של מערכי נתונים באזורים שונים במערך הנתונים המשותף. אפשר לבחור רק אזורים שבהם מופעל שכפול של מערכי נתונים באזורים שונים. כל שאר האזורים מסומנים בתווית Unavailable. אם לא בוחרים אזור נוסף, ברירת המחדל של דף האפליקציה היא האזור הראשי של קבוצת הנתונים המשותפת, שמסומן בתווית Provider primary.

      4. בקטע Data Egress controls, בוחרים את האפשרות המתאימה לייצוא נתונים:

        • כדי להגביל את ההעתקה והייצוא של הנתונים במערך הנתונים המשותף, אבל לאפשר ייצוא של תוצאות השאילתות, בוחרים באפשרות השבתת ההעתקה והייצוא של נתונים משותפים.
        • כדי להגביל את ההעתקה והייצוא של הנתונים גם במערך הנתונים המשותף וגם בתוצאות השאילתה, בוחרים באפשרות השבתת ההעתקה והייצוא של תוצאות השאילתה. האפשרות הזו גם בוחרת את השבתת ההעתקה והייצוא של נתונים משותפים.
        • כדי להגביל את ההעתקה והייצוא של טבלאות באמצעות ממשקי API במערך הנתונים המשותף, בוחרים באפשרות Disable copy and export of tables through APIs. אם בוחרים באפשרות הזו, גם האפשרות השבתת ההעתקה והייצוא של נתונים משותפים נבחרת.

        למידע נוסף על אמצעי בקרה על תעבורת נתונים יוצאת, כולל הגבלות, קראו את המאמר אפשרויות לתעבורת נתונים יוצאת (רק במערכי נתונים משותפים של BigQuery).

    • אם בוחרים באפשרות Pub/Sub Topic, בתפריט Shared topic בוחרים נושא קיים ב-Pub/Sub או לוחצים על Create a topic כדי ליצור נושא חדש.

  5. בקטע Listing details, בשדה Display name, מזינים שם לפריט.

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

    • קטגוריה: בוחרים עד חמש קטגוריות שמייצגות את האפליקציה בצורה הטובה ביותר. המנויים יכולים לסנן את כרטיסי המוצר לפי הקטגוריות שבחרתם.
    • שיוך נתונים: מציינים את האזורים שבהם אתם משתמשים לפרסום נתונים. הגדרת המיקום הזו עוזרת למנויים לצמצם או להימנע מעלויות של תעבורת נתונים יוצאת (egress) ברשת Pub/Sub, על ידי קריאת נתונים מאותו אזור. למידע נוסף על עלויות של תעבורת נתונים יוצאת, קראו את המאמר עלויות של העברת נתונים.
    • סמל: מעלים סמל לדף האפליקציה. אפשר להשתמש בקובצי PNG ו-JPEG. הסמלים צריכים להיות קטנים מ-512 KiB ובגודל מקסימלי של 512 x 512 פיקסלים.
    • תיאור: מזינים תיאור קצר של דף האפליקציה. המנויים יכולים לחפש פריטים לפי טקסט התיאור.

    • Public discoverability: הפעילו את ההגדרה הזו כדי שמשתמשים יוכלו למצוא את הפריט שלכם בקטלוג השיתוף של BigQuery. אם מפעילים את האפשרות הזו, צריך לתת את התפקיד 'בעל הרשאת צפייה במאגר הניתוחים ב-Analysis' (roles/analyticshub.viewer) ל-allUsers או ל-allAuthenticatedUsers. איך נותנים תפקיד לפריט אם ה-Exchange כבר ציבורי, ה-listing יורש את ההרשאות האלה ולא נדרשת פעולה נוספת.

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

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

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

  7. בקטע Listing contact information, מזינים את הפרטים האופציונליים הבאים:

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

    • Provider: מרחיבים את הקטע Provider וממלאים את הפרטים בשדות הבאים:

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

      המנויים יכולים לסנן את הנתונים לפי ספק הנתונים.

    • Publisher: מרחיבים את הקטע Publisher וממלאים את הפרטים בשדות הבאים:

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

  8. מעיינים בקטע תצוגה מקדימה של דף האפליקציה בחנות.

  9. כדי לפרסם את דף האפליקציה, לוחצים על פרסום.

API

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

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

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

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

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

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

אם הבקשה מצליחה, גוף התגובה מחזיר את פרטי דף האפליקציה. אם מפעילים את הרישום ביומן של כתובות האימייל של המנויים על ידי הגדרת השדה logLinkedDatasetQueryUserEmail לערך true, התגובה של הרישום מחזירה את הערך log_linked_dataset_query_user_email: true. הנתונים שנרשמו ביומן זמינים בעמודה job_principal_subject של התצוגה INFORMATION_SCHEMA.SHARED_DATASET_USAGE.

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

יצירת כרטיס מוצר מקבוצת נתונים

כדי ליצור כרטיס מוצר ישירות ממערך נתונים קיים:

  1. נכנסים לדף BigQuery במסוף Google Cloud .

    כניסה לדף BigQuery

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

  3. לוחצים על שיתוף > פרסום כדף אפליקציה בחנות.

    תיפתח תיבת הדו-שיח יצירת דף אפליקציה.

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

  5. בתפריט Shared dataset, בוחרים קבוצת נתונים קיימת או לוחצים על Create a dataset כדי ליצור קבוצת נתונים. מערך הנתונים צריך להיות באותו אזור שבו נמצא מאגר הנתונים. אי אפשר לשנות את הבחירה הזו אחרי שיוצרים את דף האפליקציה.

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

  6. אופציונלי: כדי לאפשר למנויים לשתף פרוצדורה מאוחסנת של SQL בין כרטיסי מוצר, בוחרים באפשרות Allow stored procedure sharing (גרסת טרום-השקה (Preview)).

  7. כדי להפוך את מערך הנתונים המשותף לזמין באזורים נוספים, מרחיבים את התפריט Region data availability. בתפריט מוצגים אזורים עם רפליקות של מערכי נתונים שמסומנות בתווית Ready to use. לפני שמגדירים את דף האפליקציה לכמה אזורים, צריך לוודא שהפעלתם שכפול של מערכי נתונים באזורים שונים במערך הנתונים המשותף. אפשר לבחור רק אזורים שבהם מופעל שכפול של מערכי נתונים באזורים שונים. כל שאר האזורים מסומנים בתווית Unavailable. אם לא תבחרו אזור נוסף, ברירת המחדל של ה-listing תהיה האזור הראשי של קבוצת הנתונים המשותפת, שמסומן בתווית Provider primary.

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

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

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

  9. בקטע Listing details, בשדה שם לתצוגה, מזינים שם לפריט.

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

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

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

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

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

    • Public discoverability: הפעילו את ההגדרה הזו כדי שמשתמשים יוכלו למצוא את הפריט שלכם בקטלוג השיתוף של BigQuery. אם מפעילים את האפשרות הזו, צריך להקצות ל-allUsers או ל-allAuthenticatedUsers את התפקיד "צפייה ב-Analytics Hub" ‏(roles/analyticshub.viewer). מידע נוסף זמין במאמר הקצאת התפקיד לצורך רישום. אם ה-Exchange כבר ציבורי, דף האפליקציה יורש את ההרשאות האלה ולא נדרשת פעולה נוספת.

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

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

    • ‫Documentation > Markdown: מזינים מסמכי תיעוד, קישורים או הוראות שיעזרו למנויים להשתמש במערך הנתונים.

  11. בקטע Listing contact information, מזינים את הפרטים האופציונליים הבאים:

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

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

    • Provider: מרחיבים את הקטע Provider וממלאים את הפרטים בשדות הבאים:

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

      המנויים יכולים לסנן את הנתונים לפי ספק הנתונים.

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

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

  12. מעיינים בקטע תצוגה מקדימה של דף האפליקציה בחנות.

  13. כדי לפרסם את דף האפליקציה, לוחצים על פרסום.

שיתוף פרוצדורה מאוחסנת ב-SQL בין כרטיסי מוצר

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

הרשאת מנוי

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

הרשאת ספק

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

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

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

איך נותנים למשתמשים גישה לדף אפליקציה

כדי לתת גישה לפריט פרטי, צריך להגדיר את מדיניות ה-IAM של הפריט כך שתכלול אנשים או קבוצות ספציפיים. כדי לפרסם רשימה מסחרית, המרכז להעברת נתונים חייב להיות ציבורי. רשומות במאגר נתונים ציבורי מופיעות ב-BigQuery sharing לכל משתמשיGoogle Cloud (allAuthenticatedUsers). כדי לאפשר למשתמשים לעיין ברשומות מסחריות ולבקש גישה אליהן, צריך לתת להם את התפקיד "צפייה ב-Analytics Hub" (roles/analyticshub.viewer). כדי לאפשר למשתמשים להירשם לרשומות מסחריות, צריך לתת להם את התפקיד "מינוי ל-Analytics Hub" (roles/analyticshub.subscriber). ברשומות מסחריות שמשולבות ב-Cloud Marketplace, התפקיד "מינוי ל-Analytics Hub" ניתן באופן אוטומטי ב-BigQuery sharing על סמך ההזמנות ב-Cloud Marketplace.

כדי שכולם יוכלו לגשת לנתונים שאתם מפרסמים, כולל אנשים שאין להם חשבוןGoogle Cloud , אתם צריכים לתת ל-allUsers את התפקיד "צפייה ב-Analytics Hub" ‏ (roles/analyticshub.viewer).

כדי לתת למשתמשים גישה לצפייה או להרשמה ל-listing, פועלים לפי השלבים הבאים:

המסוף

  1. עוברים לדף Sharing (Analytics Hub).

    מעבר אל Sharing (Analytics Hub)

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

  3. לוחצים על הפרופיל שרוצים לשתף.

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

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

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

    • אם בחרתם בפריט פרטי, הזינו את כתובות האימייל של הזהויות שאתם רוצים לתת להן גישה.

    • כדי שהאפליקציה תהיה גלויה לכולם, מזינים allAuthenticatedUsers.

    • כדי שהאפליקציה תהיה גלויה לכולם, כולל משתמשים שלא שייכים ל-Google Cloud, מזינים allUsers.

  7. בתפריט Select a role, מעבירים את העכבר מעל מאגר הניתוחים ב-Analysis ובוחרים תפקיד בהתאם לסוג כרטיס המידע:

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

    • לרשימה פרטית או ציבורית לא מסחרית, בוחרים באפשרות Analytics Hub Subscriber. התפקיד הזה מאפשר למשתמשים להירשם לדף האפליקציה שלכם בחנות.

    • בפריטי מידע שמשולבים ב-Cloud Marketplace, לא צריך להקצות את התפקיד "מנוי ב-Analytics Hub" (roles/analyticshub.subscriber). המינויים מנוהלים באופן אוטומטי על סמך ההזמנה ב-Cloud Marketplace.

    למידע נוסף, קראו את המאמר תפקידי מנוי וצפייה ב-Analytics Hub.

  8. כדי לשמור את ההרשאות, לוחצים על שמירה.

API

  1. קוראים את המדיניות הקיימת באמצעות השיטה projects.locations.dataExchanges.listings.getIamPolicy:

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

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

    • ‫PROJECT_ID: מזהה הפרויקט, לדוגמה my-project-1.
    • LOCATION: המיקום של המאגר שבו נמצא ה-listing.
    • ‫DATAEXCHANGE_ID: המזהה של המאגר להחלפת נתונים.
    • ‫LISTING_ID: מזהה דף האפליקציה.

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

  2. כדי להוסיף או להסיר חברים והתפקידים שמשויכים אליהם, עורכים את קובץ ה-JSON של המדיניות באמצעות כלי לעריכת טקסט. מציינים את החברים באמצעות הפורמטים הבאים:

    • user:test-user@gmail.com
    • group:admins@example.com
    • serviceAccount:test123@example.domain.com
    • domain:example.domain.com

    לדוגמה, כדי להקצות את התפקיד roles/analyticshub.subscriber ל-group:subscribers@example.com, מוסיפים את הקישור הבא למדיניות:

    {
"members": [
 "group:subscribers@example.com"
],
"role":"roles/analyticshub.subscriber"
}

  3. מעדכנים את המדיניות באמצעות קריאה ל-projects.locations.dataExchanges.listings.setIamPolicy method. בגוף הבקשה, מעבירים את מדיניות ה-IAM המעודכנת מהשלב הקודם.

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

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

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

יצירת כתובת URL לא מאומתת לדף אפליקציה שגלוי לכולם

כדי ליצור כתובת URL של דף פריט לשיתוף ב-BigQuery בלי אימות, שמשתמשים בלי חשבון Google Cloud יכולים לראות, צריך לפעול לפי השלבים הבאים:

  1. עוברים לדף Sharing (Analytics Hub).

    מעבר אל Sharing (Analytics Hub)

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

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

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

  4. לוחצים על העתקת הקישור שגלוי לכולם. כדי לוודא שמשתמשים חיצוניים יכולים לראות את הנתונים, צריך לוודא שהתפקיד "צפייה ב-Analytics Hub"‏ (roles/analyticshub.viewer) מוקצה ל-allUsers.

יצירת אדמין של דף האפליקציה

כדי לאפשר למשתמשים לנהל כרטיסי מוצר, אתם יכולים ליצור אדמינים של כרטיסי מוצר על ידי הקצאת התפקיד בעל תוכן דיגיטלי ב-Analytics Hub או אדמין של כרטיסי מוצר ב-Analytics Hub למשתמשים האלה בכרטיס המוצר. במאמר הקצאת תפקיד למוצר מוסבר איך מקצים תפקידים למוצר.

הצגת כל המינויים

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

המסוף

  1. עוברים לדף Sharing (Analytics Hub).

    מעבר אל Sharing (Analytics Hub)

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

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

  4. כדי לראות את כל המנויים של דף האפליקציה, לוחצים על ניהול המינויים:

    האפשרות 'ניהול המינויים' מודגשת בפריט של BigQuery sharing.

  5. אופציונלי: אתם יכולים לסנן את התוצאות לפי פרטי המנויים.

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

  1. נכנסים לדף BigQuery.

    כניסה ל-BigQuery

  2. בחלונית הימנית, לוחצים על Explorer:

    כפתור מודגש לחלונית Explorer.

    אם החלונית השמאלית לא מוצגת, לוחצים על Expand left pane כדי לפתוח אותה.

  3. בחלונית Explorer, מרחיבים את שם הפרויקט, לוחצים על Datasets ואז על השם של מערך הנתונים המשותף.

  4. ברשימה שיתוף, לוחצים על ניהול המינויים.

SQL

בדוגמה הבאה נעשה שימוש בתצוגה INFORMATION_SCHEMA.SCHEMATA_LINKS כדי להציג את כל מערכי הנתונים המקושרים שמקושרים למערך נתונים משותף ב-myproject שנמצאים באזור us:

SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

הפלט אמור להיראות כך: חלק מהעמודות הושמטו כדי לפשט את הפלט.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg                |
| myproject      | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg                |
| myproject      | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

בקטלוג עם כמה אזורים, אפשר לראות את המינויים באזורים שונים על ידי החלפת האזור us במיקום הרפליקה הרצוי. לדוגמה, כדי להציג את מערכי הנתונים המקושרים שמקושרים למערך נתונים משותף ב-myproject שנמצאים באזור eu, משתמשים בשאילתה הבאה:

SELECT * FROM `myproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

API

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

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:listSubscriptions

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

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

הסרת מינוי

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

כדי להסיר מהדף שלכם מינוי שנוצר לפני 25 ביולי 2023:

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

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

  3. בתיבת הדו-שיח Remove subscription?‎, מקלידים remove כדי לאשר את המחיקה.

  4. לוחצים על הסרה.

כדי להסיר מינוי שנוצר אחרי 25 ביולי 2023:

המסוף

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

  2. לוחצים על מינויים.

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

  4. בתיבת הדו-שיח Remove subscription?‎, מקלידים remove כדי לאשר את ההסרה.

  5. לוחצים על הסרה.

API

מפעילים את ה-method‏ projects.locations.subscriptions.revoke:

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

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

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

עדכון של דף פרטי העסק

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

אם בפרויקט Google Cloud נעשה שימוש בגבולות גזרה לשירות של VPC Service Controls, יכול להיות שתצטרכו להגדיר כללים נוספים לתעבורת נתונים נכנסת ויוצאת כדי לאפשר לסנכרון ברקע לעדכן את מערכי הנתונים המקושרים המשויכים.

כדי לעדכן דף אפליקציה:

המסוף

  1. עוברים לדף Sharing (Analytics Hub).

    מעבר אל Sharing (Analytics Hub)

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

  3. לוחצים על דף האפליקציה שרוצים לעדכן.

  4. לוחצים על עריכת דף האפליקציה בחנות.

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

  6. אופציונלי: מעדכנים את הגדרות דף האפליקציה ואת הזמינות:

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

  7. בודקים את התצוגה המקדימה של דף האפליקציה.

  8. כדי לשמור את השינויים, לוחצים על שמירה. אם מעדכנים דף מוצר שמשולב ב-Cloud Marketplace, מופיעה התראה שבה מתבקשים לעדכן גם את דף מוצר הנתונים ב-Cloud Marketplace.

API

מפעילים את ה-method‏ projects.locations.dataExchanges.listings.patch:

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

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

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

בגוף הבקשה, מציינים את הערכים המעודכנים של השדות במסכת העדכון:

  • displayName
  • description
  • primaryContact
  • documentation
  • icon
  • categories[]
  • discoveryType
  • logLinkedDatasetQueryUserEmail
  • bigqueryDataset.replicaLocations

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

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

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

כדי להגביר את החשיפה של הנתונים בקטלוג של BigQuery sharing, אתם יכולים להציג אותם בקטע Featured. הכרטיסים המוצגים כפופים ל Google Cloud הסכם תוכנית השותפים.

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

  • הנתונים המשותפים צריכים להיות ב-BigQuery.

  • אתם צריכים להיות רשומים לתוכניתGoogle Cloud Partner Network במסלול שותף טכנולוגי ב-Google Cloud.

  • צריך ליצור את דף האפליקציה ולהפעיל את האפשרות גלוי לכולם.

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

מחיקת דף אפליקציה

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

אי אפשר למחוק פריטים שמשולבים ב-Cloud Marketplace ויש להם מינויים מסחריים פעילים. לפני שמוחקים את המוצר, צריך לבטל את כל המינויים המסחריים.

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

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

כדי למחוק דף אפליקציה:

המסוף

  1. עוברים לדף Sharing (Analytics Hub).

    מעבר אל Sharing (Analytics Hub)

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

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

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

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

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

API

מפעילים את ה-method‏ projects.locations.dataExchanges.listings.delete:

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

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

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

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

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