ניהול דפי מידע מקומיים
במאמר הזה מוסבר איך לנהל כרטיסי מוצר בשיתוף BigQuery (לשעבר Analytics Hub). מוציאים לאור שמשתמשים ב-BigQuery sharing יכולים:
- ליצור כרטיסי מוצר בבורסת נתונים שיש לכם הרשאת פרסום בה.
- עדכון, מחיקה, שיתוף וצפייה במדדי השימוש של כרטיסי מוצר.
- ניהול תפקידי שיתוף שונים ב-BigQuery לכרטיסי המוצר, כמו אדמינים של כרטיסי מוצר, מנויים וצופים.
- אפשר לראות את כל המנויים שנרשמו לכרטיס המוצר שלכם.
- מעקב אחר השימוש בכרטיסי המוצר.
- הסרת מנויים מהרשימה.
רשימת נתונים היא הפניה למערך נתונים משותף שבעל אפליקציה מפרסם במרכז נתונים. יש שני סוגים של כרטיסי מוצר, בהתאם למדיניות של ניהול זהויות והרשאות גישה (IAM) שמוגדרת לכרטיס המוצר ולסוג אוסף הנתונים לשיתוף שמכילים את כרטיס המוצר:
כרטיס ציבורי. משתמשי Cloud de Confiance by S3NS (
allAuthenticatedUsers) יכולים לגלות ולהירשם לרשימות ציבוריות. רשימות בבורסת נתונים ציבורית הן רשימות ציבוריות. הרישומים האלה יכולים להיות הפניות לקבוצת נתונים ציבורית חינמית או לקבוצת נתונים מסחרית. אם הרישום הוא של מערך נתונים מסחרי, מנויים של BigQuery sharing יכולים לבקש גישה לרישום ישירות מספק הנתונים, או לעיין ברישומים מסחריים שמשולבים ב-Google Cloud Marketplace ולרכוש אותם.כרטיס מוצר פרטי. רישום פרטי משותף ישירות עם אנשים או קבוצות. לדוגמה, יכול להיות שרשימת מוצרים פרטית תפנה למערך נתונים של מדדי שיווק ששיתפתם עם צוותים פנימיים אחרים בארגון. גם אם מאפשרים Cloud de Confiance by S3NS למשתמשים (
allAuthenticatedUsers) להירשם למינוי של כרטיס המוצר, הוא יישאר פרטי ולא יוצג ככרטיס מוצר ציבורי בדף השיתוף של BigQuery. כדי לשתף כרטיסי מוצר כאלה עם משתמשים, צריך לשתף איתם את כתובת ה-URL של כרטיס המוצר. כדי להפוך כרטיס מוצר פרטי לגלוי, צריך להגדיר את ההחלפה כגלוי לכולם.
לפני שמתחילים
כדי להתחיל להשתמש ב-BigQuery sharing (לשעבר Analytics Hub), צריך להפעיל את Analytics Hub API בתוך Cloud de Confiance by S3NS הפרויקט.
כדי להפעיל את Analytics Hub API, אתם צריכים את ההרשאות הבאות בממשק של ניהול הזהויות והרשאות הגישה (IAM):
serviceUsage.services.getserviceUsage.services.listserviceUsage.services.enable
תפקיד ה-IAM המוגדר מראש הבא כולל את ההרשאות שנדרשות להפעלת Analytics Hub API:
- אדמין בשימוש בשירות (
roles/serviceusage.serviceUsageAdmin)
כדי להפעיל את Analytics Hub API, בוחרים באחת מהאפשרויות הבאות:
המסוף
עוברים לדף Analytics Hub API ומפעילים את Analytics Hub API בפרויקט שלכם ב- Cloud de Confiance .
gcloud
מריצים את הפקודה gcloud services enable:
gcloud services enable analyticshub.googleapis.com
התפקידים הנדרשים
כדי לנהל כרטיסי מוצר ומינויים, אתם צריכים אחד מהתפקידים הבאים ב-IAM לשיתוף ב-BigQuery:
התפקיד Analytics Hub Publisher (
roles/analyticshub.publisher), שמאפשר לכם ליצור, לעדכן ולמחוק את כרטיסי המוצר ולהגדיר מדיניות IAM לגביהם.התפקיד 'אדמין של כרטיסי מוצר ב-Analytics Hub' (
roles/analyticshub.listingAdmin), שמאפשר לכם לעדכן ולמחוק את כרטיסי המוצר ולהגדיר מדיניות IAM לגביהם.תפקיד האדמין ב-Analytics Hub (
roles/analyticshub.admin), שמאפשר לכם ליצור, לעדכן, למחוק ולהגדיר מדיניות IAM בכל הרשימות באוסף הנתונים לשיתוף שלכם.
מידע נוסף זמין במאמר בנושא תפקידי IAM לשיתוף ב-BigQuery. במאמר יצירת אדמין של דף עסקי מוסבר איך מקצים את התפקידים האלה למשתמשים אחרים.
כדי ליצור כרטיסי מוצר או לעדכן אזורי העתקה של כרטיס מוצר, צריך הרשאות bigquery.datasets.get ו-bigquery.datasets.update למערכי הנתונים שבהם רוצים ליצור או לעדכן כרטיסי מוצר. התפקידים המוגדרים מראש ב-BigQuery הבאים כוללים את ההרשאה bigquery.datasets.update:
- בעלים של נתונים ב-BigQuery
(
roles/bigquery.dataOwner) - BigQuery Admin
(
roles/bigquery.admin)
כדי לראות את כל חילופי הנתונים בין פרויקטים בארגון שיש לכם גישה אליהם, אתם צריכים את ההרשאה resourcemanager.organizations.get.
אין תפקידים מוגדרים מראש ב-BigQuery שכוללים את ההרשאה הזו, ולכן תצטרכו להשתמש בתפקיד מותאם אישית ב-IAM.
הצגת החלפות נתונים
כדי לראות את רשימת מרכזי הנתונים בארגון שלכם שיש לכם גישה אליהם, אפשר לעיין במאמר הצגת מרכזי נתונים. אם חילופי הנתונים מתבצעים בארגון אחר, מנהל השיתוף ב-BigQuery צריך לשתף איתכם קישור לחילופי הנתונים האלה.
יצירת דף אפליקציה
רישום הוא הפניה למערך נתונים משותף שספק BigQuery sharing מפרסם באוסף נתונים לשיתוף.
כדי ליצור כרטיס מוצר, פועלים לפי השלבים הבאים:
המסוף
עוברים לדף שיתוף (מרכז Analytics).
מעבר אל 'שיתוף' (Analytics Hub)
יופיע דף עם רשימה של כל חילופי הנתונים שיש לכם גישה אליהם.
לוחצים על השם של אוסף הנתונים לשיתוף שבו רוצים ליצור את כרטיס המוצר.
לוחצים על יצירת כרטיס מוצר.
בקטע הגדרת נתונים, בתפריט סוג המשאב, בוחרים באפשרות מערך נתונים של BigQuery או נושא Pub/Sub.
אם בוחרים באפשרות מערך נתונים ב-BigQuery, מבצעים את הפעולות הבאות:
בתפריט Shared dataset (מערך נתונים משותף), בוחרים מערך נתונים קיים או לוחצים על Create a dataset (יצירת מערך נתונים) כדי ליצור מערך נתונים חדש. בוחרים את מערך הנתונים שרוצים לפרסם באוסף הנתונים לשיתוף. קבוצת הנתונים צריכה להיות באותו אזור כמו אוסף הנתונים לשיתוף. אי אפשר לעדכן את השדה הזה אחרי שיוצרים את דף האפליקציה. שם מערך הנתונים של המקור ומזהה הפרויקט שמכיל את מערך הנתונים מוחזרים כשמנויים לשיתוף ב-BigQuery צופים במטא-נתונים של מערך הנתונים המקושר שלהם.
אופציונלי: כדי לאפשר למנויים לשתף תהליך מאוחסן של SQL בתוך כרטיס מוצר, בוחרים באפשרות Allow stored procedure sharing (מאפיין בתצוגה מקדימה).
כדי שמערך הנתונים המשותף יהיה זמין באזורים נוספים, מרחיבים את התפריט זמינות נתונים באזור. בתפריט מוצגים האזורים שבהם קיימות רפליקות של מערך הנתונים עם התווית מוכן לשימוש. לפני שמגדירים את הרישום למספר אזורים, צריך לוודא שהפעלתם שכפול של מערכי נתונים באזורים שונים במערך הנתונים המשותף, כי אפשר לבחור רק אזורים שבהם מופעל שכפול של מערכי נתונים באזורים שונים. כל שאר האזורים מסומנים כלא זמינים. אם לא בוחרים אזור נוסף, כברירת מחדל הכרטיס משתמש באזור הראשי של מערך הנתונים המשותף, שמסומן כהאזור הראשי של הספק.
בקטע אמצעי בקרה של תעבורת נתונים יוצאת (egress), בוחרים את האפשרות המתאימה להעברת נתונים.
- כדי להחיל הגבלות על תעבורת נתונים יוצאת (egress) במערך הנתונים המשותף, אבל לא על תוצאות השאילתות של מערך הנתונים המשותף, בוחרים באפשרות השבתת ההעתקה והייצוא של נתונים משותפים.
- כדי להחיל הגבלות על תעבורת נתונים יוצאת (egress) במערך הנתונים המשותף ובתוצאות השאילתות של מערך הנתונים המשותף, בוחרים באפשרות השבתת ההעתקה והייצוא של תוצאות השאילתות. כך גם האפשרות השבתת ההעתקה והייצוא של נתונים משותפים תוגדר אוטומטית.
- כדי להחיל הגבלות על העתקה וייצוא של נתונים באמצעות API במערך הנתונים המשותף, בוחרים באפשרות השבתת העתקה וייצוא של טבלאות באמצעות API. פעולה זו תגדיר אוטומטית גם את האפשרות השבתת העתקה וייצוא של נתונים משותפים.
למידע נוסף על אמצעי בקרה ליציאת נתונים, כולל הגבלות, אפשר לעיין במאמר בנושא אפשרויות ליציאת נתונים (רק במערכי נתונים משותפים של BigQuery).
אם בוחרים באפשרות Pub/Sub Topic, בתפריט Shared topic אפשר לבחור נושא קיים ב-Pub/Sub או ללחוץ על Create a topic כדי ליצור נושא חדש.
בקטע פרטי כרטיס המוצר, בשדה שם מוצג, מזינים את שם כרטיס המוצר.
מזינים את הפרטים האופציונליים הבאים:
קטגוריה: בוחרים עד שתי קטגוריות שמתארות בצורה הטובה ביותר את כרטיס המוצר. מנויים לשיתוף ב-BigQuery יכולים לסנן את כרטיסי המוצר לפי הקטגוריות האלה.
זיקה לנתונים: האזורים שבהם משתמש המפרסם של BigQuery sharing כדי לפרסם את הנתונים, אם אתם משתמשים בנושא Pub/Sub. המידע הזה שימושי למנויים של BigQuery sharing כדי למזער את העלויות של תעבורת נתונים יוצאת ברשת Pub/Sub או להימנע מהן, על ידי קריאת הנתונים מאותו אזור. מידע נוסף על עלויות יציאה מפורט במאמר בנושא עלויות העברת נתונים.
סמל: סמל לכרטיס המוצר. אפשר להשתמש בפורמטים PNG ו-JPEG. גודל הקובץ של הסמלים צריך להיות קטן מ-512 KiB, והמידות שלהם צריכות להיות עד 512 x 512 פיקסלים.
תיאור: תיאור קצר של כרטיס המוצר. המנויים יכולים לחפש כרטיסי מוצר על סמך התיאור.
גילוי ציבורי: הפעלת גילוי ציבורי של כרטיס המוצר בקטלוג השיתוף של BigQuery. אם מפעילים את האפשרות הזו, צריך להעניק את התפקיד 'צפייה ב-Analytics Hub' (
roles/analyticshub.viewer) למשתמשיםallUsersאוallAuthenticatedUsers. מידע נוסף זמין במאמר הענקת התפקיד לכרטיס מוצר. אם הבורסה כבר ציבורית, הרשאות הרישום כבר מועברות בירושה ולא נדרשת פעולה נוספת.בבורסות גלויות לכולם אי אפשר לפרסם מלאי שטחי פרסום פרטי בגלל ירושת הרשאות, אבל בבורסות פרטיות אפשר לפרסם מלאי שטחי פרסום גלוי לכולם. כדי ליצור כרטיסי מוצר ציבוריים, לפרויקט שבו נמצא כרטיס המוצר של הנתונים צריך להיות משויך ארגון וחשבון לחיוב. אם אתם יוצרים כרטיס מוצר מסחרי שמשולב ב-Cloud Marketplace, מומלץ להגדיר את כרטיס המוצר כך שיהיה גלוי לכולם.
רישום ביומן של כתובות אימייל של מנויים: הפעלת רישום ביומן של מזהי העיקרון של כל המשתמשים שמריצים משימות ושאילתות במערכי נתונים מקושרים. אם מפעילים את האפשרות הזו, רישום כתובות האימייל של המנויים מופעל בכל המינויים העתידיים של כרטיס המוצר הזה. הנתונים שנרשמו ביומן זמינים בשדה
job_principal_subjectבתצוגהINFORMATION_SCHEMA.SHARED_DATASET_USAGE.מסמכים > Markdown: מידע נוסף, כמו קישורים למסמכים רלוונטיים וכל מידע נוסף שיכול לעזור למנויים של BigQuery sharing להשתמש בנושא.
בקטע פרטים ליצירת קשר בדף האפליקציה בחנות, מזינים את הפרטים האופציונליים הבאים:
איש קשר ראשי: מזינים מזהה אימייל או כתובת URL של איש הקשר הראשי של כרטיס המוצר.
בקשה ליצירת קשר לצורך גישה: מזינים מזהה אימייל או כתובת URL של טופס קליטת מידע כדי שמנויים שמשתפים נתונים ב-BigQuery יוכלו ליצור איתכם קשר.
ספק: מרחיבים את הקטע ספק ומזינים פרטים בשדות הבאים:
- Provider name: השם של ספק הנושא.
- איש הקשר הראשי של הספק: מזהה אימייל או כתובת URL של איש הקשר הראשי של ספק הנושא.
מנויים יכולים לסנן את כרטיסי המוצר לפי ספקי הנתונים.
בעל תוכן דיגיטלי: מרחיבים את הקטע בעל תוכן דיגיטלי ומציינים פרטים בשדות הבאים:
- שם בעל האפליקציה: השם של בעל האפליקציה שמשתף את הנתונים ב-BigQuery ויוצר את כרטיס המוצר.
- איש הקשר הראשי של בעל התוכן הדיגיטלי: מזהה אימייל או כתובת URL של איש הקשר הראשי של בעל התוכן הדיגיטלי בנושא.
בודקים את הקטע תצוגה מקדימה של כרטיס המוצר.
לוחצים על פרסום.
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.
יצירת כרטיס מוצר מקבוצת נתונים
אפשר גם ליצור כרטיס מוצר ממערך נתונים באופן הבא:
במסוף Cloud de Confiance , עוברים לדף BigQuery.
לוחצים על מערך נתונים כדי לראות את הפרטים שלו.
לוחצים על שיתוף > פרסום ככרטיס מוצר.
תיבת הדו-שיח Create listing (יצירת כרטיס מוצר) תיפתח.
בוחרים את אוסף הנתונים לשיתוף שבו רוצים לפרסם את כרטיס המוצר הזה. החלפת הנתונים צריכה להתבצע באותו אזור שבו נמצא מערך הנתונים. מידע נוסף על יצירת אוסף נתונים לשיתוף זמין במאמר יצירת אוסף נתונים לשיתוף והגדרת הרשאות.
בתפריט Shared dataset (קבוצת נתונים משותפת), בוחרים קבוצת נתונים קיימת או לוחצים על Create a dataset (יצירת קבוצת נתונים) כדי ליצור קבוצת נתונים חדשה. בוחרים את מערך הנתונים שרוצים לפרסם בבורסת הנתונים. מערך הנתונים צריך להיות באותו אזור שבו נמצאת פלטפורמת חילופי הנתונים. אי אפשר לעדכן את השדה הזה אחרי שיוצרים את דף האפליקציה.
כשמנויים לשיתוף ב-BigQuery צופים במטא-נתונים של מערך הנתונים המקושר שלהם, הם רואים את השם של מערך הנתונים של המקור ואת המזהה של הפרויקט שמכיל את מערך הנתונים.
אופציונלי: כדי לאפשר למנויים לשתף תהליך מאוחסן של SQL בתוך כרטיס מוצר, בוחרים באפשרות Allow stored procedure sharing (מאפיין בתצוגה מקדימה).
כדי שמערך הנתונים המשותף יהיה זמין באזורים נוספים, מרחיבים את התפריט Region data availability (זמינות נתונים באזור). בתפריט מוצגים האזורים שבהם קיימות רפליקות של מערך הנתונים עם התווית Ready to use (מוכן לשימוש). לפני שמגדירים את כרטיס המוצר למספר אזורים, צריך לוודא שהפעלתם שכפול של מערכי נתונים באזורים שונים במערך הנתונים המשותף, כי אפשר לבחור רק אזורים שבהם האפשרות הזו מופעלת. כל שאר האזורים מסומנים כלא זמינים. אם לא בוחרים אזור נוסף, כברירת מחדל כרטיס המוצר משתמש באזור של מערך הנתונים המשותף, שמסומן כספק ראשי.
בקטע אמצעי בקרה של תעבורת נתונים יוצאת (egress), בוחרים את האפשרות המתאימה להעברת נתונים.
- כדי להחיל הגבלות על תעבורת נתונים יוצאת (egress) במערך הנתונים המשותף, אבל לא על תוצאות השאילתה של מערך הנתונים המשותף, בוחרים באפשרות השבתת ההעתקה והייצוא של נתונים משותפים.
- כדי להחיל הגבלות על תעבורת נתונים יוצאת (egress) במערך הנתונים המשותף ועל תוצאות השאילתות של מערך הנתונים המשותף, בוחרים באפשרות השבתת ההעתקה והייצוא של תוצאות השאילתות. כך גם האפשרות השבתת ההעתקה והייצוא של נתונים משותפים תוגדר אוטומטית.
- כדי להחיל הגבלות על יציאת נתונים של העתקה וייצוא של Data API על קבוצת הנתונים המשותפת, בוחרים באפשרות השבתת העתקה וייצוא של טבלאות באמצעות ממשקי API, וכך גם האפשרות השבתת העתקה וייצוא של נתונים משותפים תוגדר אוטומטית.
למידע נוסף על אמצעי בקרה ליציאת נתונים, כולל הגבלות, אפשר לעיין במאמר בנושא אפשרויות ליציאת נתונים (רק במערכי נתונים משותפים ב-BigQuery).
בקטע פרטי כרטיס המוצר, בשדה שם מוצג, מזינים את שם כרטיס המוצר.
מזינים את הפרטים האופציונליים הבאים:
קטגוריה: בוחרים עד שתי קטגוריות שמתארות בצורה הטובה ביותר את כרטיס המוצר. מנויים לשיתוף ב-BigQuery יכולים לסנן את כרטיסי המוצר לפי הקטגוריות האלה.
זיקה לנתונים: האזורים שבהם משתמש המפרסם של BigQuery sharing כדי לפרסם את הנתונים. המידע הזה שימושי למנויים של שיתוף ב-BigQuery, כי הוא מאפשר להם לקרוא את הנתונים מאותו אזור וכך להפחית את העלויות של יציאת נתונים מהרשת ב-Pub/Sub או להימנע מהן. מידע נוסף על עלויות יציאה מופיע במאמר עלויות העברת נתונים.
סמל: סמל לכרטיס המוצר. אפשר להשתמש בפורמטים PNG ו-JPEG. גודל הקובץ של הסמלים צריך להיות קטן מ-512 KiB, והמידות שלהם צריכות להיות עד 512 x 512 פיקסלים.
תיאור: תיאור קצר של כרטיס המוצר. מנויים ב-BigQuery sharing יכולים לחפש כרטיסי מוצר על סמך התיאור.
גילוי ציבורי: הפעלת גילוי ציבורי של כרטיס המוצר בקטלוג השיתוף של BigQuery. אם מפעילים את האפשרות הזו, צריך להעניק למשתמשים את התפקיד 'צפייה' ב-Analytics Hub (
roles/analyticshub.viewer) או את ההרשאהallUsersאוallAuthenticatedUsers. מידע נוסף זמין במאמר הענקת תפקיד לכרטיס מוצר. אם הבורסה כבר ציבורית, הרשאות הרישום כבר מועברות בירושה ולא נדרשת פעולה נוספת.בבורסות גלויות לכולם אי אפשר לפרסם מלאי שטחי פרסום פרטי בגלל ירושת הרשאות, אבל בבורסות פרטיות אפשר לפרסם מלאי שטחי פרסום גלוי לכולם. כדי ליצור כרטיסי מוצר ציבוריים, לפרויקט שבו נמצא כרטיס המוצר צריך להיות משויך ארגון וחשבון לחיוב. אם אתם יוצרים כרטיס מוצר מסחרי שמשולב ב-Cloud Marketplace, מומלץ להגדיר את כרטיס המוצר כך שיהיה גלוי לכולם.
רישום ביומן של כתובות אימייל של מנויים: הפעלת רישום ביומן של המזהים העיקריים של מנויים שמריצים משימות ושאילתות במערך הנתונים המקושר של כרטיס המוצר הזה לכל המינויים העתידיים. כשמפעילים את האפשרות הזו, רק מינויים חדשים שנוצרו ירשמו את מזהי הגורם המוסמך. הנתונים שנרשמו זמינים בשדה
job_principal_subjectשל התצוגהINFORMATION_SCHEMA.SHARED_DATASET_USAGE.תיעוד > Markdown: מידע נוסף, כמו קישורים לתיעוד רלוונטי וכל מידע נוסף שיכול לעזור למנויים להשתמש בנושא.
בקטע פרטים ליצירת קשר בדף האפליקציה בחנות, מזינים את הפרטים האופציונליים הבאים:
איש קשר ראשי: מזינים מזהה אימייל או כתובת URL של איש הקשר הראשי של כרטיס המוצר.
בקשת גישה לאיש קשר: מזינים כתובת אימייל או כתובת URL של טופס לקבלת מידע, כדי שהמנויים יוכלו ליצור איתכם קשר.
ספק: מרחיבים את הקטע ספק ומזינים פרטים בשדות הבאים:
- Provider name: השם של ספק הנושא.
- איש הקשר הראשי של הספק: מזהה אימייל או כתובת URL של איש הקשר הראשי של ספק הנושא.
מנויים יכולים לסנן את כרטיסי המוצר לפי ספקי הנתונים.
בעל תוכן דיגיטלי: מרחיבים את הקטע בעל תוכן דיגיטלי ומציינים פרטים בשדות הבאים:
- שם בעל האפליקציה: השם של בעל האפליקציה שמשתף את הנתונים ב-BigQuery ויוצר את כרטיס המוצר.
- איש הקשר הראשי של בעל התוכן הדיגיטלי: מזהה אימייל או כתובת URL של איש הקשר הראשי של בעל התוכן הדיגיטלי בנושא.
בודקים את הקטע תצוגה מקדימה של כרטיס המוצר.
לוחצים על פרסום.
שיתוף של תהליך מאוחסן של SQL בתוך כרטיס מוצר
הערה: כדי לבקש תמיכה או לשלוח משוב על התכונה הזו, אפשר לפנות לכתובת bq-data-sharing-feedback@google.com.כשיוצרים כרטיסי מוצר עם מערכי נתונים של BigQuery, אפשר לשתף פרוצדורות מאוחסנות של SQL. מאחר שפרוצדורות מאוחסנות יכולות ליצור טבלאות, להסיר אותן ולבצע בהן מניפולציות, וגם להפעיל פרוצדורות מאוחסנות אחרות, נדרש אישור נוסף.
הרשאה למנויים
אחרי שנרשמים למינוי של רשימת תפוצה, יכול להיות שהפרוצדורות המאוחסנות המקושרות לא יופעלו ישירות. כדי לוודא שאפשר לגשת לפרוצדורות המאוחסנות המקושרות, המנוי צריך לתקשר עם הספק עם שם מערך הנתונים המקושר, כדי שהספק יאשר את הפרוצדורה המאוחסנת המקושרת במשאבים של הספק. בנוסף, המנוי צריך לתת הרשאה להפעיל את הפרוצדורה המאוחסנת המשותפת המקושרת ולצרף תפקיד IAM למשאבים שבבעלותו כדי לקרוא ולכתוב במשאבים האלה.
הרשאה לספק
כשספק יוצר כרטיס מוצר באמצעות פרוצדורה מאוחסנת, הוא צריך לאפשר למנוי לקרוא ולכתוב בטבלאות שלו באמצעות הפרוצדורה המאוחסנת המקושרת. כדי לוודא זאת, פועלים לפי השלבים הבאים:
בפעולות שאינן קריאה, הספק צריך לאשר את התהליך המאוחסן המקושר ולצרף תפקיד IAM לכל אחד מהמשאבים של הספק שאליהם יש גישה לתהליך המאוחסן המקושר.
בפעולות קריאה, הספק יכול לתת הרשאה להפעיל את הפרוצדורה המאוחסנת המשותפת המקושרת (במערך הנתונים המקושר של המנוי) או את הפרוצדורה המאוחסנת המשותפת המקורית (במערך הנתונים של הספק), ולצרף תפקיד IAM לכל אחד מהמשאבים של הספק שאליהם יש גישה באמצעות הפרוצדורה המאוחסנת המקושרת.
איך מעניקים למשתמשים גישה לדף עסקי
אם רוצים לתת למשתמשים גישה לכרטיס מוצר פרטי, צריך להגדיר מדיניות IAM עבור משתמש או קבוצה ספציפיים בכרטיס המוצר הזה. אם אתם מפרסמים כרטיס מוצר מסחרי, אוסף הנתונים לשיתוף שלכם חייב להיות ציבורי.
כרטיסי מוצר בבורסת נתונים ציבורית מופיעים בשיתוף BigQuery לכל Cloud de Confiance by S3NS המשתמשים (allAuthenticatedUsers). כדי לאפשר למשתמשים לעיין בכרטיסי מוצר מסחריים ולבקש גישה אליהם, צריך להקצות למשתמשים את תפקיד הצפייה ב-Analytics Hub (roles/analyticshub.viewer). כדי לאפשר למשתמשים להירשם לכרטיסי מוצר מסחריים, צריך להקצות למשתמשים באופן מפורש את תפקיד המנוי ב-Analytics Hub (roles/analyticshub.subscriber). לגבי כרטיסי מוצר מסחריים שמשולבים ב-Cloud Marketplace, תפקיד המנוי ב-Analytics Hub מוקצה באופן אוטומטי על סמך ההזמנות ב-Cloud Marketplace.
אם רוצים להפוך את כרטיס המוצר לנגיש לכולם, כולל אנשים שלא משתמשים ב- Cloud de Confiance by S3NS, צריך להעניק ל- Cloud de Confiance by S3NSאת הרשאת הצפייה ב-Analytics Hub (roles/analyticshub.viewer).allUsers
כדי לתת למשתמשים גישה לצפייה בכרטיס העסק או להרשמה לניוזלטר שלו, פועלים לפי השלבים הבאים:
המסוף
עוברים לדף שיתוף (מרכז Analytics).
לוחצים על השם של אוסף הנתונים לשיתוף שכולל את כרטיס המוצר.
לוחצים על כרטיס המוצר שאליו רוצים להוסיף מנויים.
לוחצים על הגדרת הרשאות.
כדי להוסיף גורמים, לוחצים על Add principal.
בשדה New principals, מוסיפים את הפרטים הבאים בהתאם לסוג כרטיס המוצר:
אם מדובר בכרטיס מוצר פרטי, מזינים את מזהי האימייל של הזהות שרוצים להעניק לה גישה.
אם הרישום גלוי לכולם, מוסיפים
allAuthenticatedUsers.כדי שכולם יוכלו לגלות את הרישום, כולל משתמשים שלא שייכים ל-Cloud de Confiance by S3NS
allUsers, מוסיפים אתallUsers.
בשדה Select a role (בחירת תפקיד), מעבירים את מצביע העכבר מעל Analytics Hub, ואז בוחרים אחד מהתפקידים הבאים בהתאם לסוג הכרטיס:
לכרטיס מוצר מסחרי (כולל כרטיסי מוצר שמשולבים ב-Cloud Marketplace), בוחרים בתפקיד Analytics Hub Viewer. התפקיד הזה מאפשר למשתמשים לצפות בכרטיס המוצר ולבקש גישה.
אם הפרופיל פרטי או גלוי לכולם ולשימוש לא מסחרי, בוחרים בתפקיד מנוי ל-Analytics Hub. התפקיד הזה מאפשר למשתמשים להירשם למינוי של דף האפליקציה.
בכרטיסי מוצר שמשולבים ב-Cloud Marketplace, אין צורך להעניק את התפקיד 'מנוי ל-Analytics Hub' (
roles/analyticshub.subscriber), כי המינויים מנוהלים באופן אוטומטי על סמך ההזמנה ב-Cloud Marketplace.
מידע נוסף זמין במאמר בנושא תפקידים של מנויים וצופים ב-Analytics Hub.
לוחצים על Save.
API
קוראים את המדיניות הקיימת באמצעות ה-method
getIamPolicyשל הרישום באמצעות ה-methodprojects.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: מזהה כרטיס המוצר.
השיתוף מחזיר את המדיניות הנוכחית בתגובה.
-
כדי להוסיף או להסיר חברים ואת התפקידים המשויכים שלהם, עורכים את המדיניות באמצעות כלי לעריכת טקסט. כדי להוסיף חברים, צריך להשתמש בפורמט הבא:
user:test-user@gmail.comgroup:admins@example.comserviceAccount:test123@example.domain.comdomain:example.domain.com
לדוגמה, כדי להקצות את התפקיד
roles/analyticshub.subscriberל-group:subscribers@example.com, מוסיפים את הקישור הבא למדיניות:{ "members": [ "group:subscribers@example.com" ], "role":"roles/analyticshub.subscriber" }כותבים את המדיניות המעודכנת באמצעות השיטה
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 שלא דורשת אימות, כך שגם משתמשים שלא רשומים ב-Cloud de Confiance by S3NS יוכלו לראות אותה:
עוברים לדף שיתוף (מרכז Analytics).
מעבר אל 'שיתוף' (Analytics Hub)
יופיע דף עם רשימה של כל חילופי הנתונים שיש לכם גישה אליהם.
לוחצים על השם של אוסף הנתונים לשיתוף שכולל את כרטיס המוצר.
לוחצים על השם לתצוגה כדי לראות את פרטי הכרטיס. צריך להפעיל את ההגדרה גילוי ציבורי בכרטיס המוצר.
לוחצים על העתקת קישור שגלוי לכולם כדי ליצור כתובת URL של כרטיס מוצר שלא דורשת אימות. מוודאים שהרשימה הזו מעניקה את התפקיד 'צפייה ב-Analytics Hub' (
roles/analyticshub.viewer) למשתמשallUsers.
יצירת אדמין של כרטיס מוצר
כדי לאפשר למשתמשים לנהל את כרטיסי המוצר, צריך ליצור אדמינים של כרטיסי מוצר. כדי ליצור אדמינים של כרטיסי מוצר, צריך להעניק למשתמשים את תפקיד IAM Analytics Hub Publisher או Analytics Hub Listing Admin ברמת כרטיס המוצר. מידע נוסף על מתן התפקידים האלה לכרטיס מוצר זמין במאמר איך מעניקים תפקיד לכרטיס מוצר.
עיון בכל המינויים
כדי לראות את כל המינויים הנוכחיים של כרטיס המוצר, בוחרים באחת מהאפשרויות הבאות:
המסוף
עוברים לדף שיתוף (מרכז Analytics).
לוחצים על השם של אוסף הנתונים לשיתוף שכוללים את כרטיס המוצר שרוצים לנהל את המינויים שלו.
לוחצים על הרשומה שרוצים לראות את כל המנויים שלה.
כדי לראות את כל המנויים של כרטיס המוצר, לוחצים על ניהול מינויים.

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

