Erste Schritte mit der Looker-Erweiterung für VS Code

Mit der Looker-Erweiterung für VS Code können Sie LookML direkt in Ihrer lokalen Desktopumgebung entwickeln. Die IDE bietet eine umfassende Syntaxhervorhebung, bidirektionale Dateisynchronisierung mit Ihrer Looker-Instanz und Integration mit KI-Coding-Agents für „Vibe-Coding“.

Die Erweiterung basiert auf dem Visual Studio Code-Framework (VS Code) und unterstützt integrierte Entwicklungsumgebungen (IDEs), die auf der VS Code-IDE basieren, z. B. die folgenden IDEs und Codierungstools:

Claude Code
Codex
Cursor
Kiro
VS Code
Windsurf
Zed

IDEs, die keine Forks von VS Code sind, z. B. IntelliJ und Eclipse, werden von der Looker-Erweiterung für VS Code nicht unterstützt.

In diesem Leitfaden wird beschrieben, wie Sie die Erweiterung einrichten und authentifizieren.

KI-gestützter Workflow

Die Looker-Erweiterung für VS Code ist Teil eines KI-basierten agentischen Entwicklungsworkflows zum Bearbeiten und Erstellen von LookML-Dateien. Um diesen Workflow zu aktivieren, müssen Sie die folgenden Tools konfigurieren:

Die Looker-Erweiterung für VS Code.
Eine lokale IDE, die auf VS Code basiert. Die IDE muss entweder einen integrierten KI-Agenten (z. B. Cursor) enthalten oder, wenn die IDE keinen integrierten KI-Agenten enthält (z. B. die Basisversion von VS Code), muss die IDE in ein eigenständiges agentenbasiertes Tool (z. B. die Gemini CLI oder Claude Code) eingebunden sein. Informationen zum Verbinden Ihrer IDE mit einem Agenten finden Sie in der Dokumentation Ihrer lokalen IDE.
Ein MCP-Server, z. B. die MCP Toolbox für Datenbanken.

Weitere Informationen zum KI-basierten Workflow finden Sie auf der Dokumentationsseite KI-gestützte Entwicklung (Vibe-Codierung) mit Looker.

Hinweis

Bevor Sie die Erweiterung installieren, müssen die folgenden Voraussetzungen erfüllt sein:

Verbindung zu KI-Tools herstellen: Wenn Sie KI-Unterstützung bei der Entwicklung nutzen möchten, verbinden Sie Ihre IDE und Ihren KI-Agenten mit der MCP Toolbox for Databases. Ein Beispiel für die Konfiguration zum Verbinden der MCP-Toolbox mit der Gemini CLI finden Sie in der Dokumentation Looker mit MCP, Gemini CLI und anderen Agents verwenden. Weitere Informationen finden Sie in der Dokumentation Ihrer Tools.
Looker-Berechtigungen: Sie benötigen die Looker-Berechtigung develop für alle Modelle, die Sie bearbeiten möchten.
Looker-Instanz: Auf Ihrer Instanz muss Looker 26.6 oder höher ausgeführt werden.
Git-Installation: Sie müssen Git auf Ihrem lokalen Computer installiert haben, um Ihr LookML-Repository zu klonen und zu verwalten.
Projektkonfiguration: Ihr LookML-Projekt muss für Git konfiguriert sein.
OAuth-Client-ID: Wenn Sie die OAuth-Authentifizierung verwenden (empfohlen), müssen Sie eine OAuth-Client-ID von Ihrem Looker-Administrator anfordern.

Einrichtung durch Administrator

Wenn Ihre Organisation OAuth zur Authentifizierung verwendet, muss ein Looker-Administrator die Looker-Erweiterung für VS Code als OAuth-Client in der Looker-Administratoroberfläche registrieren.

Verwenden Sie den API Explorer von Looker, um die OAuth-Integration einzurichten. Sie haben folgende Möglichkeiten, auf den API Explorer zuzugreifen:

Wenn der API Explorer bereits auf Ihrer Looker-Instanz installiert ist, können Sie über dieses URL-Format darauf zugreifen:
```
https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/
```
Wenn Ihre Looker-Instanz den API Explorer nicht enthält, können Sie ihn über den Looker Marketplace installieren. Weitere Informationen finden Sie auf der Seite API Explorer verwenden.

Führen Sie die folgenden Schritte aus, um die Erweiterung zu registrieren:

