כשיוצרים, משנים, מוחקים או שולחים שאילתות לתצוגות של 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.