יצירת פרויקט חדש של LookML

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

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

משתמשי Looker עם ההרשאה manage_models יכולים ליצור מודלים של LookML במכונה של Looker.

יצירת פרויקט

כדי ליצור פרויקט:

  1. מוודאים שאתם נמצאים במצב פיתוח.

  2. בקטע Develop בחלונית הניווט, לוחצים על Projects.

  3. בדף LookML Projects, לוחצים על New LookML Project כדי לבחור את האפשרויות לפרויקט.

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

אפשר ליצור פרויקט ב-Looker בכמה דרכים, והשלבים תלויים באפשרות Starting Point שבוחרים בדף New Project. בקטעים הבאים מוסבר איך נקודות ההתחלה האלה פועלות:

יצירת מודל באופן אוטומטי ממסד הנתונים

בדף New Project, מגדירים את האפשרויות הבאות כדי ליצור מודל באופן אוטומטי ממסד נתונים.

  1. שם הפרויקט: נותנים שם לפרויקט. שמות הפרויקטים תלויי אותיות רישיות (case-sensitive) ויכולים להכיל רק תווים אלפאנומריים, _, . ו--. חשוב לבחור את שם הפרויקט בקפידה ולהתייחס אליו כמזהה קבוע של הפרויקט, כי Looker משתמש בשם הפרויקט בדרכים הבאות:

    • כדי לזהות את הפרויקט של קריאות ל-API שכוללות את הפרמטר project_id.
    • כדי לזהות את הפרויקט במסד הנתונים הפנימי של המכונה של Looker.
    • כדי לזהות את הפרויקט לייבוא פרויקט מקומי.
    • כדי להציג את הפרויקט בדף LookML Projects.
    • כדי להציג את הפרויקט בקטע Develop בחלונית הניווט של Looker.
    • כחלק מכתובת ה-URL של קובצי הפרויקט. לדוגמה, במופע של Looker עם כתובת ה-URL‏ example.looker.com, קובץ המניפסט של הפרויקט שנקרא ecommerce נמצא בכתובת ה-URL הזו: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

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

  3. חיבור: בתפריט הנפתח, בוחרים את השם של החיבור למסד הנתונים.

  4. יצירת תצוגות מתוך: בוחרים אחת מהאפשרויות הבאות:

    • ‫All Tables: מחולל ה-LookML יוצר קובץ תצוגה לכל טבלה במסד הנתונים.
    • ‫Single Table: מחולל ה-LookML יוצר תצוגה לטבלה אחת במסד הנתונים. אם בוחרים באפשרות הזו, צריך להזין את השם של טבלת מסד הנתונים.

  5. ‫Schemas: כדי ליצור קבצים לסכימה אחת בלבד במסד הנתונים, מזינים את שם הסכימה בשדה הטקסט Schemas. אפשר לציין כמה סכימות, מופרדות בפסיקים.

  6. התעלמות מקידומות: כדי להשמיט את הקידומות של הטבלאות משמות קובצי התצוגה, מזינים את הקידומות של מסד הנתונים בשדה התעלמות מקידומות. השדה הזה תלוי אותיות רישיות. אפשר לציין כמה קידומות, מופרדות בפסיקים. לדוגמה, הטבלאות שלכם נקראות dwh_orders ו-DBS_users. אם מזינים dwh, DBS בשדה הטקסט Ignore Prefixes, המערכת של Looker יוצרת קובצי תצוגה בשמות orders ו-users.

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

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

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

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

שכפול מאגר Git ציבורי מהדף New Project

אם בוחרים באפשרות Clone Public Git Repository כנקודת ההתחלה בדף New Project, המערכת של Looker מעתיקה את הקבצים ממאגר Git ציבורי לפרויקט חדש של LookML.

ב-Looker אפשר לשכפל מאגר Git ציבורי באמצעות כתובת ה-URL של המאגר ב-HTTPS.

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

  1. מוודאים שאתם נמצאים במצב פיתוח.
  2. בקטע Develop בחלונית הניווט של Looker, בוחרים באפשרות Projects.

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

    • לוחצים על הלחצן New LookML Project כדי לפתוח את הדף New Project.
    • לוחצים על הכפתור New Model כדי לפתוח את הדף Create a Model, ואז בבאנר המידע שבדף Create a Model לוחצים על הקישור click here כדי לפתוח את הדף New Project.

  4. בשדה Project Name, נותנים שם לפרויקט. שמות הפרויקטים תלויי אותיות רישיות (case-sensitive) ולא יכולים לכלול רווחים או תווים מיוחדים מסוימים. חשוב לבחור את שם הפרויקט בקפידה ולהתייחס אליו כמזהה קבוע של הפרויקט, כי Looker משתמש בשם הפרויקט בדרכים הבאות:

    • כדי לזהות את הפרויקט של קריאות ל-API שכוללות את הפרמטר project_id.
    • כדי לזהות את הפרויקט במסד הנתונים הפנימי של המכונה של Looker.
    • כדי לזהות את הפרויקט לייבוא פרויקט מקומי.
    • כדי להציג את הפרויקט בדף LookML Projects.
    • כדי להציג את הפרויקט בקטע Develop בחלונית הניווט של Looker.
    • כחלק מכתובת ה-URL של קובצי הפרויקט. לדוגמה, במופע של Looker עם כתובת ה-URL‏ example.looker.com, קובץ המניפסט של הפרויקט שנקרא ecommerce נמצא בכתובת ה-URL הזו: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  5. בשדה Starting Point, בוחרים באפשרות Clone Public Git Repository.

  6. בשדה Git Repository URL, מזינים את כתובת ה-URL של מאגר Git הציבורי. חשוב לוודא שכתובת ה-URL היא בפורמט https://github.com/example/my-repository.git.

  7. לוחצים על Create Project. ‫Looker משכפל את המאגר ופותח את Looker IDE לפרויקט LookML החדש עם קובצי הפרויקט מהמאגר המשוכפל.

