גישה לפרטי הפרויקט ועריכה שלהם

בדף LookML Projects (פרויקטים של LookML) מוצגת רשימה של כל הפרויקטים של LookML במופע Looker, וכל המודלים בכל פרויקט.

כדי להיכנס לדף LookML projects (פרויקטים של LookML):

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

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

בדף התיעוד הזה אנחנו יוצאים מנקודת הנחה שכבר יצרתם פרויקט באחת מהשיטות הבאות:

הצגת פרויקטים קיימים והמודלים שלהם

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

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

במאמר יצירת מודל מוסבר איך מציינים פרויקט חדש או מודל חדש לפרויקט קיים.

צפייה בכרטיס המוצר של פרויקט

בדף LookML Projects מוצגים הרכיבים הבאים לכל פרויקט:

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

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

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

צפייה בדף של פרויקט ב-Marketplace

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

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

צפייה בפרטי הפרויקט בהמתנה

הקטע Pending Projects (פרויקטים בהמתנה) מכיל פרויקטים ומודלים שהוגדרו אבל עדיין לא נוצר להם LookML או שהם הוגדרו באופן ידני.

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

הקטע Pending Projects כולל את הרכיבים הבאים:

  • העמודה Project: בקטע הזה מפורטים פרויקטים שהוגדרו אבל עדיין לא נוצרו. שם הפרויקט בשדה הזה הוא השם המיועד של הפרויקט. לוחצים על שם הפרויקט כדי להציג את הדף New Project שבו אפשר ליצור את הפרויקט. כדי להגיע לדף פרויקט חדש, צריך להיות במצב פיתוח.
  • העמודה מודלים: שם המודל שצוין כשנוצרה הגדרת המודל.
  • העמודה 'חיבורים מותרים': בעמודה שמשמאל לשם המודל מוצגים החיבורים שהיו מותרים למודל הזה כשנוצר ההגדרה של המודל.
  • לחצן הגדרה: באמצעות לחצן ההגדרה אפשר לשנות את שם הפרויקט ואת החיבורים שמותרים למודל הזה.
  • הלחצן Add LookML: הלחצן Add LookML פותח את הדף New Project של הפרויקט, שבו אפשר ליצור באופן אוטומטי קוד LookML שמבוסס על קבוצה של טבלאות במסד הנתונים.

הוספה ועריכה של הגדרות מודל

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

אם למודל אין הגדרה, כשלוחצים על הגדרה, מוצג החלון הגדרת מודל. בחלון Configure a Model (הגדרת מודל), אפשר לציין את שם המודל, שם הפרויקט והחיבורים שזמינים למודל.

רשימת החיבורים כוללת רק חיבורים שאפשר להשתמש בהם בפרויקט של המודל. לחיבורים שהוגדרו לשימוש בכל הפרויקטים יש את התווית (Instance wide).

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

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

כשעורכים את ההגדרה של מודל, אפשר לראות את שם המודל אבל אי אפשר לשנות אותו. השמות של המודלים נקבעים לפי שמות הקבצים שבהם אתם משתמשים כשאתם עורכים את קובצי המודל ב-Looker IDE.

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

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

שינוי השם של פרויקט

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

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

אם יש לכם הרשאה ל-Looker manage_models, אתם יכולים לשנות את השם של פרויקט LookML בדף הגדרות הפרויקט. מפתחי Looker שאינם אדמינים יכולים לראות את הדף Project Configuration, אבל לא יכולים לשנות את האפשרויות שמופיעות בו.

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

  1. מוודאים שמצב הפיתוח מופעל.
  2. עוברים לפרויקט ב-Looker IDE.
  3. בפרויקט, לוחצים על הגדרות בסרגל הניווט של סביבת הפיתוח המשולבת (IDE) כדי לפתוח את חלונית הגדרות הפרויקט.
  4. בחלונית הגדרות הפרויקט, בוחרים באפשרות Configuration (הגדרה).
  5. כדי לערוך את שם הפרויקט, משתמשים בשדה שם בקטע הגדרת הפרויקט.
  6. בדף Project Configuration (הגדרת הפרויקט), לוחצים על Save Project Configuration (שמירת הגדרת הפרויקט) כדי לשמור את שם הפרויקט החדש.

מחיקת פרויקט

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

פרויקט שנמחק לא מופיע יותר בקטע Projects בדף LookML Projects, אבל הוא עדיין מופיע בקטע Configured Projects.

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

  1. עוברים לפרויקט ב-Looker IDE.
  2. בפרויקט, לוחצים על הגדרות בסרגל הניווט של סביבת הפיתוח המשולבת (IDE) כדי לפתוח את חלונית הגדרות הפרויקט.
  3. בחלונית הגדרות הפרויקט, בוחרים באפשרות הגדרה כדי לראות את הגדרת הפרויקט.
  4. בקטע Project Configuration (הגדרת הפרויקט), בוחרים באפשרות Delete Project (מחיקת הפרויקט).
  5. בחלון מחיקת פרויקט, בודקים את האזהרות ואת השינויים שלא סונכרנו שיימחקו אם הפרויקט יימחק.
  6. אם אתם בטוחים שצריך למחוק את הפרויקט, מקלידים את שם הפרויקט בשדה. כדי לבטל את הפעולה ולחזור לפרויקט, משתמשים בלחצן הקודם בדפדפן.
  7. לוחצים על הלחצן מחיקה לצמיתות של <שם הפרויקט>.