הצגת רשימת התצוגות מאפשרת לכם לראות אילו תצוגות של Apache Iceberg רשומות במרחב שמות של הקטלוג הייעודי לזמן ריצה של Lakehouse. התוצאה מכילה רק מזהי תצוגות, ללא טבלאות. באופן דומה, הצגת טבלאות לא כוללת תצוגות.
לפני שמתחילים
-
מפעילים את BigLake API, אם הוא עדיין לא מופעל.
התפקידים שנדרשים כדי להפעיל ממשקי API
כדי להפעיל ממשקי API, צריך את ההרשאה
serviceusage.services.enable. אם אתם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). כך מקצים תפקידים. - מגדירים את הקטלוג הייעודי לזמן ריצה של Lakehouse עם נקודת הקצה (endpoint) של קטלוג ה-REST של Apache Iceberg.
- המגבלות של תצוגות Iceberg
- יוצרים תצוגה.
התפקידים הנדרשים
כדי לקבל את ההרשאות שדרושות להצגת רשימת התצוגות, בקשו מהאדמין לתת לכם את התפקידים הבאים ב-IAM ברמת הפרויקט:
-
תצוגות רשימה:
BigLake Viewer (
roles/biglake.viewer) – הפרויקט שלך
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות כדי להציג רשימה של תצוגות. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי להציג רשימה של תצוגות, צריך את ההרשאות הבאות:
-
תצוגות רשימה:
biglake.views.listבמרחב השמות
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
ברשימה המלאה של הרשאות הצפייה מפורטים התפקידים וההרשאות הנדרשים.
תצוגות רשימה
הצגת רשימה של התצוגות במרחב שמות.
Spark
SHOW VIEWS IN NAMESPACE_NAME;
מחליפים את NAMESPACE_NAME בשם של מרחב השמות.
REST
כדי להציג רשימה של תצוגות באמצעות ה-API בארכיטקטורת REST, שולחים בקשת GET לנקודת הקצה (endpoint) של ListIcebergViewIdentifiers:
GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views
נקודת הקצה תומכת בפרמטרים של השאילתה pageToken ו-pageSize.
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud. -
CATALOG_ID: מזהה הקטלוג. -
NAMESPACE_NAME: השם של מרחב השמות של הקטלוג.