התוסף Looker ל-VS Code משתמש במודל פיתוח שמתבסס על נתונים מקומיים. המודל הזה שומר על קשר תלת-כיווני בין מערכת הקבצים המקומית, מצב הפיתוח של מופע Looker ומאגר Git מרוחק.
במדריך הזה מוסבר איך התוסף מסנכרן קבצים ואיך פעולות Git מקומיות משפיעות על פרויקט Looker.
מנגנון הסנכרון
התוסף מנהל אוטומטית את הסנכרון של תוכן הקובץ בין סביבת הפיתוח המשולבת המקומית לבין שרת Looker.
פתיחת קבצים (קריאה בפתיחה)
כשפותחים קובץ .lkml בסביבת הפיתוח המשולבת המקומית, התוסף מאחזר באופן אוטומטי את הגרסה הנוכחית של הקובץ מהענף שהוצא לבדיקה במצב פיתוח במופע Looker. כך תוכלו לוודא שאתם תמיד עובדים עם הגרסה העדכנית ביותר של הקוד.
שמירת קבצים (כתיבה בשמירה)
כששומרים קובץ באופן מקומי (Command-S ב-Mac או Ctrl+S ב-Windows/Linux), התוסף מעביר מיד את השינויים המקומיים לשרת Looker. השינויים האלה מוצגים ב-IDE של Looker שמבוסס על דפדפן כשנמצאים במצב פיתוח.
טיפול בהתנגשויות בסנכרון
אם קובץ נערך בסביבת הפיתוח המשולבת (IDE) של Looker שמבוססת על דפדפן, בזמן שהוא פתוח גם ב-VS Code, יכול להיווצר קונפליקט.
כברירת מחדל, התוסף יחליף את הגרסה בשרת Looker בגרסת VS Code המקומית שלכם.
עם זאת, אם הפעלתם את ההגדרה looker.askBeforeOverwritingRemote, תוצג אזהרה ב-VS Code כשאתם מנסים לשמור קובץ ששונה בשרת. אפשר לבצע אחת מהפעולות הבאות:
- Keep Local (שמירה מקומית): מחליפים את הגרסה בשרת Looker בגרסה המקומית ב-VS Code.
- Pull Remote: מחליף את הקובץ המקומי בגרסה משרת Looker.
ההגדרה looker.askBeforeOverwritingRemote מושבתת כברירת מחדל.
פעולות Git מקומיות
התוסף מסנכרן את תוכן הקובץ, אבל אתם צריכים לנהל את ה-repository של Git באמצעות פקודות Git רגילות במסוף המקומי או בכרטיסייה Source Control (בקרת מקור) של ה-IDE המקומי.
ניהול הסתעפויות
כשמחליפים בין הסתעפויות באופן מקומי באמצעות git checkout, התוסף מזהה את השינוי ומחליף באופן אוטומטי את הסשן בשרת Looker להסתעפות התואמת.
מצב Git ב-Looker
כששומרים שינויים בקובץ, הם מסונכרנים עם מופע Looker ומופיעים כשינויים שלא בוצעו ב-Looker IDE מבוסס-הדפדפן. אם תבצעו את השינויים האלה באמצעות Git בסביבה המקומית, הם ימשיכו להופיע כשינויים שלא בוצעו ב-IDE של Looker עד שתדחפו אותם למאגר המרוחק.
כשמשתמשים ב-git push, מופעלת משיכה של השינויים המחויבים ממאגר מרוחק של מופע Looker. אחרי שהמופע של Looker ימשוך נתונים ממקור מרוחק, השינויים שביצעתם ושדחפתם כבר לא יופיעו כשינויים שלא נשמרו ב-Looker IDE. רק קבצים שנשמרו באופן מקומי אבל עדיין לא בוצעו לגביהם פעולות commit ו-push יופיעו כקבצים שלא בוצעו לגביהם פעולות commit.
אימות LookML
התוסף מפעיל אוטומטית את כלי האימות של LookML ב-Looker בכל פעם ששומרים שינוי. שגיאות תחביר ושגיאות במודל שמוחזרות על ידי כלי האימות יופיעו בשורה בתוך הקבצים בסביבת הפיתוח המשולבת המקומית. אם רוצים, אפשר גם להריץ את מאמת LookML באופן ידני בלי לשמור קבצים באמצעות הפקודה Looker: Validate LookML בלוח הפקודות.