שינוי של תצוגת Apache Iceberg מאפשר לפתח את הסכימה ואת הגדרת ה-SQL של התצוגה, או להגדיר ולבטל את ההגדרה של מאפייני תצוגה בהתאמה אישית, בלי לשנות את זהות התצוגה בקטלוג הייעודי לזמן ריצה של Lakehouse.
אי אפשר לשנות את השם של התצוגה. כדי לשנות שם של תצוגה, יוצרים תצוגה עם השם החדש ואז מוחקים את התצוגה המקורית. גם את מיקום האחסון של תצוגה אי אפשר לשנות אחרי שיוצרים אותה, ועדכון שמגדיר מיקום אחר נכשל עם השגיאה 400 Bad Request.
לפני שמתחילים
-
מפעילים את BigLake API, אם הוא עדיין לא מופעל.
התפקידים שנדרשים כדי להפעיל ממשקי API
כדי להפעיל ממשקי API, צריך את ההרשאה
serviceusage.services.enable. אם אתם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). כך מקצים תפקידים. - מגדירים את הקטלוג הייעודי לזמן ריצה של Lakehouse עם נקודת הקצה (endpoint) של קטלוג ה-REST של Apache Iceberg.
- המגבלות של תצוגות Iceberg
- יוצרים תצוגה.
התפקידים הנדרשים
כדי לקבל את ההרשאות שנדרשות לשינוי תצוגה, בקשו מהאדמין להקצות לכם את תפקידי ה-IAM הבאים בפרויקט ובקטגוריית האחסון:
-
שינוי תצוגה:
עריכה ב-BigLake (
roles/biglake.editor) – הפרויקט שלכם -
כתיבת קובצי מטא-נתונים של תצוגה במצב פרטי הכניסה של משתמש הקצה:
Storage Object User (
roles/storage.objectUser) – הקטגוריה של Cloud Storage
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות כדי לשנות תצוגה. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי לשנות תצוגה, צריך את ההרשאות הבאות:
-
שינוי תצוגה:
-
biglake.views.updateבתצוגה -
biglake.tables.getבכל טבלת Iceberg שההגדרה של התצוגה החדשה מפנה אליה
-
-
כתיבת קובצי מטא-נתונים של תצוגה במצב פרטי כניסה של משתמשי קצה:
storage.objects.createבקטגוריה של Cloud Storage
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
ברשימה המלאה של הרשאות הצפייה מפורטים התפקידים וההרשאות הנדרשים.
החלפת הגדרה של תצוגה
החלפת הסכימה והלוגיקה של SQL בתצוגה קיימת. כשמחליפים תצוגה, הקטלוג כותב קובץ metadata.json חדש עם גרסה (לדוגמה, 00001-UUID.metadata.json), מוסיף גרסה וסכימה חדשות של התצוגה למטא-נתונים של התצוגה, ושומר את ה-view-uuid של התצוגה.
Spark
CREATE OR REPLACE VIEW my_ns.eng_employees (
emp_id,
emp_name,
dept,
salary,
is_senior
)
COMMENT 'Updated Engineering view with seniority flag'
AS SELECT id, name, dept, salary, (salary >= 140000.0) AS is_senior
FROM my_ns.employees
WHERE dept = 'Engineering';
REST
כדי לעדכן תצוגה באמצעות ה-API בארכיטקטורת REST, שולחים בקשת POST לנקודת הקצה UpdateIcebergView:
POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME
גוף הבקשה חייב להכיל מטען ייעודי (payload) תקין של Iceberg CommitViewRequest JSON עם requirements ו-updates להחלה. הקטלוג מאמת את הדרישות של בקרת בו-זמניות אופטימית ומבצע את העדכונים בקובץ metadata.json חדש.
מחליפים את מה שכתוב בשדות הבאים:
-
PROJECT_ID: מזהה הפרויקט ב- Google Cloud. -
CATALOG_ID: מזהה הקטלוג. -
NAMESPACE_NAME: השם של מרחב השמות של הקטלוג. -
VIEW_NAME: שם התצוגה.
הגדרה וביטול הגדרה של מאפייני תצוגה
להגדיר או להסיר מאפיינים מותאמים אישית בתצוגה בלי לשנות את ההגדרה שלה.
Spark
הגדרת מאפיינים:
ALTER VIEW my_ns.eng_employees
SET TBLPROPERTIES ('tier' = 'gold', 'reviewed' = 'true');
ביטול ההגדרה של מאפיין:
ALTER VIEW my_ns.eng_employees
UNSET TBLPROPERTIES IF EXISTS ('reviewed');
במאמר הצגת מאפיינים מוסבר איך הקטלוג מטפל במאפיינים כמו write.metadata.compression-codec.
REST
שולחים בקשת CommitViewRequest לנקודת הקצה (endpoint) של UpdateIcebergView עם עדכונים לגבי set-properties או remove-properties. במאמר החלפת הגדרה של תצוגה מפורט הנתיב של נקודת הקצה.