בניית מודל של הנתונים ב-LookML

‫LookML ו-Looker IDE מאפשרים לכם להגדיר מודלים של נתונים, מאפיינים וקשרים שניתן לעשות בהם שימוש חוזר, שמבוססים על הטבלאות של מסד הנתונים. במדריך למתחילים הזה תיצרו קובץ מודל וקובץ תצוגה, תגדירו Explore ותבדקו מאפיין חדש באמצעות הפרויקט של LookML לדוגמה ב-Looker (Google Cloud core). תלמדו גם איך להפעיל את מצב הפיתוח, לנווט ב-Looker IDE ולהשתמש בעזרה המיידית.

לפני שמתחילים

כדי להשתמש במדריך למתחילים הזה, אתם צריכים:

התפקידים הנדרשים

כדי להשלים את המדריך למתחילים, אתם צריכים את התפקיד המתאים בניהול זהויות והרשאות גישה (IAM) ואת התפקיד המתאים ב-Looker.

תפקידים בניהול זהויות והרשאות גישה (IAM)

האדמין של Looker (Google Cloud core) נותן לכם גישה לאפליקציית Looker (Google Cloud core) דרך המערכת לניהול זהויות והרשאות גישה (IAM) של Google Cloud.

כדי לקבל את ההרשאה שנדרשת לגישה לאפליקציית Looker (Google Cloud core), בקשו מהאדמין לתת לכם את התפקיד משתמש במכונה של Looker (roles/looker.instanceUser) ב-IAM בפרויקט ב- Google Cloud שמכיל את המכונה של Looker (Google Cloud core). להסבר על מתן תפקידים, קראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

התפקיד המוגדר מראש הזה כולל את ההרשאה looker.instances.login, שנדרשת כדי לגשת לאפליקציית Looker (Google Cloud core).

יכול להיות שתוכלו לקבל את ההרשאה הזו גם בתפקידים בהתאמה אישית או בתפקידים מוגדרים מראש.

הרשאות ב-Looker

אתם צריכים חשבון משתמש ב-Looker עם התפקיד אדמין ב-Looker או עם ההרשאה develop.

הפעלת מצב פיתוח

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

במדריך הזה תשתמשו במצב פיתוח כדי שתוכלו לבצע שינויים בקובצי LookML ולבדוק את השינויים ב-Explore.

כדי להפעיל את מצב הפיתוח, פועלים לפי השלבים הבאים:

  1. בדף הבית של Looker (Google Cloud core), לוחצים על סמל התפריט הראשי של Looker כדי להרחיב את תפריט הניווט הראשי, אם הוא עדיין לא מורחב.
  2. בתחתית התפריט, לוחצים על המתג מצב פיתוח.

כשהמצב הזה מופעל, Looker מציג את הבאנר Development Mode בחלק העליון של המסך.

פרויקט LookML הוא אוסף של קובצי LookML שמנחים את Looker איך להתחבר למסד הנתונים, איך לשלוח שאילתות לנתונים ואיך להציג את הנתונים בממשק המשתמש. במדריך למתחילים הזה תשתמשו בפרויקט של LookML לדוגמה שמוגדר באופן אוטומטי במכונות של Looker (Google Cloud core).

כדי לעבור לקובצי הפרויקט לדוגמה של LookML ב-Looker IDE, פועלים לפי השלבים הבאים:

  1. אם התפריט Develop לא מוצג, לוחצים על סמל התפריט הראשי של Looker ובוחרים באפשרות Develop.
  2. בתפריט Develop, בוחרים באפשרות sample_thelook_ecommerce.

‫Looker יפתח את החלונית File Browser של Looker IDE ויציג את קובצי הפרויקט לדוגמה של LookML.

יצירת תיקיית פרויקט חדשה

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

כדי ליצור תיקייה בפרויקט:

  1. בחלונית File Browser של Looker IDE, לוחצים על הסמל Add file or folder בחלק העליון של החלונית, ובוחרים באפשרות Create Folder בתפריט Add file or folder.

  2. בשם התיקייה החדשה, מזינים quickstart.

  3. לוחצים על יצירה.

‫Looker מוסיף את התיקייה החדשה לחלונית File Browser ב-Looker IDE.

מידע נוסף על תיקיות IDE

מידע נוסף על השימוש בתיקיות בפרויקט של LookML זמין בדפי התיעוד הבאים:

יצירת קובץ מודל LookML חדש

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

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

  1. בחלונית File Browser של Looker IDE, לוחצים על סמל האפשרויות הנוספות (3 נקודות) Folder Options של התיקייה quickstart שיצרתם בתהליך יצירת תיקיית פרויקט חדשה.
  2. בתפריט אפשרויות התיקייה, לוחצים על יצירת מודל.
  3. בתיבת הדו-שיח Create File, מזינים את השם quickstart_practice לקובץ החדש ולוחצים על Create. ‫Looker יוצר את הקובץ quickstart_practice.model בתיקייה quickstart ופותח את הקובץ החדש ב-Looker IDE. הנקודה הכחולה ליד הקובץ בחלונית דפדפן הקבצים מציינת שהקובץ חדש.
  4. בחלונית File Browser, לוחצים על התיקייה quickstart כדי להרחיב אותה ולראות את הקובץ quickstart_practice.model.
  5. ב-Looker IDE, לוחצים על הקובץ quickstart_practice.model כדי לפתוח אותו, אם הוא עדיין לא פתוח.

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

