תחילת העבודה עם תוסף 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) שמשתמש בגישה לשירותים פרטיים, אי אפשר להשתמש ב-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, מזינים את כתובת ה-URL לקריאה חוזרת (callback) של סביבת הפיתוח המשולבת (IDE). בהתאם ל-IDE או לכלי הקידוד שלכם, משתמשים באחת מכתובות ה-URL הבאות של הקריאה החוזרת:

    IDE או כלי כתובת אתר להתקשרות חוזרת
    VS Code 
    vscode://google.vscode-looker-official/oauth_callback
    Antigravity 
    antigravity://google.vscode-looker-official/oauth_callback
    Code-OSS 
    code-oss://google.vscode-looker-official/oauth_callback
    סמן 
    cursor://google.vscode-looker-official/oauth_callback
    HTTPS 
    https://google.vscode-looker-official/oauth_callback
    Looker 
    looker://google.vscode-looker-official/oauth_callback
    גלישת רוח 
    windsurf://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 של סביבת העבודה, בכלי העריכה החזותי של ההגדרות ב-VS Code (העדפות: פתיחת הגדרות סביבת העבודה) או בממשק המשתמש האינטראקטיבי להצטרפות של תוסף Looker.

השלבים הבאים מראים איך לערוך את הקובץ settings.json כדוגמה. אם במקום זאת משתמשים בכלי לעריכת ההגדרות של VS Code או בממשק המשתמש של התוסף Looker, מקבלים את אותה התוצאה.

  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

הגדרת לקוח MCP

כדי לאפשר לסוכן ה-AI שלכם ליצור אינטראקציה עם Looker באמצעות התוסף, עליכם להגדיר את הסוכן להתחבר לכתובת ה-URL של שרת ה-proxy של ה-MCP של התוסף. כברירת מחדל, ה-proxy פועל באופן מקומי בכתובת http://127.0.0.1:5050.

אם שרת ה-MCP פועל ביציאה אחרת מ-5000 או במכונה מרוחקת, צריך לעדכן את הגדרות ה-proxy של התוסף. כדי לעשות את זה, צריך לעדכן את ההגדרה looker.mcpServerUrl בהגדרות של סביבת העבודה ב-VS Code. מידע נוסף זמין בקטע הגדרות.

קוד Visual Studio ‏ (Copilot)

  1. פותחים את VS Code ויוצרים את הספרייה .vscode בתיקיית הבסיס של הפרויקט, אם היא עדיין לא קיימת.
  2. יוצרים את הקובץ .vscode/mcp.json, אם הוא עדיין לא קיים, ופותחים אותו.
  3. מוסיפים את ההגדרה הבאה ושומרים את הקובץ: 
      {
        "servers": {
          "looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050"
          }
        }
      }

Claude Code

  1. יוצרים את הקובץ .mcp.json בתיקיית הבסיס של הפרויקט, אם הוא עדיין לא קיים.
  2. מוסיפים את ההגדרה הבאה ושומרים את הקובץ: 
      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050"
          }
        }
      }

סמן

  1. יוצרים את הספרייה .cursor בתיקיית הבסיס של הפרויקט, אם היא עדיין לא קיימת.
  2. יוצרים את הקובץ .cursor/mcp.json, אם הוא עדיין לא קיים, ופותחים אותו.
  3. מוסיפים את ההגדרה הבאה ושומרים את הקובץ: 
      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050"
          }
        }
      }
  1. פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP. כשמתבצע חיבור לשרת, מופיע סטטוס פעיל בצבע ירוק.

קלין

  1. פותחים את התוסף Cline ב-VS Code ולוחצים על הסמל MCP Servers.
  2. לוחצים על Configure MCP Servers (הגדרת שרתי MCP) כדי לפתוח את קובץ ההגדרות.
  3. מוסיפים את ההגדרה הבאה ושומרים את הקובץ: 
      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050"
          }
        }
      }

גלישת רוח

  1. פותחים את Windsurf ועוברים אל Cascade assistant.
  2. לוחצים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ ההגדרה.
  3. מוסיפים את ההגדרה הבאה ושומרים את הקובץ: 
      {
        "mcpServers": {
          "looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050"
          }
        }
      }

אימות דרך 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 זהה בדיוק.
  • בעיות בסנכרון: כדי לפתור בעיות בסנכרון, צריך לבדוק את היומנים של התוסף. כדי לראות את היומנים, פותחים את החלונית פלט ובוחרים באפשרות Looker מהתפריט הנפתח.
  • תגובה של בקשה שגויה במהלך OAuth: מוודאים שאפשר לגשת למופע Looker מהרשת המקומית ושיש חיבור אינטרנט תקין.

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

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