קבלת פרטי התצוגה

אתם יכולים לבדוק את הסכימה, ההערות בעמודות, המאפיינים והגדרת ה-SQL של תצוגת Apache Iceberg שרשומה בקטלוג הייעודי לזמן ריצה של Lakehouse באמצעות Spark או נקודת הקצה של קטלוג REST של Apache Iceberg.

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

  1. מוודאים שהחיוב מופעל בפרויקט ב- Google Cloud .

  2. מפעילים את BigLake API, אם הוא עדיין לא מופעל.

    התפקידים שנדרשים כדי להפעיל ממשקי API

    כדי להפעיל ממשקי API, צריך את ההרשאה serviceusage.services.enable. אם אתם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). כך מקצים תפקידים.

    להפעלת ה-API

  3. מגדירים את הקטלוג הייעודי לזמן ריצה של Lakehouse עם נקודת הקצה (endpoint) של קטלוג ה-REST של Apache Iceberg.
  4. המגבלות של תצוגות Iceberg
  5. יוצרים תצוגה.

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

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

  • הצגת פרטי התצוגה: BigLake Viewer (roles/biglake.viewer) – הפרויקט שלכם
  • קריאת קובצי מטא-נתונים של תצוגה במצב פרטי כניסה של משתמש קצה: Storage Object Viewer‏ (roles/storage.objectViewer) – הקטגוריה של Cloud Storage

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

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

ההרשאות הנדרשות

כדי לקבל את פרטי התצוגה, צריך את ההרשאות הבאות:

  • כדי לקבל פרטים על התצוגה: biglake.views.get בתצוגה
  • קריאת קובצי מטא-נתונים של תצוגה במצב פרטי כניסה של משתמשי קצה: storage.objects.get בקטגוריה של Cloud Storage

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

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

קבלת פרטי התצוגה

בודקים תצוגה.

Spark

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

DESCRIBE EXTENDED NAMESPACE_NAME.VIEW_NAME;

הצגת הצהרת ה-SQL שמגדירה את התצוגה:

SHOW CREATE TABLE NAMESPACE_NAME.VIEW_NAME;

הצגת מאפייני התצוגה בלבד:

SHOW TBLPROPERTIES NAMESPACE_NAME.VIEW_NAME;

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

REST

כדי לטעון את המטא-נתונים הנוכחיים של תצוגה באמצעות ה-API בארכיטקטורת REST, שולחים בקשת GET לנקודת הקצה GetIcebergView:

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME

התשובה מכילה את הערכים metadata-location ו-metadata של התצוגה.

כדי לבדוק אם תצוגה קיימת בלי לטעון את המטא-נתונים שלה, שולחים בקשת HEAD לאותו נתיב. נקודת הקצה CheckIcebergViewExists מחזירה את הערך 204 No Content אם התצוגה קיימת, או את הערך 404 Not Found אם היא לא קיימת.

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

  • ‫PROJECT_ID: מזהה הפרויקט ב- Google Cloud.
  • ‫CATALOG_ID: מזהה הקטלוג.
  • ‫NAMESPACE_NAME: השם של מרחב השמות של הקטלוג.
  • ‫VIEW_NAME: שם התצוגה.

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