‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

התוסף Looker by Google Cloud ל-Visual Studio Code (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. כדי להפעיל את תהליך העבודה הזה, צריך להגדיר את הכלים הבאים:

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

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

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

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

שרת MCP בניהול Looker (אופציונלי, אבל מומלץ): אם אתם מתכננים להשתמש בפיתוח בעזרת AI, צריך לחבר את סביבת הפיתוח המשולבת (IDE) ואת סוכן ה-AI לשרת ה-MCP בניהול Looker. הוראות להגדרת שרת ה-MCP מופיעות בדף התיעוד בנושא שרת MCP בניהול Looker. פרטים נוספים מופיעים במסמכי התיעוד של הכלים.
הרשאות ב-Looker: כדי לערוך מודלים, צריכה להיות לכם הרשאת develop ב-Looker.
מופע Looker: המופע צריך להריץ Looker 26.6 ואילך.
הגדרת פרויקט: צריך שיהיה לכם פרויקט ב-Looker (שהוגדר כמאגר Git או שהוגדר ל-Git).
התקנת Git (אופציונלי): אם אתם מתכננים לשכפל את מאגר 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
}'

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

פועלים לפי ההוראות במסמכי התיעוד בנושא רישום אפליקציית לקוח OAuth כדי לרשום את התוסף.
כדי למלא את השדה client_guid:
- צריך להשתמש במזהה ייחודי גלובלי.
- צריך להיות מוכנים להפיץ את המזהה לכל מפתחי LookML שרוצים להשתמש בתוסף.

בשדה redirect_uri, מזינים את כתובת ה-URL לקריאה חוזרת (callback) של סביבת הפיתוח המשולבת (IDE). בהתאם ל-IDE או לכלי הקידוד שלכם, משתמשים באחת מכתובות ה-URL הבאות של הקריאה החוזרת:

IDE או כלי	כתובת אתר להתקשרות חוזרת
‫Antigravity IDE (זמין ב-Looker מגרסה 26.12 ואילך)	antigravity-ide://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
‫Kiro (תמיכה ב-OAuth עבור Kiro זמינה ב-Looker 26.16 ואילך)	kiro://google.vscode-looker-official/oauth_callback
Looker	looker://google.vscode-looker-official/oauth_callback
VS Code	vscode://google.vscode-looker-official/oauth_callback
גלישת רוח	windsurf://google.vscode-looker-official/oauth_callback

מוודאים שהשדה Enabled מוגדר ל-true.
ממלאים את השדות display_name ו-description כמו שמתואר במסמכי התיעוד בנושא רישום אפליקציית לקוח OAuth.

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

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

התקנת התוסף

התוסף זמין בשני מרקטפלייסים גדולים של תוספים:

‫Visual Studio Marketplace (ל-VS Code רגיל)
פותחים את VSX Registry (ב-Cursor, ב-Antigravity IDE וב-VSCodium)

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

פותחים את סביבת הפיתוח המשולבת (IDE), למשל VS Code או Cursor.
לוחצים על סמל התוספים בסרגל הפעילות.
מאתרים את Looker by Google Cloud ולוחצים על Install (התקנה).
אחרי שההרחבה מותקנת, הסמל Looker מופיע בסרגל הפעילות.

הגדרת התוסף

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

פותחים סביבת עבודה ואז פותחים את לוח הפקודות (Command-Shift-P ב-macOS או Ctrl+Shift+P ב-Windows/Linux).
מריצים את הפקודה Looker: Show Onboarding Walkthrough כדי לפתוח את ההדרכה לתחילת השימוש.
פועלים לפי ההנחיות במדריך כדי להזין את כתובת ה-URL של מופע Looker, את מזהה הפרויקט ואת פרטי האימות. אם אתם משתמשים במאגר bare, תתבקשו גם לאכלס את סביבת העבודה בקובצי LookML של הפרויקט במהלך התהליך הזה.

אימות באמצעות OAuth (מומלץ)

