פתרון בעיות בתצוגות של Apache Iceberg

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

‫409 Conflict או AlreadyExistsException כשיוצרים או מחליפים תצוגה או טבלה

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

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

SHOW TABLES IN NAMESPACE_NAME;
SHOW VIEWS IN NAMESPACE_NAME;

צריך לבחור שם אחר או להסיר קודם את האובייקט שמתנגש.

‫403 Forbidden או AccessDeniedException בפעולות צפייה

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

  • ל-DDL של תצוגה, למבצע הקריאה החוזרת יש הרשאת עריכה ב-BigLake‏ (roles/biglake.editor) או הרשאת אדמין ב-BigLake‏ (roles/biglake.admin).
  • בשאילתות של SELECT, למבצע הקריאה החוזרת יש את התפקיד "צפייה ב-BigLake" (roles/biglake.viewer), שמעניק את ההרשאה biglake.views.get בתצוגה ואת ההרשאות biglake.tables.get ו-biglake.tables.getData בטבלאות שאליהן מפנים.
  • במצב פרטי כניסה של משתמש קצה, למבצע הקריאה החוזרת (caller) יש את התפקיד Storage Object User‏ (roles/storage.objectUser) בקטגוריה של Cloud Storage לצפייה ב-DDL, או את התפקיד Storage Object Viewer‏ (roles/storage.objectViewer) לשאילתות לקריאה בלבד.
  • במצב של הפצת פרטי כניסה, לחשבון השירות של הקטלוג יש את התפקיד Storage Object User‏ (roles/storage.objectUser) בקטגוריה של Cloud Storage, ו-Spark מוגדר עם spark.sql.catalog.CATALOG_NAME.header.X-Iceberg-Access-Delegation=vended-credentials.

למידע נוסף, קראו את המאמר תפקידים והרשאות נדרשים.

UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW

‫Spark מחזיר את הערך AnalysisException: [UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW] Cannot time travel on view כששאילתה מחילה את TIMESTAMP AS OF או את VERSION AS OF ישירות על מזהה תצוגה.

מסירים את סעיף הנסיעה בזמן מהשאילתה. אם אתם צריכים נתונים היסטוריים, הגדירו תצוגה שהגדרת ה-SQL שלה מחילה את TIMESTAMP AS OF על הטבלה הבסיסית, או השתמשו ב-CTE ששולח שאילתה ישירות לטבלה הבסיסית. מידע נוסף זמין במאמר יצירת תצוגה עם נסיעה בזמן בטבלאות בסיסיות.

ValidationException: Cannot find snapshot older than timestamp

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

מחליפים את התצוגה ב-CREATE OR REPLACE VIEW באמצעות חותמת זמן חדשה יותר או מזהה של תמונת מצב, או משנים את הגדרות השמירה של תמונת המצב בטבלת Iceberg הבסיסית.

409 Conflict: Namespace is not empty כשמבטלים מרחב שמות

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

SHOW VIEWS IN NAMESPACE_NAME;
DROP VIEW IF EXISTS NAMESPACE_NAME.VIEW_NAME;

‫400 Bad Request עם FAILED_PRECONDITION בפעולות צפייה

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

400 Bad Request: View location is immutable

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

בגרסה 481 של Trino ובגרסאות קודמות, CREATE OR REPLACE VIEW שולח עדכון לגבי מיקום שגורם לשגיאה הזו. משדרגים לגרסה 482 של Trino או לגרסה חדשה יותר, או מריצים את DROP VIEW ואחריו את CREATE VIEW כדי לעדכן את הגדרת התצוגה. למידע נוסף, קראו את המאמר תמיכה ב-Trino.

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