מידע נוסף על קובצי מודלים

כדי ליצור קובצי מודלים משלכם בעתיד, כדאי לעיין במקורות המידע הבאים:

יצירת קובץ תצוגה חדש של LookML

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

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

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

  1. בחלונית File Browser של Looker IDE, לוחצים על סמל האפשרויות הנוספות (3 נקודות) Folder Options של התיקייה quickstart שיצרתם בתהליך יצירת תיקיית פרויקט חדשה.
  2. בתפריט Folder Options, בוחרים באפשרות Create View from Table.

  3. בדף Create Views from Tables, לוחצים על השדה להזנת קלט Enter custom db ומקלידים bigquery-public-data:

    תיבת הדו-שיח Create Views from Tables.

  4. מקישים על Enter כדי לראות את מערכי הנתונים הציבוריים של BigQuery.

  5. גוללים ברשימה עד שמוצאים את מערך הנתונים thelook_ecommerce.

  6. לוחצים על מערך הנתונים thelook_ecommerce כדי להרחיב אותו.

  7. בוחרים את הטבלה order_items.

  8. לוחצים על הכפתור יצירת תצוגות בתחתית הדף.

‫Looker מציג את קובץ התצוגה order_items ב-IDE של Looker. בחלונית File Browser, התיקייה quickstart מורחבת וקובץ התצוגה order_items מוצג עם נקודה כחולה שמציינת שזה קובץ חדש.

מידע נוסף על קובצי תצוגה

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

עזרה מיידית ב-Looker IDE

עכשיו יצרתם קובץ מודל LookML וקובץ תצוגה של LookML. בשלבים הבאים של המדריך למתחילים, תתחילו לערוך את הקבצים האלה. לפני שמתחילים לערוך, כדאי להכיר את התכונה "עזרה מיידית" ב-Looker IDE. בחלונית Quick Help מופיעים הסברים ואפשרויות למיקום הנוכחי של הסמן בקובצי LookML:

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

אם החלונית עזרה מיידית לא פתוחה, אפשר לפתוח אותה בלחיצה על הסמל עזרה מיידית ב-Looker IDE:

יצירת ניתוחים לתצוגות שלכם

אחרי שמבצעים את ההליך יצירת קובץ מודל LookML חדש ואת ההליך יצירת קובץ תצוגה חדש של LookML, אפשר להגדיר Explore לקובץ התצוגה החדש כדי להשתמש ב-Looker לשליחת שאילתות על הנתונים שיצרתם להם מודל בקובץ התצוגה.

בדרך כלל, שאילתות Explore מוגדרות בקובץ מודל. (אפשר ליצור קובץ Explore נפרד, אבל לצורך המדריך למתחילים הזה, תיצרו את ה-Explore בקובץ המודל).

בקובץ LookML שבו מגדירים את ה-Explore, צריך להשתמש בפרמטר include כדי שאפשר יהיה להפנות לקובץ התצוגה בהגדרה של ה-Explore. ההליך הזה מסביר את השלבים האלה.

כדי ליצור Explore לקובץ התצוגה order_items:

  1. ב-Looker IDE, פותחים את הקובץ quickstart_practice.model.

  2. בקובץ quickstart_practice.model, מחליפים את השורה הקיימת שמכילה את הפרמטר include בשורה הבאה:

    include: "/quickstart/order_items.view"

  3. מוסיפים שורה חדשה מתחת לפרמטר include ומזינים את קוד ה-LookML הבא: none explore: order_items {}

  4. לוחצים על הכפתור Save Changes בחלק העליון של Looker IDE.

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

מידע נוסף על גיליונות ניתוח נתונים

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