תהליך האימות המומלץ הוא OAuth 2.1. כשמוצגת הנחיה במהלך ההסבר המפורט על תהליך ההצטרפות, בוחרים באפשרות OAuth ומזינים את ערכי ההגדרה הבאים:

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

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

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

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

הגדרות

מומלץ להשתמש בהדרכה למשתמש, אבל אפשר גם להגדיר את הגדרות התוסף בקובץ settings.json של VS Code. הקובץ הזה נמצא בתיקייה של סביבת העבודה .vscode (.vscode/settings.json) או בקובץ ההגדרות הגלובליות של המשתמש (settings.json). אפשר גם להגדיר אותן באמצעות עורך ההגדרות החזותי של VS Code (העדפות: פתיחת ההגדרות (ממשק משתמש)).

צריך להגדיר את כל המאפיינים looker.<setting> בקובצי settings.json של VS Code, כולל הגדרת התוסף MCP looker.mcpServerUrl. הגדרת ההגדרות האלה בקובץ התצורה של MCP של סוכן AI (למשל .agents/mcp_config.json) או בקובצי הגדרות אחרים לא תפעל עם התוסף.

אפשר להגדיר את הגדרות התוספים הבאות ב-settings.json:

הגדרה	תיאור	ברירת מחדל
`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`	מזהה פרויקט LookML.	-
`looker.mcpServerUrl`	כתובת ה-URL של שרת ה-MCP היעד שאליו פרוקסי ה-MCP המקומי של התוסף מעביר בקשות. מגדירים רק אם הערך שונה מ-`looker.instanceURL/mcp` (לדוגמה, `http://localhost:5000/mcp`).	`looker.instanceURL/mcp`
`looker.acceptSelfSignedCertificates`	התעלמות משגיאות באישור SSL (לדוגמה, באישורים בחתימה עצמית). אזהרה: לא מומלץ להפעיל את האפשרות הזו.	`false`
`looker.askBeforeOverwritingRemote`	לשאול תמיד לפני החלפת קבצים מרוחקים כשיש התנגשות.	`false`

הגדרת לקוח MCP

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

סוכן ה-AI מפנה לקובץ התצורה של MCP שלו (למשל, .agents/mcp_config.json ב-VS Code, ‏ .mcp.json ב-Claude Code או .cursor/mcp.json ב-Cursor). הפניית ההגדרה הזו אל ה-proxy המקומי מאפשרת לתוסף לתעד את בקשות ה-MCP של הסוכן ולהעביר אותן עם כותרות האימות המתאימות.

שרת MCP בניהול Looker (ברירת מחדל ומומלץ)

