תחילת העבודה עם תוסף Looker ל-VS Code

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

התוסף מבוסס על המסגרת של Visual Studio Code‏ (VS Code), והוא תומך בסביבות פיתוח משולבות (IDE) שמבוססות על VS Code IDE, כמו סביבות הפיתוח המשולבות וכלי התכנות הבאים:

  • Claude Code
  • Codex
  • סמן
  • Kiro
  • VS Code
  • גלישת רוח
  • Zed

סביבות פיתוח משולבות (IDE) שלא מבוססות על VS Code, כמו IntelliJ ו-Eclipse, לא נתמכות על ידי התוסף Looker ל-VS Code.

במדריך הזה מוסבר איך להגדיר את התוסף ולאמת אותו.

תהליך עבודה מבוסס-AI

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

  • התוסף של Looker ל-VS Code.
  • סביבת פיתוח משולבת (IDE) מקומית שמבוססת על VS Code. סביבת הפיתוח המשולבת (IDE) צריכה להכיל סוכן AI מובנה (לדוגמה, Cursor), או שאם היא לא מכילה סוכן AI מובנה (כמו VS Code בסיסי), היא צריכה להיות משולבת עם כלי AI עצמאי (כמו Gemini CLI או Claude Code). הוראות לחיבור סביבת פיתוח משולבת (IDE) לסוכן מופיעות במסמכי התיעוד של סביבת הפיתוח המקומית.
  • שרת MCP, כמו שרת ה-MCP שמנוהל על ידי Looker.

מידע נוסף על תהליך העבודה מבוסס-AI זמין במאמר פיתוח בעזרת AI (תכנות בשיטת Vibe coding) באמצעות Looker.

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

לפני שמתקינים את התוסף, צריך לעמוד בדרישות הבאות:

  • חיבור לכלים מבוססי-AI: אם אתם מתכננים להשתמש בפיתוח מבוסס-AI, אתם צריכים לחבר את סביבת הפיתוח המשולבת (IDE) ואת סוכן ה-AI לשרת ה-MCP שמנוהל על ידי Looker. ההגדרה ודוגמה להגדרה מופיעות בדף התיעוד Looker-managed MCP server. פרטים נוספים מופיעים במסמכי התיעוד של הכלים.
  • הרשאות ב-Looker: כדי לערוך מודלים, צריכה להיות לכם הרשאת develop ב-Looker.
  • מופע Looker: המופע צריך להריץ Looker 26.6 ואילך.
  • התקנת Git: צריך להתקין את Git במחשב המקומי כדי לשכפל ולנהל את מאגר LookML.
  • הגדרת הפרויקט: צריך להגדיר את פרויקט LookML ל-Git.
  • מזהה לקוח ב-OAuth: אם אתם משתמשים באימות OAuth (מומלץ), אתם צריכים לקבל מזהה לקוח ב-OAuth מאדמין Looker.

הגדרת האדמין

אם הארגון שלכם משתמש ב-OAuth לאימות, אדמין ב-Looker צריך לרשום את התוסף Looker ל-VS Code כלקוח OAuth בממשק המשתמש של Looker Admin.

משתמשים ב-API Explorer של Looker כדי להגדיר שילוב של OAuth. אפשר לגשת אל API Explorer באחת מהדרכים הבאות:

‫API Explorer מותקן

אם API Explorer כבר מותקן במכונה של Looker, אפשר לגשת אליו באמצעות פורמט כתובת ה-URL הבא:

LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/

‫API Explorer לא מותקן

אם אין לכם את API Explorer במכונה של Looker, אתם יכולים להתקין אותו מ-Looker Marketplace. מידע על התקנת API Explorer זמין בדף שימוש ב-API Explorer.

מופע פרטי של PSA

אם אתם משתמשים במופע של חיבורים פרטיים ב-Looker (Google Cloud core) שמשתמש בגישה לשירותים פרטיים, אי אפשר להשתמש ב-Looker Marketplace וב-API Explorer. כדי לרשום סוכן AI, צריך לשלוח קריאה ישירה לנקודת קצה ל-API‏ oauth_client_apps. אם משתמשים בשיטה הזו, אפשר לדלג על שאר השלבים בתהליך הזה של API Explorer.

