קטלוג השגיאות ב-Looker

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

בעמודה מיקום מצוין המיקום שבו מוצגת הודעת השגיאה ב-Looker, והיא כוללת את האפשרויות הבאות (חלק מהשגיאות יכולות להופיע ביותר ממיקום אחד במוצר):

‫IDE = LookML validator/IDE

‫Ex = Explore

‫SQL = SQL Runner

‫LD = מרכז שליטה של LookML

‫D = מרכז הבקרה

S = Schedules

הודעת השגיאה מיקום סיבות אפשריות משאבים לפתרון בעיות
Variable not found (?). IDE
  • הקוד Liquid להפניה למשתנה, {{ }}, מוטמע בתוך הקוד Liquid ללוגיקה, {% %}.
  • מסנן מבוסס-תבנית מפנה לטבלה שלא מצורפת לטבלה נגזרת.
  • שדה שמופיע בהפניה ב-Liquid לא מוגדר באופן מלא עם שם תצוגה (view_name.field_name).
  • הערך של מסנן מופיע בתוך מסנן אחר במרכז שליטה של LookML.
  • הערך של פרמטר parameter לא תואם לערך של type התואם. לדוגמה: {% if parameters.change_value._parameter_value == "'AA'" %} צריך לעיין בparameter type כדי לוודא שהערך מחושב בצורה נכונה (type: string לעומת type: unquoted).
  • השדה view_name.field_name מופיע בהפניה נכונה ב-Liquid, אבל השדה field_name לא מוגדר בתצוגה המוגבלת view_name, או שהתצוגה היא כינוי עם from ב'ניתוח נתונים'.
  • הפניה למשתנה ב-Liquid לא מוגדרת, או שההפניה כוללת שגיאת הקלדה.
  • הפניה ל-Liquid כוללת קבוצת מאפיינים של type: time, אבל לא את מסגרת הזמן הספציפית. לדוגמה, במקום {{ view_name.creation_date }}, צריך להשתמש בהפניה {{ view_name.creation_date_year }}.
  • בשדה נעשה שימוש ב-Liquid עם תחביר של אופרטור החלפה של LookML, ‏ ${view_name.field_name}, במקום בלי, ‏ view_name.field_name.
Inaccessible view (?). (?) is not accessible in explore (?). Check for missing joins in explore (?). IDE
  • התצוגה שאליה מתבצעת ההפניה לא קיימת.
  • חסר צירוף, ולכן אי אפשר לגשת לתצוגה בחלק מהאפשרויות הנוספות.
  • התצוגה המפורטת מקבלת שם חדש עם פרמטר from בניתוח.
Unknown or inaccessible field (?). Check for typos or append a timeframe to the name if the field is type time. IDE יכולות להיות לכך כל הסיבות האפשריות שמופיעות בשגיאה Inaccessible view (?). (?) is not accessible in explore (?). Check for missing joins in explore (?)., וגם הסיבות הבאות:
  • יש שגיאת הקלדה בשם של שדה או בהפניה לשדה.
  • השדה מוחרג מניתוח באמצעות הפרמטר fields.
  • ההפניה היא אל dimension_group בלי שצוין פרק זמן.
Unknown view (?). IDE Ex SQL
  • תצוגה לא נכללת בקובץ המודל.
  • ‫explore מרחיב explore בסיסי שחסר בו הפרמטר view_name.
  • שם של אפשרויות נוספות שמוגדר בפרמטר explore מבוסס על שם תצוגה שמאוית בצורה שגויה או לא קיים.
  • שאילתת SQL Runner מבוססת-מודל פועלת עם המודל הלא נכון.
Unknown view (?). View does not exist in model (?). Check for typos or missing include statements. IDE Ex SQL
  • ‫explore מרחיב explore בסיסי שחסר בו פרמטר view_name, ושדות מכל התצוגות המצורפות מפנים לשם explore הבסיסי.
  • שדה מפנה לתצוגה שבה יש שגיאת כתיב, שלא קיימת או שלא מצורפת לניתוחים הרלוונטיים.
Unknown field (?) in filter IDE
  • הגדרה של טבלת נתונים נגזרת (NDT) מקורית כוללת פרמטר bind_all_filters בשדה מותאם אישית שלא מוגדר ב-LookML.
  • מסנן LookML מפנה לשדה LookML שהוסף לו הערה או שלא קיים.
  • מסנן LookML מפנה לשדה LookML מתצוגה אחרת, והשדה לא מוגדר באופן מלא ולא מצורף לכל הפרמטרים הרלוונטיים של explore.