אחרי ש-Looker יוצר את הפרויקט החדש של LookML, צריך להגדיר ניהול גרסאות של Git על ידי התחברות למאגר Git. בדף התיעוד Setting up and testing a Git connection מוסבר איך להתחבר ל-Git באמצעות HTTPS או SSH.

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

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

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

שיטה חלופית לשכפול מאגר Git ציבורי

הדרך הכי קלה לשכפל מאגר Git ציבורי היא להשתמש בדף New Project ב-Looker.

אפשר גם ליצור עותק של המאגר ולחבר אותו לפרויקט ריק ב-Looker. כך עושים את זה:

  1. עוברים לספק ה-Git ויוצרים עותק של המאגר.
  2. ב-Looker, יוצרים פרויקט ריק כמו שמתואר בקטע יצירת פרויקט ריק בדף הזה.
  3. אחרי שיוצרים את הפרויקט הריק החדש של LookML, מגדירים את החיבור של הפרויקט ל-Git למאגר ה-Git המפוצל באמצעות HTTPS או SSH.

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

יצירת פרויקט ריק

אם בוחרים באפשרות Blank Project כנקודת ההתחלה בדף New Project, המערכת של Looker יוצרת פרויקט ריק כדי שתוכלו ליצור את קובצי ה-LookML שלכם מאפס.

כדי ליצור פרויקט ריק:

  1. מוודאים שאתם נמצאים במצב פיתוח.
  2. בקטע Develop בחלונית הניווט של Looker, בוחרים באפשרות Projects.

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

    • לוחצים על הלחצן New LookML Project כדי לפתוח את הדף New Project.
    • לוחצים על הכפתור New Model כדי לפתוח את הדף Create a Model, ואז בבאנר המידע שבדף Create a Model לוחצים על הקישור click here כדי לפתוח את הדף New Project.

  4. בשדה Project Name, נותנים שם לפרויקט. שמות הפרויקטים תלויי אותיות רישיות ולא יכולים לכלול רווחים או תווים מיוחדים מסוימים. חשוב לבחור את שם הפרויקט בקפידה ולהתייחס אליו כמזהה קבוע של הפרויקט, כי Looker משתמש בשם הפרויקט בדרכים הבאות:

    • כדי לזהות את הפרויקט של קריאות ל-API שכוללות את הפרמטר project_id.
    • כדי לזהות את הפרויקט במסד הנתונים הפנימי של המכונה של Looker.
    • כדי לזהות את הפרויקט לייבוא פרויקט מקומי.
    • כדי להציג את הפרויקט בדף LookML Projects.
    • כדי להציג את הפרויקט בקטע Develop בחלונית הניווט של Looker.
    • כחלק מכתובת ה-URL של קובצי הפרויקט. לדוגמה, במופע של Looker עם כתובת ה-URL‏ example.looker.com, קובץ המניפסט של הפרויקט שנקרא ecommerce נמצא בכתובת ה-URL הזו: https://example.looker.com/projects/ecommerce/files/manifest.lkml.

  5. בשדה Starting Point, בוחרים באפשרות Blank Project.

  6. לוחצים על Create Project. ‫Looker יוצר את הפרויקט ופותח אותו ב-Looker IDE.

פתרון השגיאה "הפרויקט כבר קיים"

כשיוצרים פרויקט חדש ב-Looker IDE, יכול להיות שתופיע השגיאה Project already exists, גם אם הפרויקט לא גלוי בממשק המשתמש של Looker (כולל למשתמשים עם הרשאות אדמין). הבעיה הזו מתרחשת אם משתמש יצר בעבר פרויקט עם אותו שם במצב פיתוח, אבל לא פרס את המודל או העביר את השינויים לסביבת הייצור. ב-Looker, פרויקט במצב הזה, שעדיין לא בוצע לו commit, גלוי רק למשתמש שיצר אותו.

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

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

השלבים הבאים

אחרי שיוצרים פרויקט, אפשר: