אימות של קוד LookML

כשעורכים את קוד ה-LookML, סביבת הפיתוח המשולבת של Looker מתריעה על שגיאות תחביר לא פתורות בקובץ יחיד (מידע נוסף זמין במאמר סקירה כללית של סביבת הפיתוח המשולבת של Looker).

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

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

  • אם משנים הגדרה ברמת המודל, כל הנתונים עוברים אימות מחדש.
  • אם תצוגה משתנה, רק הניתוחים שבהם היא נמצאת עוברים אימות מחדש.
  • אם מתבצע שינוי בדוח Explore, רק הדוח הזה עובר אימות מחדש.

הרצת אימות

כדי להפעיל את הכלי לאימות LookML, לוחצים על הלחצן Validate LookML (אימות LookML) בפינה השמאלית העליונה של Looker IDE, או לוחצים על הסמל Project Health (תקינות הפרויקט) בחלק העליון של IDE כדי לפתוח את החלונית Project Health (תקינות הפרויקט), ואז לוחצים על הסמל Validate LookML (אימות LookML).

אחרי שמריצים את כלי התיקוף של LookML, יכול להיות שתופיע רשימה של שגיאות ואזהרות אחרות שצריך לטפל בהן. אפשר ללחוץ על החץ כדי להרחיב את רשימת השגיאות או האזהרות.

אם תבצעו שינוי נוסף ותשמרו אותו, הכפתור של הכלי לאימות בחלונית Project Health יהיה זמין שוב.

הודעות אימות

אחרי שמריצים אימות ב-LookML, מוצגות ב-Looker הודעות אימות.

לא נמצאו שגיאות ב-LookML

אם המאמת לא מוצא בעיות, ב-Looker מוצג סימן וי ירוק לצד הטקסט No LookML errors found (לא נמצאו שגיאות ב-LookML).

שגיאות ב-LookML

שגיאות LookML הן בעיות שיכולות למנוע את הרצת השאילתות. המספר בסוגריים הוא מספר השגיאות שנמצאו (בדוגמה הבאה, תשע):

דוגמה להודעת אימות עם הטקסט LookML Errors (9).

ברשימת הבעיות המורחבת תופיע הסיבה לכך שהאימות לא עבר. לפעמים, לחיצה על השגיאה תעביר אתכם ישירות לשורת הקוד הבעייתית. יופיע X אדום לצד השורה. במקרים מסוימים, העברת העכבר מעל השגיאה תספק מידע מפורט יותר על השגיאה:

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

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

אזהרות LookML

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

דוגמה להודעת אימות עם הטקסט LookML Warnings (3).

בדומה לשגיאות ב-LookML, אפשר להרחיב את האזהרות ולעבור לקוד הבעייתי. לשם כך, בוחרים את האזהרה בחלונית Project Health ומעבירים את העכבר מעל סמל ה-X האדום כדי לראות מידע נוסף:

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

פריסת השינויים

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