Measures with Looker aggregations (sum, average, min, max, list types) may not reference other measures. IDE הפניה למדד מופיעה בהגדרת ה-SQL של מדד אחר מסוג aggregate.
Unknown view (?). View (?) does not exist in model (?). Check for typos or missing include statements in (?). IDE תצוגה לא נכללת בקובץ מודל, או שהיא נכללת אבל יש בה שגיאת כתיב.
Can't construct persistent derived table (?), connection (?) could not be registered IDE Ex
  • ה-build של יחסי תלות קיימים של PDT נכשל.
  • יש בעיה בחיבור, שצריך לאבחן אותה באמצעות בדיקת החיבור (לדוגמה, בדיקת החיבור עשויה לחשוף שלמשתמש ב-Looker אין גישת בעלות או גישת כתיבה מספקת למסד הנתונים).
  • קבצים של פרויקטים שיובאו, כמו תצוגה שמגדירה את ה-PDT שנכשל או תצוגה שה-PDT שנכשל מפנה אליה, לא נכללים בפרויקט הייבוא.
  • ההגדרה Persistent Derived Tables (טבלאות נגזרות מתמידות) לא מופעלת בחיבור למסד הנתונים.
  • הקוד של Looker Block לא עודכן לדיאלקט ה-SQL של החיבור, אם הוא שונה מהדיאלקט שבו נכתב ה-Block.
  • ‫OAuth מופעל לחיבור Snowflake או BigQuery.
  • הוגדר ערך שונה מערך ברירת המחדל, TRUE, לפרמטר AUTOCOMMIT של מסד הנתונים Snowflake.
Unknown or excluded suggest_dimension (?) in field (?) IDE
  • שדה שהפרמטר suggest_dimension מפנה אליו לא קיים, הוסר כהערה או נכלל בהחרגה באמצעות הפרמטר fields ב'ניתוח ב-Explore'.
  • שדה שהפרמטר suggest_dimension מפנה אליו מוגדר בתצוגה מפורטת אחרת, אבל לא מוגדר באופן מלא כ-view_name.field_name בהפניה.
  • פרמטר suggest_dimension מפנה לשדה בתצוגה אחרת שלא מצורף לכל הפרמטרים הרלוונטיים של explore, או לתצוגה שמוגדר לה כינוי בפרמטר from של explore.
A view named (?) has been defined multiple times. Each view in a model must have a unique name. IDE תצוגות עם שמות זהים מפנות לאותו מודל, כולל תצוגות שיובאו לפרויקט. שמות התצוגות חייבים להיות ייחודיים במודל. view חומרי עזר בנושא פרמטרים
This include does not match any files IDE
  • שגיאת הקלדה בנתיב לקובץ גורמת לשגיאה.
  • הפניה לתיקייה משתמשת בתחביר שגוי.
  • הפניה לייבוא פרויקט משתמשת בתחביר שגוי.
SQL Dialect does not support Symmetric Aggregates with percentiles, field ignored. Ex ניב מסד הנתונים לא תומך במדדים של type: median או type: percentile עם צבירות סימטריות.
Cannot use native derived table (?) with bind_all_filters outside of its source explore (?) IDE Ex טבלת נתונים נגזרת (NDT) מקורית עם פרמטר bind_all_filters מצורפת ל-Explore אחד או יותר, מלבד ה-Explore שמוגדר בפרמטר explore_source. שימוש ב-bind_all_filters
Measures of type count do not use the sql parameter. Use count_distinct to count by something other than the primary key, or remove the sql parameter. IDE פרמטר sql משמש במדד של type: count. מדדים מסוג ספירה מבצעים ספירה לפי המפתח הראשי שמוצהר בקובץ התצוגה, ולא נדרש פרמטר sql.
An explore named (?) has been defined multiple times. Each explore in a model must have a unique name. IDE LD
  • שם של ניתוח שהוגדר בפרמטר explore של קובץ מודל משוכפל משם קיים של ניתוח אחר. השמות של האפשרויות הנוספות צריכים להיות ייחודיים במודל.
  • לפרויקט מיובא יש explore עם שם זהה לexplore קיים בפרויקט המייבא.
  • קובץ מודל שכלול מכיל explore עם אותו שם כמו explore קיים בקובץ מודל הפרויקט הכלול.*
  • יש הפניה מעגלית בקוד, שמפנה אל explore (או אל קובץ המודל) מספר פעמים.
