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

כלי האימות של טענות (Assertions) בשילוב רציף (CI) מריץ את בדיקות הנתונים של LookML שנוצרו על ידי מפתחי Looker בפרויקט LookML שלכם, ומציג את התוצאות של כל בדיקת נתונים. במקרה של בדיקות נתונים שנכשלו, כלי האימות של טענות יציג את השגיאה.

בדיקות נתונים ב-LookML מאפשרות לאמת את הלוגיקה של מודל Looker. בדיקות נתונים יכולות לבדוק הנחות מורכבות, כמו ההנחות הבאות:

  • ההכנסה במאי של השנה שעברה צריכה להיות שווה ל-204,259$.
  • שיעור ההמרה צריך להיות גדול מאפס.
  • סטטוס ההזמנה לא יכול להיות null.

בדיקת נתונים ב-LookML מורכבת משאילתת explore_source קטנה ומביטוי assert, כמו בדוגמה הבאה:yesno

test: historic_revenue_is_accurate {
  explore_source: orders {
    column: total_revenue { field: orders.total_revenue }
    filters: [orders.created_date: "2024"]
  }
  assert: revenue_is_expected_value {
    expression: ${orders.total_revenue} = 626000 ;;
  }
}

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

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

דף התוצאות של שילוב רציף שבו מוצגות הממצאים של כלי האימות של הצהרות

אפשרויות של כלי האימות של טענות

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

שאילתות ב-Explore

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

בדיקות הנתונים מוגדרות באמצעות פרמטר explore_source שמפנה לניתוח בפרויקט. אפשר להשתמש בשדה Explores to query כדי להגביל את אימות הטענות לניתוחים ספציפיים שעליהם מבוססות בדיקות הנתונים.

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

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

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

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

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

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

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

בו-זמניות (concurrency) של שאילתות

כברירת מחדל, כלי האימות של טענות מריץ עד 10 שאילתות בכל פעם כדי למנוע עומס יתר על מופע Looker. אפשר להשתמש בשדה Query concurrency כדי לציין מספר מקסימלי שונה של שאילתות שכלי התיקוף של Assert יכול להריץ בו-זמנית.

הערך המקסימלי בשדה Query concurrency מוגבל להגדרה Max concurrent queries for this connection בחיבור למסד הנתונים.

אם אתם מבחינים בהאטה במופע Looker בזמן הפעלת אימות Assert, אתם יכולים להקטין את הערך הזה.