Folgen Sie der Anleitung in der Dokumentation unter OAuth-Clientanwendung registrieren, um die Erweiterung zu registrieren.
Führen Sie für das Feld client_guid die folgenden Schritte aus:
- Verwenden Sie eine beliebige global eindeutige ID.
- Geben Sie die ID an alle LookML-Entwickler weiter, die die Erweiterung verwenden möchten.

Verwenden Sie für die redirect_uri Folgendes:

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

Führen Sie die Schritte display_name und description aus, wie in der Dokumentation OAuth-Clientanwendung registrieren beschrieben.

Nach der Registrierung der App gibt der API Explorer eine Antwort mit einer Zusammenfassung der Registrierung zurück. Sie können den Endpunkt Get OAuth Client App mit der client_guid verwenden, um Ihre Registrierungsdetails zu prüfen.

Stellen Sie das generierte client_guid Ihren Entwicklern zur Verfügung. Sie verwenden es bei der Konfiguration der Erweiterung.

Erweiterung installieren

So installieren Sie die Erweiterung:

Installieren Sie die Looker-Erweiterung für VS Code über den Visual Studio Marketplace.
Öffnen Sie Ihre IDE, z. B. VS Code oder Cursor.
Klicken Sie in der Aktivitätsleiste auf das Symbol Erweiterungen.
Suchen Sie nach der Looker-Erweiterung für VS Code und klicken Sie auf Installieren.
Nach der Installation der Erweiterung wird das -Symbol für Looker in der Aktivitätsleiste angezeigt.

Erweiterung konfigurieren

Sie müssen die Erweiterung mit den Details Ihrer Looker-Instanz in der Datei settings.json Ihres Arbeitsbereichs konfigurieren.

Öffnen Sie bei geöffnetem Arbeitsbereich die Befehlspalette (Befehlstaste + Umschalt + P auf dem Mac oder Strg + Umschalt + P unter Windows/Linux).
Suchen Sie nach Einstellungen: Arbeitsbereichseinstellungen öffnen (JSON) und wählen Sie die Option aus.
Fügen Sie die Konfigurationsvariablen Ihren Einstellungen hinzu. Die Konfigurationsvariablen variieren je nachdem, ob Sie OAuth oder API-Anmeldedaten als Authentifizierungsmethode verwenden.

Authentifizierung mit OAuth (empfohlen)

OAuth 2.1 ist der empfohlene Authentifizierungsablauf. Fügen Sie diese Einstellungen in die Datei settings.json Ihres Arbeitsbereichs ein.

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

Ersetzen Sie Folgendes:

https://YOUR_INSTANCE_URL: Die URL Ihrer Looker-Instanz.
YOUR_OAUTH_CLIENT_ID: Die OAuth-Client-ID (client_guid), die Sie von Ihrem Looker-Administrator erhalten.
YOUR_PROJECT_ID: Der Name des Projekts, das Sie bearbeiten möchten. Öffnen Sie in Ihrer Looker-Instanz die Seite LookML-Projekte. Die Projekt-ID finden Sie in der Spalte Projekt.

Mit API-Anmeldedaten authentifizieren

Wenn Sie lieber Looker API-Schlüssel verwenden möchten, folgen Sie der Dokumentation zum Erstellen von API-Anmeldedaten. Sie müssen auch Ihre Projekt-ID angeben.

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

Ersetzen Sie Folgendes:

https://YOUR_INSTANCE_URL: Die URL Ihrer Looker-Instanz.
YOUR_CLIENT_ID und YOUR_CLIENT_SECRET: Die Client-ID und der Clientschlüssel für die API-Anmeldedaten, die Sie zur Authentifizierung verwenden. Um diese Anmeldedaten zu finden, öffnen Sie in Ihrer Looker-Instanz die Seite Konto und klicken Sie dann im Bereich API-Schlüssel auf die Schaltfläche Verwalten. Daraufhin wird die Seite API-Schlüssel geöffnet, auf der Sie Ihre Client-IDs und Secrets sehen können.
YOUR_PROJECT_ID: Der Name des Projekts, das Sie bearbeiten möchten. Um den Projektnamen zu finden, öffnen Sie in Ihrer Looker-Instanz die Seite LookML-Projekte. Die Projekt-ID finden Sie in der Spalte Projekt.

Einstellungen

