כששולחים שאילתה לתצוגה של Apache Iceberg, אפשר לקרוא תוצאות שנאספו ללא העתקה מהטבלאות הבסיסיות של Iceberg. כדי לעשות את זה, מריצים את הגדרת ה-SQL ששמורה בקטלוג הייעודי לזמן ריצה של Lakehouse. מנוע Compute Engine טוען את הגדרת התצוגה מהקטלוג, פותר כל טבלה ותצוגה מקוננת שאליהן יש הפניה, ואז קורא את קובצי הנתונים ב-Cloud Storage.
אפשר לשלוח שאילתות לתצוגות Iceberg רק ממנועי קוד פתוח שתואמים ל-Iceberg, כמו Spark ו-Trino. ב-BigQuery אי אפשר לשלוח שאילתות לתצוגות של Iceberg.
לפני שמתחילים
-
מפעילים את BigLake API, אם הוא עדיין לא מופעל.
התפקידים שנדרשים כדי להפעיל ממשקי API
כדי להפעיל ממשקי API, צריך את ההרשאה
serviceusage.services.enable. אם אתם יצרתם את הפרויקט, סביר להניח שכבר יש לכם את ההרשאה הזו דרך התפקיד "בעלים" (roles/owner). אחרת, תוכלו לקבל את ההרשאה הזו דרך התפקיד "אדמין בממשק 'שימוש בשירות'" (roles/serviceusage.serviceUsageAdmin). כך מקצים תפקידים. - מגדירים את הקטלוג הייעודי לזמן ריצה של Lakehouse עם נקודת הקצה (endpoint) של קטלוג ה-REST של Apache Iceberg.
- המגבלות של תצוגות Iceberg
- יוצרים תצוגה.
התפקידים הנדרשים
מכיוון ש-Compute Engine מעריך תצוגות בצד הלקוח, אתם צריכים הרשאות לתצוגה ולכל טבלה ותצוגה מקוננת שהתצוגה מפנה אליהן.
כדי לקבל את ההרשאות שדרושות לשליחת שאילתות לתצוגה, בקשו מהאדמין לתת לכם את התפקידים הבאים ב-IAM ברמת הפרויקט וקטגוריית האחסון:
-
קריאת התצוגה והטבלאות שאליהן היא מפנה במצב הפצת פרטי כניסה:
צפייה ב-BigLake (
roles/biglake.viewer) – הפרויקט שלכם -
קוראים את התצוגה ואת הטבלאות שאליהן היא מפנה במצב פרטי הכניסה של משתמש הקצה:
- BigLake Viewer (
roles/biglake.viewer) – הפרויקט שלכם - צפייה באובייקטים של אחסון (
roles/storage.objectViewer) – הקטגוריה של Cloud Storage
- BigLake Viewer (
להסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.
התפקידים המוגדרים מראש האלה כוללים את ההרשאות שנדרשות כדי לשלוח שאילתות לתצוגה. כדי לראות בדיוק אילו הרשאות נדרשות, אפשר להרחיב את הקטע ההרשאות הנדרשות:
ההרשאות הנדרשות
כדי לשלוח שאילתה לתצוגה, צריך את ההרשאות הבאות:
-
שליחת שאילתה לתצוגה:
-
biglake.views.getבתצוגה ובכל התצוגות המקושרות -
biglake.tables.getבכל טבלת Iceberg שהתצוגה מפנה אליה
-
-
קריאת נתוני טבלה במצב הפצת פרטי כניסה:
biglake.tables.getDataבכל טבלת Iceberg שהתצוגה מפנה אליה -
קריאת מטא-נתונים של תצוגה ונתוני טבלה במצב פרטי כניסה של משתמש קצה:
storage.objects.getבקטגוריה של Cloud Storage
יכול להיות שתקבלו את ההרשאות האלה באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש אחרים.
ברשימה המלאה של הרשאות הצפייה מפורטים התפקידים וההרשאות הנדרשים.
שליחת שאילתה לתצוגה
כדי לבחור את כל הנתונים מתצוגה:
Spark
SELECT * FROM NAMESPACE_NAME.VIEW_NAME;
מחליפים את מה שכתוב בשדות הבאים:
-
NAMESPACE_NAME: השם של מרחב השמות. -
VIEW_NAME: שם התצוגה.
באותו אופן, אפשר לשלוח שאילתות לתצוגות שמכילות איחודים, צבירות, ביטויי CTE ותצוגות בתצוגות. לדוגמה, השאילתות הבאות משתמשות בתצוגות מיצירת תצוגה:
SELECT * FROM my_ns.eng_employees ORDER BY emp_id;
SELECT * FROM my_ns.employee_directory ORDER BY id;
SELECT * FROM my_ns.top_eng_employees;
מסע בזמן וצפיות
אי אפשר להחיל סעיף של נסיעה בזמן כמו TIMESTAMP AS OF או VERSION AS OF ישירות על מזהה תצוגה. אם אתם צריכים נתונים היסטוריים, הגדירו תצוגה שהגדרת ה-SQL שלה מחילה את המסע בזמן על הטבלה הבסיסית, או השתמשו ב-CTE ששולח שאילתה ישירות לטבלה הבסיסית. מידע נוסף זמין במאמר יצירת תצוגה עם נסיעה בזמן בטבלאות בסיסיות.