אם החלונית הימנית לא מוצגת, לוחצים על הרחבת החלונית הימנית כדי לפתוח אותה.
בחלונית Explorer, מרחיבים את שם הפרויקט, לוחצים על Datasets ואז לוחצים על השם של מערך הנתונים המשותף.
ברשימה שיתוף, בוחרים באפשרות ניהול המינויים.
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, פועלים לפי השלבים הבאים:
כדי לראות את כל המנויים של כרטיס מוצר, פועלים לפי ההוראות לשימוש במסוף במאמר הצגת כל המינויים. Cloud de Confiance
כדי להסיר מנוי מרשימת התפוצה, לוחצים על מחיקה. אם רוצים להסיר את כל המינויים, לוחצים על הסרת כל המינויים.
בתיבת הדו-שיח הסרת המינוי?, מזינים
removeכדי לאשר.לוחצים על הסרה.
כדי להסיר מינויים שנוצרו אחרי 25 ביולי 2023, פועלים לפי השלבים הבאים:
המסוף
כדי לראות את כל המנויים של כרטיס מוצר, פועלים לפי ההוראות לשימוש במסוף במאמר הצגת כל המינויים. Cloud de Confiance
לוחצים על הכרטיסייה מינויים.
כדי להסיר מנוי מרשימה, בוחרים את המינויים שרוצים להסיר ולוחצים על הסרת מינויים.
בתיבת הדו-שיח הסרת המינוי?, מזינים
removeכדי לאשר.לוחצים על הסרה.
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: המזהה של המינוי שרוצים להסיר.
עדכון כרטיס מוצר
כדי לעדכן כרטיס מוצר:
המסוף
עוברים לדף שיתוף (מרכז Analytics).
לוחצים על השם של אוסף הנתונים לשיתוף שכולל את כרטיס המוצר.
לוחצים על כרטיס העסק שרוצים לעדכן.
לוחצים על עריכת כרטיס העסק.
משנים את הערכים בשדות. אפשר לשנות את כל הערכים חוץ ממערך הנתונים המשותף של כרטיס המוצר.
אופציונלי:
- אם מפעילים את האפשרות 'גילוי ציבורי', צריך להעניק את התפקיד 'צפייה ב-Analytics Hub' (
roles/analyticshub.viewer) למשתמשיםallUsersאוallAuthenticatedUsers. מידע נוסף זמין במאמר בנושא הקצאת תפקיד לכרטיס מוצר. - אם משביתים את האפשרות 'גילוי ציבורי', צריך להסיר את התפקיד 'צפייה ב-Analytics Hub' (
roles/analyticshub.viewer) מ-allUsersומ-allAuthenticatedUsers. בבורסות פתוחות אי אפשר לפרסם מלאי שטחי פרסום פרטי, אבל בבורסות פרטיות אפשר לפרסם מלאי שטחי פרסום פתוח. - אם מפעילים ושומרים את ההגדרה הזו, אי אפשר לערוך אותה. כדי להשבית את רישום האימיילים, מוחקים את הרשימה ויוצרים אותה מחדש בלי ללחוץ על המתג רישום אימיילים של מנויים.
- להוסיף או להסיר אזורים מהכרטיס. לפני שמוסיפים כמה אזורים, צריך לוודא שהפעלתם שכפול של מערכי נתונים באזורים שונים במערך הנתונים המשותף. כשמסירים אזורים, צריך קודם למחוק את העותק של מערך הנתונים המשותף באזור הזה.
- אם מפעילים את האפשרות 'גילוי ציבורי', צריך להעניק את התפקיד 'צפייה ב-Analytics Hub' (
בודקים את התצוגה המקדימה של כרטיס המוצר.
כדי לשמור את השינויים, לוחצים על שמירה. כדי למנוע אי-התאמות עם כרטיסי מוצר משולבים ב-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.
בגוף הבקשה, מציינים ערכים מעודכנים בשדות הבאים:
displayNamedescriptionprimaryContactdocumentationiconcategories[]discoveryTypelogLinkedDatasetQueryUserEmailbigqueryDataset.replicaLocations
פרטים על השדות האלה זמינים במאמר בנושא משאב: כרטיס מוצר.
כשמעדכנים את האזורים המשוכפלים של כרטיס המוצר, חשוב לציין את כל האזורים הרלוונטיים. לפני שמעדכנים את כרטיס המוצר, צריך לוודא שהפעלתם שכפול של מערכי נתונים באזורים שונים במערך הנתונים המשותף. אפשר להוסיף רק אזורים שבהם מערך הנתונים המשותף משוכפל. כדי להסיר אזור, צריך למחוק את העותק של מערך הנתונים המשותף באזור לפני שמסירים אותו מהכרטיס. אפשר גם להמיר כרטיסי מוצר קיימים לכרטיסי מוצר שמיועדים למספר אזורים.
מידע נוסף על המשימות שאפשר לבצע בדפי מידע באמצעות ממשקי API זמין במאמר בנושא שיטות projects.locations.dataExchanges.listings.
מחיקת דף מוצר
כשמוחקים דף עסקי, המנויים כבר לא יכולים לראות את הדף. מחיקת כרטיס מוצר מוחקת גם את כל מערכי הנתונים המקושרים ומסירה את כל המינויים מהפרויקטים של המנויים. אם מערך נתונים עדיין מקושר, צריך להסיר אותו באופן ידני. לשם כך, לוחצים על שיתוף > ניהול המינוי. נפתח הדף מינויים, שבו אפשר להסיר מערך נתונים ספציפי של מנויים או את כל מערכי הנתונים של המנויים בבת אחת.
אי אפשר למחוק כרטיסי מוצר שמשולבים ב-Cloud Marketplace עם מינויים מסחריים פעילים. לבטל את כל המינויים המסחריים לפני שמוחקים את כרטיס המוצר.
מחיקת כרטיס מוצר בכמה אזורים לא מוחקת את העותקים של מערך הנתונים המשותף. אחרי מחיקת כרטיס המוצר בכמה אזורים, המנויים לא יכולים יותר לראות את כרטיס המוצר או לשלוח שאילתות למערכי הנתונים המקושרים. אם אין הפניות לעותקים של מערך הנתונים המשותף ברשימות אחרות, אפשר לבחור למחוק אותם.
לפני שמוחקים כרטיס מוצר בכמה אזורים, חשוב לוודא שאין מינויים פעילים שמשויכים אליו. אם יש מינויים פעילים, צריך קודם לבטל אותם באמצעות השיטה projects.locations.subscriptions.revoke.
אחרי שמסירים את כל המינויים הפעילים, אפשר להמשיך למחיקת כרטיס המוצר בכמה אזורים.
כדי למחוק כרטיס מוצר, פועלים לפי השלבים הבאים:
המסוף
עוברים לדף שיתוף (מרכז Analytics).
לוחצים על השם של אוסף הנתונים לשיתוף שכולל את כרטיס המוצר.
לוחצים על הרשומה שרוצים למחוק.
לוחצים על מחיקה.
בתיבת הדו-שיח למחוק את כרטיס העסק?, מקלידים מחיקה כדי לאשר את המחיקה.
לוחצים על 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, כרטיסי מוצר יכולים להופיע בקטע מומלצים. הכללים שחלים על כרטיסי מוצר מומלצים מפורטים Cloud de Confiance בהסכם תוכנית השותפים.
שותפים שמעוניינים שהכרטיסים שלהם יופיעו בקטע מומלצים בקטלוג BigQuery sharing צריכים לעמוד בקריטריונים הבאים:
הנתונים המשותפים צריכים להיות ב-BigQuery.
הם חייבים להיות רשומים לתוכניתCloud de Confiance by S3NS Partner Network במסלול שותפי הטכנולוגיה של Google Cloud.
צריך ליצור את כרטיס המוצר ולהפעיל בו את האפשרות גילוי מוצר ציבורי.
כדי לבקש שהדף העסקי שלכם יופיע בקטע מומלצים, צריך למלא את טופס ההצטרפות ולשלוח אותו. כדי לבקש להסיר את כרטיס העסק שלכם מהקטע, צריך לשלוח את אותו טופס בקשה.