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. Sie bietet eine umfassende Syntaxhervorhebung, bidirektionale Dateisynchronisierung mit Ihrer Looker-Instanz und Integration mit KI-Codierungsagenten für „Vibe Coding“.

Die Erweiterung wird mit dem Visual Studio Code-Framework (VS Code) erstellt und unterstützt 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 dieser Anleitung wird beschrieben, wie Sie die Erweiterung einrichten und authentifizieren.

KI-basierter Workflow

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

Die Looker-Erweiterung für VS Code.
Eine lokale IDE , die auf VS Code basiert. Die IDE muss entweder einen integrierten KI-Agenten enthalten (z. B. Cursor) oder, wenn die IDE keinen integrierten KI-Agenten enthält (z. B. VS Code), muss die IDE in ein eigenständiges agentenbasiertes Tool (z. B. 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 for Databases.

Weitere Informationen zum KI-basierten Workflow finden Sie auf der Dokumentationsseite KI-basierte Entwicklung (Vibe Coding) mit Looker.

Hinweis

Bevor Sie die Erweiterung installieren, müssen Sie die folgenden Anforderungen erfüllen:

Mit KI-Tools verbinden: Wenn Sie die KI-basierte Entwicklung verwenden möchten, verbinden Sie Ihre IDE und Ihren KI-Agenten mit der MCP Toolbox for Databases. Ein Beispiel für eine Konfiguration zum Verbinden der MCP Toolbox mit der Gemini CLI finden Sie in der Dokumentation Looker mit MCP, Gemini CLI und anderen Agenten verwenden. Weitere Informationen finden Sie in der Dokumentation Ihrer Tools.
Looker-Berechtigungen: Sie benötigen die develop Looker-Berechtigung 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: Git muss auf Ihrem lokalen Computer installiert sein, 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 von Ihrem Looker-Administrator eine OAuth-Client-ID erhalten.

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-Admin-UI registrieren.

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

Wenn der API Explorer bereits in Ihrer Looker-Instanz installiert ist, können Sie mit diesem URL-Format darauf zugreifen:
```
https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/
```
Wenn der API Explorer nicht in Ihrer Looker-Instanz installiert ist, können Sie ihn im 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 OAuth-Clientanwendung registrieren, um die Erweiterung zu registrieren.
Führen Sie für das Feld client_guid die folgenden Schritte aus:
- Verwenden Sie eine global eindeutige ID.
- Halten Sie die ID bereit, um sie an alle LookML-Entwickler weiterzugeben, die die Erweiterung verwenden möchten.

Verwenden Sie für redirect_uri:

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

Füllen Sie display_name und description wie in der Dokumentation OAuth-Clientanwendung registrieren beschrieben aus.

Nachdem die App registriert wurde, 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 die Registrierungsdetails zu prüfen.

Geben Sie die generierte client_guid an Ihre Entwickler weiter. Sie verwenden sie bei der Konfiguration der Erweiterung.

Erweiterung installieren

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

Installieren Sie die Looker-Erweiterung für VS Code aus dem 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.
Nachdem die Erweiterung installiert wurde, wird in der Aktivitätsleiste das Symbol Looker angezeigt.

Erweiterung konfigurieren

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

Öffnen Sie die Befehlspalette (Command-Shift-P unter Mac oder Strg+Shift+P unter Windows/Linux).
Suchen Sie nach Einstellungen: Arbeitsbereichseinstellungen öffnen (JSON) und wählen Sie diese Option aus.
Fügen Sie Ihrer Konfiguration die Konfigurationsvariablen hinzu. Die Konfigurationsvariablen variieren je nachdem, ob Sie die OAuth-Authentifizierung oder API-Anmeldedaten verwenden.

Mit OAuth authentifizieren (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 , um sie zu finden. Die Projekt-ID befindet sich in der Spalte Projekt.

Mit API-Anmeldedaten authentifizieren

Wenn Sie Looker API-Schlüssel verwenden möchten, folgen Sie der Dokumentation, um API-Anmeldedaten zu erstellen. 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. Öffnen Sie in Ihrer Looker-Instanz die Seite Konto , um diese Anmeldedaten zu finden. Klicken Sie dann im Bereich API-Schlüssel auf die Schaltfläche Verwalten. Dadurch wird die Seite API-Schlüssel geöffnet, auf der Sie Ihre Client-IDs und -schlüssel sehen können.
YOUR_PROJECT_ID: der Name des Projekts, das Sie bearbeiten möchten. Öffnen Sie in Ihrer Looker-Instanz die LookML-Projekte-Seite , um den Projektnamen zu finden. Die Projekt-ID befindet sich in der Spalte Projekt.

Einstellungen

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

Einstellung	Beschreibung	Standard
`looker.instanceURL`	Basis-URL der Looker-Instanz (z. B. `https://mycompany.looker.com`).	-
`looker.authURL`	URL für die OAuth-Authentifizierung. Nur festlegen, wenn sie sich von der Instanz-URL unterscheidet.	`looker.instanceURL`
`looker.sdkURL`	URL für API-Anfragen. Nur festlegen, 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. Für die Authentifizierung mit API-Schlüssel erforderlich.	-
`looker.clientSecret`	Looker API-Clientschlüssel. Für die Authentifizierung mit API-Schlüssel erforderlich.	-
`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. für selbst signierte Zertifikate). Warnung: Es wird nicht empfohlen, diese Option zu aktivieren.	`false`
`looker.askBeforeOverwritingRemote`	Immer fragen, 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: Anmelden (OAuth) aus.
Bestätigen Sie die Aufforderung, Ihren Browser zu öffnen.
Autorisieren Sie die Erweiterung im Browser, auf Ihr Looker-Konto zuzugreifen.
Nach der Autorisierung werden Sie im Browser wieder zu Ihrer IDE weitergeleitet. Sie sollten die Benachrichtigung Erfolgreich bei 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: Klonen 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 Ihrem ausgecheckten Branch im Entwicklermodus Ihrer Looker-Instanz.

Fehlerbehebung

Sie können die Erweiterungsprotokolle im Bereich Ausgabe Ihrer IDE ansehen. Wählen Sie den Kanal Looker aus, um Protokolle anzusehen. Öffnen Sie die Befehlspalette, führen Sie den Befehl Entwickler: Protokollebene festlegen aus und wählen Sie Debug oder Trace aus, um detailliertere Protokolle zu erhalten.

Authentifizierungsfehler: Prüfen Sie, ob looker.instanceUrl und looker.oauthClientId korrekt sind. Achten Sie darauf, dass die Umleitungs-URI in Looker genau übereinstimmt.
Synchronisierungsprobleme: Prüfen Sie die Erweiterungsprotokolle, um Synchronisierungsprobleme zu beheben. Öffnen Sie den Bereich Ausgabe und wählen Sie im Drop-down-Menü Looker aus, um Protokolle anzusehen.
Antwort „Bad Request“ während OAuth: Achten Sie darauf, dass Ihre Looker-Instanz über Ihr lokales Netzwerk zugänglich ist und dass Sie eine gültige Internetverbindung haben.

Wenn Probleme mit der Erweiterung auftreten, kann es helfen, den Befehl Entwickler: Fenster neu laden über die Befehlspalette auszuführen.