בדוגמה הבאה מוצגת פקודת curl שאפשר להשתמש בה עם נקודת הקצה oauth_client_apps כדי לרשום את הסוכן.

curl -X POST "https://LOOKER_INSTANCE_URL/api/4.0/oauth_client_apps/CLIENT_GUID" \
-H "Authorization: token ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
  "redirect_uri": "REDIRECT_URI",
  "display_name": "CLIENT_NAME",
  "description": "OAuth client to access MCP server using CLIENT_NAME",
  "enabled": true
}'

כדי לרשום את התוסף, פועלים לפי השלבים הבאים:

  1. פועלים לפי ההוראות במסמכי התיעוד בנושא רישום אפליקציית לקוח OAuth כדי לרשום את התוסף.

  2. כדי למלא את השדה client_guid:

    • אפשר להשתמש בכל מזהה ייחודי גלובלי.
    • צריך להיות מוכנים להפיץ את המזהה לכל מפתחי LookML שרוצים להשתמש בתוסף.

  3. בשביל redirect_uri, משתמשים ב:

    vscode://google.vscode-looker-official/oauth_callback

  4. משלימים את השלבים display_name ו-description כמו שמתואר במסמך הרשמה של אפליקציית לקוח OAuth.

אחרי שהאפליקציה נרשמת, API Explorer מחזיר תגובה עם סיכום של הרישום. אתם יכולים להשתמש בנקודת הקצה Get OAuth Client App עם client_guid כדי לבדוק את פרטי הרישום.

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

התקנת התוסף

כדי להתקין את התוסף:

  1. מתקינים את התוסף של Looker ל-VS Code מ-Visual Studio Marketplace.
  2. פותחים את סביבת הפיתוח המשולבת (IDE), כמו VS Code או Cursor.
  3. לוחצים על סמל התוספים בסרגל הפעילות.
  4. מחפשים את התוסף של Looker ל-VS Code ולוחצים על Install (התקנה).
  5. אחרי שההרחבה מותקנת, הסמל Looker מופיע בסרגל הפעילות.

הגדרת התוסף

צריך להגדיר את התוסף עם פרטי מופע Looker בקובץ settings.json של סביבת העבודה.

  1. פותחים את סביבת העבודה ואז את לוח הפקודות (Command-Shift-P ב-Mac או Ctrl+Shift+P ב-Windows/Linux).
  2. מחפשים את האפשרות העדפות: פתיחת הגדרות סביבת העבודה (JSON) ובוחרים בה.
  3. מוסיפים את משתני ההגדרה להגדרות. משתני ההגדרה משתנים בהתאם לשיטת האימות – OAuth או פרטי כניסה ל-API.

תהליך האימות המומלץ הוא OAuth 2.1. מדביקים את ההגדרות האלה בקובץ settings.json של סביבת העבודה.

{
  "looker.instanceUrl": "https://YOUR_INSTANCE_URL",
  "looker.oauthClientId": "YOUR_OAUTH_CLIENT_ID",
  "looker.projectId": "YOUR_PROJECT_ID"
}

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

  • ‫https://YOUR_INSTANCE_URL: כתובת ה-URL של מופע Looker.
  • ‫YOUR_OAUTH_CLIENT_ID: מזהה הלקוח ב-OAuth ‏ (client_guid) שקיבלתם מאדמין Looker.
  • ‫YOUR_PROJECT_ID: שם הפרויקט שרוצים לערוך. כדי למצוא אותו, פותחים את הדף LookML Projects במופע Looker. מזהה הפרויקט מופיע בעמודה Project.

אימות באמצעות פרטי כניסה ל-API

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

{
  "looker.instanceUrl": "https://YOUR_INSTANCE_URL",
  "looker.clientId": "YOUR_CLIENT_ID",
  "looker.clientSecret": "YOUR_CLIENT_SECRET",
  "looker.projectId": "YOUR_PROJECT_ID"
}

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

  • ‫https://YOUR_INSTANCE_URL: כתובת ה-URL של מופע Looker.
  • ‫YOUR_CLIENT_ID ו-YOUR_CLIENT_SECRET: מזהה הלקוח וסוד הלקוח של פרטי הכניסה ל-API שבהם אתם משתמשים לאימות. כדי למצוא את פרטי הכניסה האלה, פותחים את דף החשבון במופע Looker, ואז בקטע מפתחות API לוחצים על הלחצן ניהול. ייפתח הדף API Keys שבו אפשר לראות את מזהי הלקוחות והסודות שלכם.
  • ‫YOUR_PROJECT_ID: שם הפרויקט שרוצים לערוך. כדי למצוא את שם הפרויקט, פותחים את הדף LookML Projects במופע Looker. מזהה הפרויקט מופיע בעמודה Project.