יצירת שדה חדש

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

  • מאפיין הוא שדה שמייצג מאפיין, עובדה או ערך, שהמשתמשים יכולים לבחור מתוך בורר השדות ב-Explore, ואפשר להשתמש בו כדי לסנן שאילתה. אם השדה לא נמצא בתוך פונקציית צבירה כמו SUM,‏ COUNT וכדומה, הוא נחשב למאפיין. מערכת Looker יוצרת באופן אוטומטי מאפיין לכל עמודה בטבלת מסד הנתונים.
  • קבוצת מאפיינים משמשת ליצירת קבוצה של מאפיינים שמבוססים על זמן או על משך זמן, בבת אחת. לדוגמה, קבוצת המאפיינים של עמודת חותמת זמן תכיל מאפיינים נפרדים לתאריך, חודש, רבעון, שעה, שבוע ושנה. ‫Looker יוצר באופן אוטומטי קבוצת מאפיינים לשדות מבוססי-זמן שהוא מזהה בטבלת מסד הנתונים.
  • מדד הוא שדה ב-Explore שמייצג מידע מדיד על הנתונים, כמו סכומים, ספירות וכו'. מדד מוצהר בקובץ תצוגה ויכול להיות מסוג נתונים נצברים או לא נצברים. ‫Looker יוצר באופן אוטומטי מדד של type:count לקובץ התצוגה, שהוא המקבילה של COUNT(*) ב-SQL.

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

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

  1. פותחים את הקובץ quickstarts/order_items.view אם הוא עדיין לא פתוח: בחלונית File Browser של Looker IDE, לוחצים על התיקייה quickstart כדי להרחיב אותה, ואז לוחצים על הקובץ order_items.view כדי לפתוח אותו.
  2. בקובץ quickstarts/order_items.view, יוצרים שורה חדשה לפני הפרמטר dimension הראשון בקובץ.

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

    • משתמשים במקשי החיצים כדי לנווט ברשימת ההצעות לאפשרות dimension.
    • מקישים על Enter כדי להוסיף את הפרמטר שנבחר ל-LookML. ‫Looker יוסיף פרמטר dimension חדש בשורה החדשה שיצרתם.

  4. כדי לתת שם למאפיין החדש, לוחצים ב-IDE לפני {} ומקלידים shipped_to_delivered_days.

  5. לוחצים בתוך {} ומקישים על Enter כדי ליצור שורה חדשה בתוך {}.

  6. משלימים את ה-LookML של המאפיין החדש (אפשר להעתיק ולהדביק את ה-LookML הבא או להזין אותו ידנית כדי לראות איך ה-IDE של Looker מספק הנחיות):

    dimension: shipped_to_delivered_days {
  group_label: "Other Dates"
  type: duration_day
  sql_start: ${shipped_raw} ;;
  sql_end: ${delivered_raw} ;;
}

  7. בחלק העליון של Looker IDE, לוחצים על הכפתור Save Changes.

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

מידע נוסף על שדות LookML

כדי ליצור שדות משלכם בעתיד, כדאי לעיין במקורות המידע הבאים:

הצגה ובדיקה של השינויים בממשק המשתמש של Looker

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

כדי לראות ולבדוק את השינויים ב-Explore בממשק המשתמש של Looker, פועלים לפי השלבים הבאים:

  1. בקובץ quickstarts/order_items.view ב-Looker IDE, לוחצים על סמל החץ See file actions ליד השם של קובץ התצוגה בחלק העליון של חלונית עורך הקבצים, ובוחרים באפשרות Explore Order Items - quickstart_practice.

    תפריט הפעולות של See file, עם האפשרות Explore Order Items - quickstart_practice שנבחרה.

  2. בכלי לבחירת שדות של ה-Explore‏ Order Items, לוחצים על תווית הקבוצה Other Dates כדי להרחיב אותה, ואז לוחצים על המאפיין Shipped to Delivered Days כדי להוסיף אותו ל-Explore. (אפשר גם לחפש את המאפיין על ידי הקלדת Shipped to Delivered Days בתיבת החיפוש של בחירת השדות).

  3. בבוחר השדות של ה-Explore‏ Order Items, לוחצים על תווית הקבוצה Shipped Date כדי להרחיב אותה, ואז לוחצים על המאפיין Date כדי להוסיף אותו ל-Explore.

  4. בבוחר השדות של ה-Explore‏ Order Items, לוחצים על תווית הקבוצה Delivered Date כדי להרחיב אותה, ואז לוחצים על המאפיין Date כדי להוסיף אותו ל-Explore.

  5. לוחצים על הלחצן Run בחלק העליון של ה-Explore.

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

אימות של LookML

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

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

שמירת השינויים

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

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

קובצי LookML וה-Explore שבהם צפיתם במדריך למתחילים הזה זמינים רק בהסתעפות Git האישית שלכם במצב פיתוח. אם אתם רוצים שהמודל הזה יהיה זמין למשתמשים אחרים במכונה של Looker (Google Cloud core), אתם צריכים לבצע commit לשינויים, למזג את ההסתעפות ולפרוס את ההסתעפות בסביבת הייצור.

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

הסרת המשאבים

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

  1. אם התפריט Develop לא מוצג, לוחצים על סמל התפריט הראשי של Looker ובוחרים באפשרות Develop.
  2. בתפריט Develop, בוחרים באפשרות sample_thelook_ecommerce.
  3. בחלונית File Browser של Looker IDE, לוחצים על סמל האפשרויות הנוספות (3 נקודות) Folder Options של התיקייה quickstart שיצרתם בתהליך יצירת תיקיית פרויקט חדשה.
  4. בתפריט אפשרויות התיקייה, לוחצים על מחיקה.
  5. בחלון מחיקת תיקייה, לוחצים על מחיקה.

‫Looker מוחק את התיקייה quickstart ואת כל התוכן שלה.

המאמרים הבאים