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

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

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

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

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

כדי להתחיל להשתמש ב-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) לשיתוף ב-BigQuery:

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

  • התפקיד Analytics Hub Listing Admin (roles/analyticshub.listingAdmin), שמאפשר לכם לעדכן, למחוק ולהגדיר מדיניות IAM ברשימות שלכם.

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

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

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

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

צפייה בהחלפות נתונים

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

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

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

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

המסוף

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

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

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

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

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

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

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

      1. בתפריט Shared dataset (מערך נתונים משותף), בוחרים מערך נתונים קיים או לוחצים על Create a dataset (יצירת מערך נתונים) כדי ליצור מערך נתונים חדש. בוחרים את מערך הנתונים שרוצים לפרסם בבורסת הנתונים. מערך הנתונים צריך להיות באותו אזור כמו מרכז הנתונים. אי אפשר לעדכן את השדה הזה אחרי שיוצרים את דף האפליקציה. שם מערך הנתונים של המקור ומזהה הפרויקט שמכיל את מערך הנתונים מוחזרים כשמנויים ל-BigQuery sharing צופים במטא-נתונים של מערך הנתונים המקושר שלהם.

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

      3. כדי שמערך הנתונים המשותף יהיה זמין באזורים נוספים, מרחיבים את התפריט Region data availability (תצוגה מקדימה). בתפריט מוצגים האזורים שבהם קיימות רפליקות של מערך הנתונים עם התווית מוכן לשימוש. לפני שמגדירים את הרישום למספר אזורים, צריך לוודא שהפעלתם שכפול של מערכי נתונים באזורים שונים במערך הנתונים המשותף, כי אפשר לבחור רק אזורים שבהם מופעל שכפול של מערכי נתונים באזורים שונים. כל שאר האזורים מסומנים כלא זמינים. אם לא בוחרים אזור נוסף, כברירת מחדל הכרטיס משתמש באזור הראשי של מערך הנתונים המשותף, שמסומן כהאזור הראשי של הספק.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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: המיקום של חילופי הנתונים. מידע נוסף על מיקומים שתומכים בשיתוף ב-BigQuery זמין במאמר בנושא אזורים נתמכים.
  • DATAEXCHANGE_ID: מזהה חילופי הנתונים.
  • LISTING_ID: מזהה כרטיס המוצר.

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

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

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

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

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

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

  1. במסוף Google Cloud , עוברים לדף BigQuery.

    כניסה לדף BigQuery

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

  3. לוחצים על שיתוף > פרסום ככרטיס.

    תיבת הדו-שיח Create listing (יצירת כרטיס מוצר) תיפתח.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

שיתוף של תהליך מאוחסן של SQL בתוך כרטיס מוצר

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

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

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

הרשאה לספק

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

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

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

איך מעניקים למשתמשים גישה לדף עסקי

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

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

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

המסוף

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

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

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

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

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

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

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

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

    • אם הרישום גלוי לכולם, מוסיפים allAuthenticatedUsers.

    • כדי שהכרטיסייה תהיה ציבורית וכל אחד יוכל לראות אותה, כולל משתמשים שלא משתמשים ב-Google Cloud allUsers, צריך להוסיף אותה.

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

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

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

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

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

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

API

  1. קוראים את המדיניות הקיימת באמצעות השיטה getIamPolicy של הרישום באמצעות השיטה 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: המיקום של חילופי הנתונים שמכילים את כרטיס המוצר.
    • DATAEXCHANGE_ID: מזהה חילופי הנתונים.
    • LISTING_ID: מזהה כרטיס המוצר.

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

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

    • 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. בגוף הבקשה, מציינים את מדיניות ה-IAM המעודכנת מהשלב הקודם.

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

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

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

יצירת כתובת URL לא מאומתת לפרסום ציבורי

כדי ליצור כתובת URL של BigQuery sharing שלא דורשת אימות ושאפילו משתמשים שלא רשומים ב-Google Cloud יכולים לראות אותה:

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

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

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

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

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

  4. לוחצים על העתקת קישור שגלוי לכולם כדי ליצור כתובת URL של כרטיס מוצר שלא דורשת אימות. מוודאים שהרשימה הזו מעניקה את התפקיד 'צפייה ב-Analytics Hub' (roles/analyticshub.viewer) למשתמש allUsers.

יצירת אדמין של כרטיס מוצר

כדי לאפשר למשתמשים לנהל את כרטיסי המוצר, צריך ליצור אדמינים של כרטיסי מוצר. כדי ליצור אדמינים של כרטיסי מוצר, צריך לתת למשתמשים את תפקיד ה-IAM‏ Analytics Hub Publisher או Analytics Hub Listing Admin ברמת כרטיס המוצר. מידע נוסף על מתן התפקידים האלה לכרטיס מוצר זמין במאמר הקצאת תפקיד לכרטיס מוצר.

עיון בכל המינויים

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

המסוף

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

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

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

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

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

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

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

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

  1. עוברים לדף BigQuery.

    כניסה ל-BigQuery

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

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

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

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

  4. ברשימה Sharing, בוחרים באפשרות Manage subscriptions (ניהול המינויים).

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/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:listSubscriptions

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

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

הסרת מינוי

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

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

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

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

  3. בתיבת הדו-שיח הסרת המינוי?, מזינים remove כדי לאשר.

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

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

המסוף

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

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

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

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

  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: המזהה של המינוי שרוצים להסיר.

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

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

המסוף

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

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

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

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

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

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

  6. אופציונלי:

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

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

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

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

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

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

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

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

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

מחיקת דף מוצר

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

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

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

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

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

המסוף

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

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

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

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

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

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

  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

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

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

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

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

  • הם צריכים להיות רשומים לתוכנית Partner Advantage עם סיווג Build.

  • צריך ליצור את כרטיס המוצר ולהפעיל בו את האפשרות גילוי ציבורי.

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

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