הגדרות

אפשר להגדיר את ההגדרות הבאות של MCP בסביבת העבודה של ה-IDE.

הגדרה תיאור ברירת מחדל
looker.instanceURL כתובת ה-URL הבסיסית של המופע ב-Looker (לדוגמה, https://mycompany.looker.com). -
looker.authURL כתובת ה-URL שמשמשת לאימות OAuth. ההגדרה הזו רלוונטית רק אם היא שונה מכתובת ה-URL של המופע. looker.instanceURL
looker.sdkURL כתובת ה-URL שמשמשת לבקשות API. הגדרה שנדרשת רק אם היא שונה מכתובת ה-URL של המופע. looker.instanceURL
looker.oauthClientId מזהה לקוח ב-OAuth של Looker. נדרש עבור OAuth. -
looker.clientId מזהה הלקוח ב-Looker API. נדרש לאימות מפתח API. -
looker.clientSecret ‫Looker API Client Secret. נדרש לאימות מפתח API. -
looker.projectId מזהה הפרויקט ב-Looker. -
looker.mcpServerUrl כתובת ה-URL של שרת ה-MCP החיצוני ל-proxy (לדוגמה, http://localhost:5000/mcp). -
looker.acceptSelfSignedCertificates התעלמות משגיאות באישור SSL (לדוגמה, באישורים בחתימה עצמית). אזהרה: לא מומלץ להפעיל את האפשרות הזו. false
looker.askBeforeOverwritingRemote לשאול תמיד לפני החלפת קבצים מרוחקים כשיש התנגשות. false

אימות דרך Looker

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

  1. פותחים את לוח הפקודות.
  2. מריצים את הפקודה: Looker: Sign In (OAuth).
  3. מאשרים את ההנחיה לפתוח את הדפדפן.
  4. בדפדפן, מאשרים לתוסף לגשת לחשבון Looker.
  5. אחרי שתאשרו, הדפדפן יפנה אתכם בחזרה ל-IDE. אמורה להופיע הודעה עם הכיתוב התחברת בהצלחה ל-Looker!

שכפול פרויקט של LookML

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

  1. ב-VS Code, פותחים חלון חדש.
  2. פותחים את לוח הפקודות ובוחרים באפשרות Git: Clone (‏Git: שיבוט).
  3. מזינים את כתובת ה-URL של מאגר Git מרוחק (לדוגמה, מ-GitHub או מ-GitLab) ובוחרים תיקייה מקומית.
  4. פותחים את התיקייה המשוכפלת בסביבת הפיתוח המשולבת (IDE).

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

פתרון בעיות

אפשר לראות את יומני התוספים בחלונית Output של סביבת הפיתוח המשולבת (IDE). בוחרים בערוץ Looker כדי לראות את היומנים. כדי לראות יומנים מפורטים יותר, פותחים את לוח הפקודות, מריצים את הפקודה Developer: Set Log Level ובוחרים באפשרות Debug או Trace.

  • שגיאות אימות: מוודאים שהפרטים של looker.instanceUrl ושל looker.oauthClientId נכונים. צריך לוודא שמזהה ה-URI להפניה אוטומטית ב-Looker זהה בדיוק.
  • בעיות בסנכרון: כדאי לבדוק את יומני הרישום של התוסף כדי לפתור בעיות בסנכרון. כדי להציג את היומנים, פותחים את החלונית Output ובוחרים באפשרות Looker מהתפריט הנפתח.
  • תגובה של בקשה שגויה במהלך OAuth: מוודאים שאפשר לגשת למופע Looker מהרשת המקומית ושיש חיבור אינטרנט תקין.

אם נתקלים בבעיות בתוסף, אפשר להריץ את הפקודה Developer: Reload Window מלוח הפקודות כדי לפתור אותן.

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