כתיבת קוד LookML באמצעות כלי תכנות אג'נטיים

1. מבוא

כלי כתיבת קוד מבוססי-סוכנים שמבוססים על המערכת האקולוגית של VS Code הפכו לפופולריים מאוד. ‫Cursor ו-Antigravity הן רק שתי דוגמאות. בשיעור Codelab הזה נסביר איך לכתוב LookML באמצעות כלי הקוד האלה.

מה עושים

בשיעור Codelab הזה נשתמש בתוסף VS Code של Looker כדי לשנות מודל LookML, להוסיף מדד חדש, לבדוק את המדד החדש ואז ליצור מרכז שליטה של LookML באמצעות המדד החדש הזה. כל הפעולות האלה יתבצעו באמצעות הנחיה לסוכן תכנות.

מה תצטרכו

קהל היעד: מפתחי LookML, מהנדסי נתונים ואדריכלים.

2. הגדרת מופע ב-Looker

יצירת פרויקט ב-Google Cloud

  1. במסוף Google Cloud, בדף לבחירת הפרויקט, בוחרים פרויקט ב-Google Cloud או יוצרים פרויקט.
  2. הקפידו לוודא שהחיוב מופעל בפרויקט שלכם ב-Cloud. כך בודקים אם החיוב מופעל בפרויקט

קישור Looker למקור הנתונים

  1. ב-Looker, בקטע Admin (ניהול), עוברים לכותרת Databases (מסדי נתונים) ולוחצים על Connections (חיבורים).
  2. לוחצים על הוספת חיבור בפינה השמאלית העליונה של המסך.
  3. יוצרים מקור נתונים חדש למערך הנתונים Cymbal Gadgets. נותנים לו את השם cymbal_gadgets. בוחרים באפשרות Google BigQuery Standard SQL בשביל SQL Dialect. צילום מסך של הגדרות חיבור כלליות
  4. בדף הבא, מזינים את שם פרויקט הענן ב-Google Cloud, את פרויקט האחסון looker-private-demo ואת שם מערך הנתונים cymbal_gadgets. צילום מסך של הגדרות מסד הנתונים
  5. מאשרים את ברירות המחדל בכל השדות הנותרים ומשלימים את תהליך היצירה של מקור הנתונים החדש.
  6. ב-SQL Runner, מוודאים שאפשר להריץ שאילתות על מערך הנתונים על ידי הרצת
    SELECT count(*)
FROM looker-private-demo.cymbal_gadgets.transactions

ייבוא הפרויקט מ-GitHub

  1. מבצעים Fork לפרויקט https://github.com/looker-open-source/cymbal_gadgets מ-GitHub למאגר משלכם. אי אפשר להוסיף מפתח פריסה לפרויקט שאתם לא הבעלים שלו, ולכן צריך ליצור Fork כדי לקשר את הפרויקט ל-Looker.
  2. מפעילים את מצב פיתוח.
  3. בוחרים באפשרות פיתוח ואז באפשרות פרויקטים.
  4. בדף LookML Projects (פרויקטים של LookML), לוחצים על New Model (מודל חדש).
  5. לוחצים על הקישור כדי להשתמש בדף הישן ליצירת מודל LookML. צילום מסך של הקישור לתיבת הדו-שיח הישנה ליצירת מודל
  6. יוצרים פרויקט חדש וריק ב-Looker בשם cymbal_gadgets. צילום מסך של תיבת הדו-שיח של פרויקט חדש
  7. בוחרים באפשרות Configure Git כדי לקשר אותו למאגר המפוצל שיצרתם. צילום מסך של הגדרת Git
  8. מוסיפים את Deploy Key למאגר Git. חשוב לסמן את התיבה כדי לאפשר גישת כתיבה באמצעות מפתח הפריסה. צילום מסך של הגדרת מפתח הפריסה של Git
  9. לאחר מכן בוחרים באפשרות בדיקה והשלמת ההגדרה. צילום מסך של הגדרת הפרויקט שהושלמה
  10. כדי לוודא שהפרויקט ומקור הנתונים פועלים, מריצים שאילתה על נתונים מהניתוח "🛍️ Cymbal Gadgets: Transactions & Sales".
  11. פותחים את פרויקט cymbal_gadgets בכלי לעריכת LookML ולוחצים על הלחצן Create Developer Copy (יצירת עותק למפתחים) בפינה השמאלית העליונה.
  12. בקטע Git Actions לוחצים על Push Changes To Remote כדי שהענף dev יהיה זמין מ-GitHub. צילום מסך של Git Actions
  13. מריצים את הפקודה הבאה ממסוף במחשב:
    ‫
    cd $HOME