* לא מומלץ לכלול קובצי מודל בקובצי מודל אחרים.
Unknown view '(?)' --> Did you '- include: (?)' in (?).model.lookml? IDE
  • מודל כולל את תיקיית התצוגה, אבל קובץ התצוגה הספציפי נמצא מחוץ לתיקייה.
  • מודל כולל את שם התצוגה, אבל לא את קובץ התצוגה, אם השם שונה.
  • תצוגה מצטרפת ל-explore מספר פעמים, אבל חסר בה הפרמטר from בפעם השנייה שהיא מצטרפת.
Unknown field '(?)' IDE Ex
  • השדה שניסית להפנות אליו לא קיים, יש בו שגיאת כתיב או שהוא הוגדר כהערה.
  • שדה שהוגדר בהפניה מוגדר בתצוגה אחרת, ולא מוגדר עם שם התצוגה שלו.
  • שדה מוגדר בתצוגה אחרת שלא מצורפת לניתוחים הנדרשים, או שהתצוגה היא כינוי בצירוף, ולכן חלק מהניתוחים לא יכולים לגשת לשדה.
  • פרמטר required_fields מפנה לשדה שלא ניתן לגשת אליו, שהאיות שלו שגוי, שלא קיים או שהוא הוגדר כהערה.
Cannot use (?) as access filter since any user can edit their own value. Ex מאפיין משתמש עם האפשרות גישת משתמש שהוגדרה לעריכה משמש בפרמטר access_filter של ניתוח.
label_from_parameter of (?) must refer to a parameter. IDE Ex
  • שדה שאליו מפנה פרמטר label_from_parameter לא קיים, יש בו שגיאת כתיב או שהוא הוגדר כהערה.
  • קיים שדה שהפרמטר label_from_parameter מפנה אליו, אבל הוא לא מסוג parameter.
Cannot use user-editable attribute (?) for access_grant (?) IDE Ex מאפיין משתמש עם האפשרות User Access (גישת משתמש) שמוגדרת לערך Edit (עריכה) משמש בפרמטר access_grant של קובץ מודל.
datagroup (?) has a sql_trigger. This is not allowed in models with a parameterized connection. IDE חיבור למסד נתונים משתמש במאפייני משתמש לפרטי כניסה למסד נתונים, והעמודה PDT overrides לא מוגדרת למשתמש נפרד במסד נתונים לתהליכי PDT.
relationship missing, assumed to be many_to_one. IDE המאפיין relationship של הצטרפות לא מוגדר. אם לא מציינים relationship, ‏ Looker מניח כברירת מחדל שיש קשר many-to-one. relationship חומרי עזר בנושא פרמטרים
No distribution_style specified in persistent derived table (?). Using default distribution style (?). IDE ב-PDT של חיבור Redshift לא צוין פרמטר distribution_style בהגדרה derived_table שלו. אם לא מציינים distribution_style, ברירת המחדל של Looker היא ALL. distribution_style חומרי עזר בנושא פרמטרים
always_filter: unknown filter field '(?)' IDE
  • שדה שאליו מפנה פרמטר always_filter לא קיים, יש בו שגיאת כתיב או שהוא מופיע כהערה.
  • שדה שהפרמטר always_filter מפנה אליו הוא dimension_group של type: time שלא צורף אליו טווח זמן.
  • שדה שמפנה אליו פרמטר always_filter הוא שדה שמוגדר בתצוגה שלא מצורפת לכל הפרמטרים הרלוונטיים מסוג explore, או שהשדה לא מוגדר בהיקף עם שם התצוגה שלו.
The location field type requires both sql_latitude and sql_longitude. IDE חסר בשדה type: location תת-פרמטר sql_latitude או sql_longitude. בשדות של סוג המיקום נדרשים שניהם. location הפניה לסוג השדה
Missing required sql_step in create_process of derived table '(?)'. IDE
  • לא צוין sql_step ב-create_process, שנדרש בו פרמטר משנה אחד או יותר מסוג sql_step.
  • שגיאה במאמת LookML ששמורה במטמון סימנה שחסר sql_step למרות שsql_step כבר נוסף. כדי לפתור את השגיאה, צריך לבצע אימות נוסף.