Sie können die folgenden MCP-Einstellungen in Ihrem IDE-Arbeitsbereich konfigurieren.

Einstellung	Beschreibung	Standard
`looker.instanceURL`	Die Basis-URL der Looker-Instanz, z. B. `https://mycompany.looker.com`.	-
`looker.authURL`	URL für die OAuth-Authentifizierung. Wird nur festgelegt, wenn sie sich von der Instanz-URL unterscheidet.	`looker.instanceURL`
`looker.sdkURL`	URL für API-Anfragen. Wird nur festgelegt, wenn sie sich von der Instanz-URL unterscheidet.	`looker.instanceURL`
`looker.oauthClientId`	Looker-OAuth-Client-ID. Für OAuth erforderlich.	-
`looker.clientId`	Looker API-Client-ID. Erforderlich für die API-Schlüssel-Authentifizierung.	-
`looker.clientSecret`	Looker API-Clientschlüssel. Erforderlich für die API-Schlüssel-Authentifizierung.	-
`looker.projectId`	Looker-Projekt-ID.	-
`looker.mcpServerUrl`	URL des externen MCP-Servers, der als Proxy verwendet werden soll (z. B. `http://localhost:5000/mcp`).	-
`looker.acceptSelfSignedCertificates`	SSL-Zertifikatfehler ignorieren (z. B. bei selbstsignierten Zertifikaten). Achtung: Das Aktivieren dieser Option wird nicht empfohlen.	`false`
`looker.askBeforeOverwritingRemote`	Immer nachfragen, bevor Remote-Dateien überschrieben werden, wenn ein Konflikt erkannt wird.	`false`

Über Looker authentifizieren

Wenn Sie die OAuth-Authentifizierung verwenden, müssen Sie sich anmelden, um Ihre lokale IDE mit Ihrem Looker-Konto zu verknüpfen.

Öffnen Sie die Befehlspalette.
Führen Sie den Befehl Looker: Sign In (OAuth) aus.
Bestätigen Sie die Aufforderung, um den Browser zu öffnen.
Autorisieren Sie im Browser die Erweiterung für den Zugriff auf Ihr Looker-Konto.
Nach der Autorisierung werden Sie im Browser zurück zu Ihrer IDE weitergeleitet. Sie sollten eine Benachrichtigung mit dem Text Successfully signed in to Looker! (Erfolgreich in Looker angemeldet) sehen.

LookML-Projekt klonen

Um mit der Entwicklung zu beginnen, müssen Sie Ihr LookML-Repository auf Ihren lokalen Computer klonen.

Öffnen Sie in VS Code ein neues Fenster.
Öffnen Sie die Befehlspalette und wählen Sie Git: Clone aus.
Geben Sie die URL Ihres Remote-Git-Repositorys ein (z. B. von GitHub oder GitLab) und wählen Sie einen lokalen Ordner aus.
Öffnen Sie den geklonten Ordner in Ihrer IDE.

Die Erweiterung erkennt die LookML-Dateien automatisch und beginnt mit der Synchronisierung mit dem ausgecheckten Branch im Entwicklermodus Ihrer Looker-Instanz.

Fehlerbehebung

Sie können die Erweiterungslogs im Bereich Output Ihrer IDE aufrufen. Wählen Sie den Looker-Channel aus, um Logs aufzurufen. Wenn Sie detailliertere Logs benötigen, öffnen Sie die Befehlspalette, führen Sie den Befehl Entwickler: Log-Ebene festlegen aus und wählen Sie Debuggen oder Trace aus.

Authentifizierungsfehler: Prüfen Sie, ob looker.instanceUrl und looker.oauthClientId korrekt sind. Die Weiterleitungs-URI in Looker muss genau übereinstimmen.
Synchronisierungsprobleme: Prüfen Sie die Erweiterungsprotokolle, um Synchronisierungsprobleme zu beheben. Wenn Sie Logs aufrufen möchten, öffnen Sie den Bereich Output (Ausgabe) und wählen Sie im Drop-down-Menü Looker aus.
„Bad Request“-Antwort während OAuth: Prüfen Sie, ob Ihre Looker-Instanz über Ihr lokales Netzwerk erreichbar ist und ob Sie eine gültige Internetverbindung haben.

Wenn Probleme mit der Erweiterung auftreten, kann es helfen, den Befehl Developer: Reload Window über die Befehlspalette auszuführen.