git clone git@github.com:YOUR_GITHUB_USER/cymbal_gadgets.git
cd cymbal_gadgets
git checkout YOUR_DEV_BRANCH
    מחליפים את שם חשבון המשתמש ב-GitHub ב-YOUR_GITHUB_USER. מחליפים גם את YOUR_DEV_BRANCH בשם של ענף הפיתוח. שם ענף הפיתוח יהיה משהו כמו dev-john-doe-jhgr – כלומר המילה dev ואחריה השם הפרטי ושם המשפחה שלכם, ואז מחרוזת קצרה של תווים אקראיים. הסתעפות הפיתוח האישית שלכם תופיע בחלק העליון של כלי העריכה של LookML בממשק המשתמש של Looker.

3. הגדרת סביבת פיתוח משולבת (IDE) עם סוכן

התקנת התוסף של VS Code

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

התקנה של שרת MCP Toolbox for Databases

כדי לתת ל-Antigravity גישה ל-Looker API (הפעלת שאילתות, בדיקת SQL, בדיקת מודל LookML ובדיקת מידע על סכימת החיבור), צריך להפעיל שרת מקומי של MCP Toolbox for Databases. ‫MCP Toolbox כולל את ההטמעה הרשמית של Looker MCP. בקטע הזה נסביר איך להגדיר את זה במכונת Looker.

  1. קודם צריך ליצור API client_id ו-client_secret. משתמשים במדריך למפתחות API של Looker כדי ליצור את הערכים client_id ו-client_secret עבור המשתמש. תצטרכו גם את כתובת ה-URL הבסיסית של המכונה של Looker.
  2. עכשיו משתמשים ב-npx כדי להתקין את ארגז הכלים של MCP. אתם יכולים לספק את כתובת ה-URL של מופע Looker ואת פרטי הכניסה ל-API כמשתני סביבה מוטבעים, או להגדיר אותם בסביבת השל. מריצים את הפקודה הבאה בסביבת מעטפת ב-Mac וב-Linux:
    ‫
    LOOKER_BASE_URL="https://your-instance.looker.com" \
LOOKER_CLIENT_ID="YOUR_CLIENT_ID" \
LOOKER_CLIENT_SECRET="YOUR_CLIENT_SECRET" \
npx @toolbox-sdk/server --prebuilt=looker,looker-dev
    ב-Windows, מריצים את הפקודה הבאה ב-Powershell:
    $env:LOOKER_BASE_URL="https://your-instance.looker.com"
$env:LOOKER_CLIENT_ID="YOUR_CLIENT_ID"
$env:LOOKER_CLIENT_SECRET="YOUR_CLIENT_SECRET"
npx @toolbox-sdk/server --prebuilt=looker,looker-dev

הגדרת התוסף של VS Code

בשלב הזה, תגדירו את התוסף של VS Code כדי להתחבר ל-Looker ולשרת ה-MCP של Looker.

  1. ב-Antigravity, משתמשים בקיצור הדרך CMD-SHIFT-P (ב-Mac) או CTRL+SHIFT+P (ב-Linux/Windows) כדי לפתוח את לוח הפקודות ובוחרים באפשרות Preferences: Open Workspace Settings (JSON).
  2. כדי להגדיר את התוסף באמצעות client_id ו-client_secret, מוסיפים את הפרטים הבאים להגדרות Workspace: לשימוש ב-looker.projectId צריך להשתמש ב-cymbal_gadgets:
    {
   "looker.instanceURL": "https://your-instance.looker.com",
   "looker.clientId": "YOUR_API_KEY_CLIENT_ID",
   "looker.clientSecret": "YOUR_API_KEY_CLIENT_SECRET",
   "looker.projectId": "cymbal_gadgets"
}

פתיחת העורך

  1. פותחים את Antigravity.
  2. לוחצים על קובץ > פתיחת תיקייה....
  3. מנווטים לתיקייה cymbal_gadgets ובוחרים בה.