התוסף מפעיל שרת proxy הפוך מקומי (ברירת מחדל: http://127.0.0.1:5050/mcp) שמתחבר לשרת MCP מנוהל ומוטמע ב-Looker (LOOKER_INSTANCE_URL/mcp). שרת ה-proxy מוסיף באופן אוטומטי טוקנים למוכ"ז של OAuth ומאחסן בזיכרון בקשות של כלי סוכן AI עד להשלמת סנכרון של קבצים מקומיים בהמתנה, כדי להבטיח שכלי התיקוף לעולם לא יעריכו קוד לא עדכני בשרת.

שרת MCP בהתאמה אישית או באירוח עצמי (אופציונלי)

אם הארגון שלכם מארח שרת MCP בהתאמה אישית (כמו MCP Toolbox for Databases עצמאי):

בהגדרות של VS Code, מגדירים את looker.mcpServerUrl לכתובת ה-URL המותאמת אישית של השרת (לדוגמה, http://localhost:5000/mcp).
מגדירים את לקוח ה-MCP של סביבת הפיתוח המשולבת כך שיפנה לשרת ה-Proxy של התוסף בכתובת http://127.0.0.1:5050/mcp.

קוד Visual Studio ‏ (Copilot)

פותחים את VS Code ויוצרים את הספרייה .agents בתיקיית הבסיס של הפרויקט, אם היא עדיין לא קיימת.
יוצרים את הקובץ .agents/mcp_config.json, אם הוא עדיין לא קיים, ופותחים אותו.
מוסיפים את ההגדרה הבאה ושומרים את הקובץ:

      {
        "mcpServers": {
          "Looker": {
            "serverUrl": "http://127.0.0.1:5050/mcp",
            "disabledTools": [
              "query_url",
              "get_looks",
              "run_look",
              "make_look",
              "get_dashboards",
              "run_dashboard",
              "make_dashboard",
              "add_dashboard_element",
              "add_dashboard_filter",
              "generate_embed_url",
              "health_pulse",
              "health_analyze",
              "health_vacuum",
              "get_project_files",
              "get_project_file",
              "create_project_file",
              "update_project_file",
              "delete_project_file",
              "get_project_directories",
              "create_project_directory",
              "delete_project_directory",
              "project_git_branch"
            ]
          }
        }
      }

Claude Code

יוצרים את הקובץ .mcp.json בתיקיית הבסיס של הפרויקט, אם הוא עדיין לא קיים.
מוסיפים את ההגדרה הבאה ושומרים את הקובץ:

      {
        "mcpServers": {
          "Looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050/mcp"
          }
        }
      }

סמן

יוצרים את הספרייה .cursor בתיקיית הבסיס של הפרויקט, אם היא עדיין לא קיימת.
יוצרים את הקובץ .cursor/mcp.json, אם הוא עדיין לא קיים, ופותחים אותו.
מוסיפים את ההגדרה הבאה ושומרים את הקובץ:

      {
        "mcpServers": {
          "Looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050/mcp"
          }
        }
      }

פותחים את Cursor ועוברים אל Settings > Cursor Settings > MCP. כשמתבצע חיבור לשרת, מופיע סטטוס פעיל בצבע ירוק.

קלין

פותחים את התוסף Cline ב-VS Code ולוחצים על הסמל MCP Servers.
לוחצים על Configure MCP Servers כדי לפתוח את קובץ ההגדרות.
מוסיפים את ההגדרה הבאה ושומרים את הקובץ:

      {
        "mcpServers": {
          "Looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050/mcp"
          }
        }
      }

גלישת רוח

פותחים את Windsurf ועוברים אל Cascade assistant.
לוחצים על סמל ה-MCP ואז על Configure (הגדרה) כדי לפתוח את קובץ ההגדרה.
מוסיפים את ההגדרה הבאה ושומרים את הקובץ:

      {
        "mcpServers": {
          "Looker": {
            "type": "http",
            "url": "http://127.0.0.1:5050/mcp"
          }
        }
      }

אימות דרך Looker

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

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

איכלוס פרויקט של LookML מקומי

כדי להתחיל בפיתוח, פותחים את פרויקט LookML בסביבת הפיתוח המשולבת (IDE) המקומית באמצעות השיטה המתאימה להגדרת המאגר:

מאגר Git

אם פרויקט LookML שלכם מוגדר ל-Git, פועלים לפי השלבים הבאים:

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

מצב של מאגר חשוף

אם פרויקט LookML שלכם מוגדר כמאגר חשוף, פועלים לפי השלבים הבאים:

פותחים סביבת עבודה, יוצרים תיקייה מקומית ריקה לפרויקט ופותחים אותה.
פותחים את לוח הפקודות (Command-Shift-P ב-macOS או Ctrl+Shift+P ב-Windows/Linux).
מריצים את הפקודה Looker: Show Onboarding Walkthrough כדי לפתוח את ההדרכה לתחילת השימוש.
בשלב Select Project, בוחרים את פרויקט LookML שרוצים לעבוד עליו ולוחצים על Next.
התוסף מזהה שהתיקייה המקומית ריקה ומציג בקשה לאכלס את סביבת העבודה בקבצים של הפרויקט. לוחצים על Populate Workspace (אכלוס סביבת העבודה) כדי לאכלס את סביבת העבודה.
משלימים את תהליך ההגדרה.

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

פתרון בעיות

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

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

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