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

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

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

IDE = LookML validator/IDE

Ex = מה חדש

SQL = SQL Runner

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

‫D = מרכז בקרה

‫S = לוחות זמנים

הודעת השגיאה מיקום סיבות אפשריות מקורות מידע לפתרון בעיות
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).
  • שדה מסוים מאוזכר בצורה נכונה ב-Liquid בתור view_name.field_name, אבל field_name לא מוגדר בתצוגה view_name, או שהתצוגה מקבלת את הכינוי from ב-Explore.
  • הפניה של 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
  • התצוגה שצוינה לא קיימת.
  • חסר צירוף, ולכן התצוגה לא נגישה לחלק מה-Explores.
  • השם של התצוגה משתנה עם פרמטר from ב-Explore.
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 הבסיסי.
  • שדה מפנה לתצוגה שמאויתת באופן שגוי, לא קיימת או לא מצורפת ל-Explores הרלוונטיים.
Unknown field (?) in filter IDE
  • הגדרה של טבלה נגזרת מבוססת LookML ‏ (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 של מדד אחר מסוג צבירה.
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 שנכשל מפנה אליה, לא נכללים בפרויקט המיובא.
  • ההגדרה טבלאות נגזרות מתמידות (PDT) לא מופעלת בחיבור למסד הנתונים.
  • הקוד של בלוק Looker לא עודכן לניב ה-SQL של החיבור, אם הוא שונה מהניב שעבורו הבלוק נכתב.
  • ‫OAuth מופעל בחיבור ל-Snowflake או ל-BigQuery.
  • ערך שונה מערך ברירת המחדל, TRUE, הוגדר לפרמטר AUTOCOMMIT של מסד הנתונים של Snowflake.
Unknown or excluded suggest_dimension (?) in field (?) IDE
  • שדה שיש אליו הפניה מפרמטר suggest_dimension לא קיים, סומן כהערה או הוחרג ב-Explore על ידי פרמטר fields.
  • שדה שאליו מפנה פרמטר suggest_dimension מוגדר בתצוגה אחרת, אבל לא מוגדר באופן מלא כ-view_name.field_name בהפניה.
  • פרמטר suggest_dimension מפנה לשדה בתצוגה אחרת שלא מצורפת לכל הפרמטרים הרלוונטיים של explore, או לתצוגה שמוגדר לה כינוי ב-explore עם פרמטר from.
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 טבלה נגזרת מבוססת LookML ‏ (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 עם שם זהה ל-explore קיים בקובץ המודל של הפרויקט שכולל אותו.*
  • יש הפניה מעגלית בקוד, שמפנה אל explore (או אל קובץ המודל) כמה פעמים.
* לא מומלץ לכלול קובצי מודלים בקובצי מודלים אחרים.
Unknown view '(?)' --> Did you '- include: (?)' in (?).model.lookml? IDE
  • מודל כולל את תיקיית התצוגה, אבל קובץ התצוגה הספציפי נמצא מחוץ לתיקייה.
  • מודל כולל את שם התצוגה, אבל לא את קובץ התצוגה, אם השם שלו שונה.
  • תצוגה מצורפת ל-explore כמה פעמים, אבל חסר הפרמטר from בפעם השנייה שהיא מצורפת.
Unknown field '(?)' IDE Ex
  • השדה שניסיתם להפנות אליו לא קיים, יש בו שגיאת כתיב או שהוא סומן כהערה.
  • שדה שמוזכר מוגדר בתצוגה אחרת, והוא לא מוגדר עם שם התצוגה שלו.
  • שדה מוגדר בתצוגה אחרת שלא מצורפת ל-Explores הנדרשים, או שהתצוגה מקבלת כינוי בצירוף, מה שהופך את השדה ללא נגיש לחלק מה-Explores.
  • פרמטר required_fields מפנה לשדה שאין אליו גישה, שמאוית באופן שגוי, שלא קיים או שסומן כהערה.
Cannot use (?) as access filter since any user can edit their own value. Ex מאפיין משתמש שהאפשרות User Access שלו מוגדרת כ-Edit משמש בפרמטר access_filter של Explore.
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 מאפיין משתמש שהאפשרות גישת משתמש שלו מוגדרת כעריכה משמש בפרמטר 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 הגעתם למגבלה המקסימלית של מאגר החיבורים, והזמן הקצוב לתפוגה של שאילתות בתור חלף אחרי שחלון הזמן הקצוב לתפוגה של מאגר החיבורים חלף.
SQL Error in incremental PDT: Query execution failed Ex D S הסכימה הבסיסית השתנתה בטבלה אחת או יותר שאוזכרו ב-PDT מצטבר שמבוסס על SQL. הבנייה של PDT מצטבר נכשלת אחרי שינוי סכימה
Missing dates/values for '(?)' were not filled. Ex
  • אי אפשר להחיל מילוי מאפיינים כי נבחרו כמה מאפיינים בכלי הניתוחים.
  • אי אפשר להחיל מילוי מאפיינים כי שדה אחד או יותר עברו המרה לטבלת צירים ב-Explore.
  • אי אפשר להחיל מילוי מאפיינים כי בשדה יש ערכי מחרוזת נפרדים (לדוגמה, פרמטרים של 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_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