4. יצירת מדד של ערך הלקוח לטווח הארוך

קודם יוצרים מדד חדש במודל LookML הקיים באמצעות הסוכן. מדד Customer Lifetime Value יהיה שימושי במקרה השימוש הזה בענף הקמעונאות. תשתמשו בסוכן כדי לקבוע את המתודולוגיה ואת LookML למדד הזה.

הנחיה של הסוכן

בפרויקט cymbal_gadgets בסביבת העבודה של Antigravity, אמור להופיע ממשק שיחה חדש בצד שמאל. מתחילים את השיחה במצב תכנון באמצעות מודל Gemini העדכני עם הפרומפט: Create a Customer Lifetime Value measure.

צילום מסך של ההנחיה ב-Antigravity

בדיקת תוכנית ההטמעה

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

צילום מסך של תוכנית ההטמעה

בדיקת קוד LookML

בודקים את קוד ה-LookML ששוּנה. חשוב לוודא שהשינויים הגיוניים ותקפים.

צילום מסך של קוד LookML שהשתנה

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

בדיקה בסביבת פיתוח משולבת (IDE)

כאן אפשר לכתוב פרומפט ל-Antigravity לגבי query CLV broken down by customer loyalty tier ‫Antigravity ישתמש בשרת Looker MCP כדי למצוא את המודלים, לבדוק את השדות הזמינים ולהריץ שאילתה באמצעות Looker. התוצאה תיראה בערך כך:

צילום מסך של נתונים ב-Antigravity

בדיקה ב-Looker

ב-Looker, כשהאפשרות 'מצב פיתוח' מופעלת, פותחים את האפשרות 🛍️ Cymbal Gadgets: Transactions & Sales (גאדג'טים של Cymbal: עסקאות ומכירות). בוחרים את מדד ערך הלקוח לטווח הארוך ואז משנים את ציר הנתונים לפי שנת ההרשמה של הלקוח. מריצים את השאילתה. הוא אמור להיראות בערך כך.

צילום מסך של הניתוח

5. יצירת לוח בקרה של ערך הלקוח לטווח הארוך

עכשיו ננסה דוגמה מורכבת יותר. נבקש מהסוכן ליצור מרכז בקרה חדש לגמרי ב-LookML.

שליחת בקשה לסוכן ליצירת מרכז בקרה חדש

עוברים חזרה ל-Antigravity. באותו שיחה, מוודאים שמצב התכנון והמודל העדכני של Gemini נבחרו. לאחר מכן מזינים את ההנחיה Create a dashboard showing customer lifetime value based on customer loyalty tier.

צילום מסך של יצירת מרכז הבקרה

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

בדיקה ב-Looker

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

צילום מסך של לוח הבקרה החדש

6. הסרת המשאבים

  1. ב-Antigravity, בחלונית Source Control (בקרת מקור), מחזירים את השינויים ב-LookML אם רוצים. לצד כל קובץ LookML שעבר שינוי יופיע סמל כמו ↶ כדי לשחזר את הקובץ. לוחצים על הלחצן הזה לכל קובץ. צילום מסך של ביטול השינויים
  2. ב-Looker, בוחרים באפשרות Admin (ניהול) ואז באפשרות Database (מסד נתונים) ואז באפשרות Connections (חיבורים). לוחצים על סמל גלגל השיניים של החיבור cymbal_gadgets ובוחרים באפשרות מחיקה. מאשרים שרוצים למחוק את הקישור.
  3. ב-Looker, משתמשים במצב פיתוח. בוחרים באפשרות פיתוח ואז בפרויקט cymbal_gadgets. בקטע Project Settings (הגדרות הפרויקט), בוחרים באפשרות Delete Project (מחיקת הפרויקט). כדי לאשר את מחיקת הפרויקט, מקלידים את שם הפרויקט – cymbal_gadgets – ואז לוחצים על הלחצן מחיקה סופית של cymbal_gadgets.

7. מזל טוב

כל הכבוד, סיימתם את ה-Codelab.

מה נכלל

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

פעולות שכדאי לנסות

עכשיו נסו את ההנחיות הבאות בממשק המשתמש כדי לראות יכולות שונות של סביבת הפיתוח המשולבת (IDE) מבוססת-סוכן:

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

מידע נוסף