create_process חומרי עזר בנושא פרמטרים
Can't construct aggregate table (?), temporary schema for (?) is unset. IDE Ex ההגדרה Persistent Derived Tables לא מוגדרת לחיבור בדף Connection Settings בחלונית Admin, ו/או שלא צוינה סכימת מסד נתונים זמנית בהגדרה Temp Database.
Can't construct aggregate table (?), connection (?) could not be registered. IDE Ex ההגדרה Temp Database לא מוגדרת בדף Connection Settings של החיבור בחלונית Admin, או של-Looker אין את ההרשאות המתאימות למסד הנתונים הזמני שצוין בהגדרה Temp Database.
Unknown view (?) referenced by explore (?) IDE
  • תצוגה נכללת באמצעות ברירת המחדל include: "*.view.lkml", אבל התצוגה נמצאת בתיקייה אחרת.
  • יש שגיאת כתיב בשם של תצוגה או בנתיב של קובץ בהצהרת include, או שההצהרה כוללת את שם התצוגה אבל לא את קובץ התצוגה, אם השם שונה.include
  • יש בעיה בתיקייה שכוללת תווים מיוחדים, כמו _views.
  • ‫explore מרחיב explore אחר שחסר בו פרמטר view_name שמציין את תצוגת הבסיס.
The location field type does not use the sql parameter. Please use sql_latitude and sql_longitude instead. IDE הפרמטר sql משמש בשדה type: location. בשדות של סוג המיקום צריך להשתמש בפרמטרים sql_latitude ו-sql_longitude במקום בפרמטר sql. location הפניה לסוג השדה
A list_field must be defined for measures of type list. IDE Ex כדי ליצור רשימה משדה, צריך לציין את השדה למדד של type: list. list הפניה לסוג השדה
Query failed with unexpected exception (?) IDE Ex SQL LD D S
  • בקטע PDT Overrides בעמוד Connection Settings של חיבור בחלונית Admin מצוין מסד נתונים שאינו מסד הנתונים של החיבור הראשי.
  • הייתה חריגה ממגבלת השאילתות לכל משתמש, ושאילתה שהוכנסה לתור הגיעה לזמן הקצוב לתפוגה של מאגר החיבורים.
  • חיבור JDBC נכשל.
  • אירעה שגיאה לא צפויה באפליקציית Looker.
Looker is having trouble connecting to your database. Ex SQL הגעתם למגבלה המקסימלית של מאגר החיבורים של חיבור מסוים, והזמן הקצוב לתפוגה של השאילתות שהוכנסו לתור חלף אחרי שחלף הזמן הקצוב לתפוגה של מאגר החיבורים.
FATAL: Too many connections for user '(?)' Ex SQL הגעתם למגבלת החיבורים למשתמש מסד הנתונים שצוין (לדוגמה, משתמש looker הייעודי) בצד מסד הנתונים. מסד הנתונים דוחה חיבורים חדשים מ-Looker כי Looker מנסה ליצור יותר חיבורים מהמותר למשתמש הספציפי הזה.
  • מגדילים את מגבלת החיבור למשתמש הייעודי בצד של מסד הנתונים.
  • מוודאים שההגדרה Max connections per node ב-Looker (Admin > Connections) מוגדרת בהתאם למגבלות החיבור שהוטלו על מסד הנתונים, כדי למנוע מיצוי של החיבורים.
SQL Error in incremental PDT: Query execution failed Ex D S הסכימה הבסיסית השתנתה בטבלה אחת או יותר שהייתה הפניה אליהן ב-PDT מצטבר שמבוסס על SQL. בניית PDT מצטבר נכשלת אחרי שינוי בסכימה
Missing dates/values for '(?)' were not filled. Ex
  • אי אפשר להחיל מילוי של מאפיין כי נבחרו יותר ממאפיין אחד בכלי הניתוחים.
  • אי אפשר להחיל מילוי מאפיינים כי אחד או יותר מהשדות עברו ציר בכלי הניתוחים.
  • אי אפשר להחיל מילוי מאפיינים כי בשדה יש ערכי מחרוזת שונים (לדוגמה, פרמטרים של allowed_value או case), והוחל על השדה מסנן.
