כלי לאימות תוכן של אינטגרציה רציפה

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

הכלי לאימות תוכן ב-CI מבצע אימות דומה לזה של הכלי הרגיל לאימות תוכן ב-Looker, אבל יש כמה הבדלים:

• הכלי לאימות תוכן של CI תומך באפשרויות הבאות:

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

• הכלי הרגיל לאימות תוכן ב-Looker תומך באפשרויות הבאות:

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

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

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

אפשרויות של כלי לאימות התוכן

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

• Explores to query
• ניתוחים להחרגה
• תיקיות לאימות
• תיקיות להחרגה
• החרגת תוכן בתיקיות אישיות
• אימות מצטבר

שאילתות ב-Explore

כברירת מחדל, הכלי לאימות התוכן מריץ אימות תוכן בכל המודלים ובכל ה-Explores בפרויקט של LookML.

אפשר להשתמש בשדה Explores to query כדי לציין את הניתוחים והמודלים שרוצים לכלול באימות התוכן.

אפשר לציין ניתוחים בפורמט הבא: model_name/explore_name

לדוגמה, כדי לציין את הניתוחים שנקראים users ו-orders בקובץ thelook.model.lkml, מזינים את הטקסט הבא: thelook/users, thelook/orders

בדף התיעוד בנושא כלי האימות של SQL יש מידע נוסף ודוגמאות לאופן שבו מציינים את המודלים והתצוגות של Explore בשדה הזה.

ניתוחים להחרגה

כברירת מחדל, הכלי לאימות התוכן יפעיל אימות תוכן בכל המודלים ובכל ה-Explores בפרויקט של LookML.

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

אפשר לציין ניתוחים בפורמט הבא: model_name/explore_name

בדף התיעוד בנושא כלי האימות של SQL יש מידע נוסף ודוגמאות לאופן שבו מציינים את המודלים והתצוגות של Explore בשדה הזה.

תיקיות לאימות

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

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

https://myinstance.looker.com/folders/45

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

תיקיות להחרגה

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

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

אי-הכללה של תוכן בתיקיות אישיות

אם רוצים שכלי לאימות התוכן יאמת רק תוכן בתיקיות משותפות, צריך להפעיל את השדה לא כולל תוכן בתיקיות אישיות. כשהשדה Exclude content in personal folders (החרגת תוכן בתיקיות אישיות) מופעל, כלי אימות התוכן מתעלם מתוכן בתיקיות האישיות במופע Looker.

אימות מצטבר

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

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

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

הערות לגבי אימות מצטבר:

• ההגדרה של אימות מצטבר לא חלה כשכלי לאימות התוכן מאמת את ענף הייצור עצמו, למשל בהרצות ידניות בענף הייצור. כשמאמתים את ענף הייצור, הכלי לאימות תוכן מציג את תוצאות האימות המלאות.

המגבלות של אימות תוכן

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