מילוי תאריכים וערכים חסרים
filters: ` is not supported for measures of non-aggregate type '(?)' IDE Ex נעשה שימוש בפרמטר filters עם סוג מדידה כלשהו, מלבד הסוגים הבאים: count, ‏ sum, ‏ average ו-count_distinct.
Unknown source explore (?) in lookml test (?) declaration. IDE
  • שם של ניתוח ב-Explore עם שגיאת כתיב, שלא קיים או שהוסף לו הערה, משמש כפרמטר משנה explore_source בבדיקת נתונים.
  • בדיקת נתונים מוגדרת בקובץ שלא כלול בקובץ שמכיל את ההגדרה של explore_source ב-Explore, או שהקובץ לא כלול בו.
  • ‫Explore עם הגדרת הפרמטר extension: required משמש כ-explore_source של בדיקת נתונים.
filter_expression: is not supported for measures of non-aggregate type '(?)' IDE Ex השתמשתם בפרמטר filters_expression עם סוג מדידה כלשהו, חוץ מהסוגים הבאים: count, ‏ sum, ‏ average או count_distinct.
Field references an aggregate but is specified as a dimension. If you want to use aggregations such as sum, average, count, use a measure type instead. IDE Ex מאפיין מפנה למדד או לצבירה אחרת בפרמטר sql שלו
Cannot specify both sql_table_name and derived_table for view (?) IDE התצוגה כוללת את הפרמטרים sql_table_name ו-derived_table. תצוגה יכולה להפנות רק לטבלה אחת – או לסכימה קיימת בחיבור למסד הנתונים עם sql_table_name, או לטבלה חדשה עם derived_table.
Persistent Native Derived Table for view (?) has an explore source (?) that has access filters. Persisting this table may result in unexpected behavior. IDE NDT קבוע מבוסס על ניתוח נתונים באמצעות access_filter פרמטר שמפנה למאפייני משתמש.
Unknown or unexpected parameter "(?)" in (?). IDE
  • הפרמטר distribution_style משמש לניב שלא תומך בפרמטר הזה
  • הפרמטר cluster_keys משמש לניב שלא תומך בפרמטר הזה
  • פרמטר sql_always_where מוגדר ב-join במקום ב-explore.
  • מסגרות הזמן שהוגדרו ב-dimension_group הן לא מסוג type: time.
  • פרמטר sql_distinct_key מוגדר במאפיין במקום במדד.
Could not find the constant IDE קבוע מופנה מפרויקט מיובא בפרויקט מייבא, והוא מוגדר רק בפרויקט המיובא. אפשר להפנות לקבועים רק בפרויקטים שבהם הם מוגדרים. צריך להגדיר מחדש את הקבוע בקובץ המניפסט. שימוש בקבועים בקבצים מפרויקט מיובא
Multiple primary key definitions for view '(?)': '(?)' and '(?)' IDE קיימים יותר ממפתח ראשי אחד בקובץ תצוגה. יותר ממאפיין אחד מוגדר כמפתח ראשי באמצעות primary_key: yes, או שתצוגה שמרחיבה תצוגה אחרת מגדירה מאפיין חדש כמפתח ראשי באמצעות primary_key: yes.
Persistent Native Derived Table for view (?) references user attributes. Persisting this table may result in unexpected behavior. IDE טבלת NDT מתמשכת או טבלת מודעות מצטברת מבוססת על explore עם פרמטר access_filter או sql_always_where שמפנה למאפייני משתמש.
No map layer named (?) is defined. Must be one of countries, uk_postcode_areas, us_counties_fips, us_states, us_zipcode_tabulation_areas IDE מאפיין מפנה לשכבת מפה עם map_layer_name כשלא מוגדרת שכבת מפה בכל המודלים שבהם נכללת התצוגה של השדה. לדוגמה, תצוגה נכללת בכמה מודלים, אבל שכבת המפה מוגדרת רק במודל אחד.
Persistent derived table (?) should include at least one index IDE הגדרה של טבלת PDT או טבלה מסכמת כוללת index שבה לא צוינה עמודה של טבלת PDT או טבלה מסכמת.
The x database encountered an error while running this query. Ex SQL מסד הנתונים לא יכול לאתר עמודה שאליה מפנה הפרמטר sql של שדה. יכולות להיות לכך כמה סיבות:
  • יש שגיאת הקלדה בשם הטבלה או העמודה שאליהן מתבצעת הפניה בפרמטר sql.
  • נתוני הבסיס במסד הנתונים השתנו, למשל שם של עמודה.
טיפים לפתרון בעיות נפוצות של שגיאות SQL ב-Looker (פוסט בקהילה)
Render job (?) failed [orphaned job] S המופע ב-Looker לא היה זמין בזמן שהעבודה המתוזמנת פעלה. מצב כזה יכול לקרות במהלך עדכוני גרסה ותחזוקה מתוזמנת. מדיניות התחזוקה של Google לשירותים שמארחים Looker