Premiers pas avec l'extension Looker pour VS Code

L'extension Looker pour VS Code vous permet de développer LookML directement dans votre environnement de bureau local. Il offre une mise en surbrillance de la syntaxe riche, une synchronisation bidirectionnelle des fichiers avec votre instance Looker et une intégration avec les agents de codage IA pour le "codage d'ambiance".

L'extension est conçue à l'aide du framework Visual Studio Code (VS Code). Elle est compatible avec les IDE basés sur VS Code, tels que les IDE et outils de programmation suivants :

Claude Code
Codex
Cursor
Kiro
VS Code
Windsurf
Zed

Les IDE qui ne sont pas des forks de VS Code, tels qu'IntelliJ et Eclipse, ne sont pas compatibles avec l'extension Looker pour VS Code.

Ce guide explique comment configurer l'extension et s'authentifier.

Workflow optimisé par l'IA

L'extension Looker pour VS Code fait partie d'un workflow de développement agentique basé sur l'IA pour modifier et créer des fichiers LookML. Pour activer ce workflow, configurez les outils suivants :

L'extension Looker pour VS Code.
Un IDE local basé sur VS Code. L'IDE doit contenir un agent d'IA intégré (par exemple, Cursor). Si l'IDE ne contient pas d'agent d'IA intégré (comme VS Code de base), il doit être intégré à un outil agentique autonome (comme Gemini CLI ou Claude Code). Consultez la documentation de votre IDE local pour savoir comment le connecter à un agent.
Un serveur MCP, tel que MCP Toolbox for Databases.

Pour en savoir plus sur le workflow optimisé par l'IA, consultez la page de documentation Développement assisté par l'IA (codage Vibe) avec Looker.

Avant de commencer

Avant d'installer l'extension, vous devez remplir les conditions suivantes :

Se connecter aux outils d'IA : si vous prévoyez d'utiliser le développement assisté par l'IA, connectez votre IDE et votre agent d'IA à MCP Toolbox for Databases. Par exemple, un exemple de configuration pour connecter MCP Toolbox à Gemini CLI est disponible dans la documentation Utiliser Looker avec MCP, Gemini CLI et d'autres agents. Pour en savoir plus, consultez la documentation de vos outils.
Autorisations Looker : vous devez disposer de l'autorisation Looker develop pour tous les modèles que vous souhaitez modifier.
Instance Looker : votre instance doit exécuter Looker 26.6 ou version ultérieure.
Installation de Git : vous devez avoir installé Git sur votre machine locale pour cloner et gérer votre dépôt LookML.
Configuration du projet : votre projet LookML doit être configuré pour Git.
ID client OAuth : si vous utilisez l'authentification OAuth (recommandée), vous devez obtenir un ID client OAuth auprès de votre administrateur Looker.

Configuration par l'administrateur

Si votre organisation utilise OAuth pour l'authentification, un administrateur Looker doit enregistrer l'extension Looker pour VS Code en tant que client OAuth dans l'interface utilisateur d'administration Looker.

Utilisez l'explorateur d'API Looker pour configurer l'intégration OAuth. Vous pouvez accéder à l'explorateur d'API à l'aide de l'une des méthodes suivantes :

Si l'explorateur d'API est déjà installé sur votre instance Looker, vous pouvez y accéder avec ce format d'URL :
```
https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/
```
Si votre instance Looker ne dispose pas de l'explorateur d'API, vous pouvez l'installer depuis Looker Marketplace. Pour en savoir plus, consultez la page Utiliser l'API Explorer.

Pour enregistrer l'extension, procédez comme suit :

Suivez les instructions de la documentation Enregistrer une application cliente OAuth pour enregistrer l'extension.
Pour le champ client_guid, procédez comme suit :
- Utilisez n'importe quel ID unique au niveau mondial.
- Préparez-vous à distribuer l'ID à tous les développeurs LookML qui souhaitent utiliser l'extension.

Pour redirect_uri, utilisez :

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

Renseignez display_name et description comme décrit dans la documentation Enregistrer une application cliente OAuth.

Une fois l'application enregistrée, l'API Explorer renvoie une réponse avec un récapitulatif de l'enregistrement. Vous pouvez utiliser le point de terminaison Get OAuth Client App avec client_guid pour consulter les détails de votre enregistrement.

Fournissez le client_guid généré à vos développeurs. Ils l'utiliseront lors de la configuration de l'extension.

Installer l'extension

Pour installer l'extension, procédez comme suit :

Installez l'extension Looker pour VS Code depuis le Visual Studio Marketplace.
Ouvrez votre IDE, tel que VS Code ou Cursor.
Cliquez sur l'icône Extensions dans la barre d'activité.
Recherchez l'extension Looker pour VS Code, puis cliquez sur Installer.
Une fois l'extension installée, l'icône Looker s'affiche dans la barre d'activité.

Configurer l'extension

Vous devez configurer l'extension avec les détails de votre instance Looker dans le fichier settings.json de votre espace de travail.

Ouvrez un espace de travail, puis la palette de commandes (Cmd+Maj+P sur Mac ou Ctrl+Maj+P sur Windows/Linux).
Recherchez et sélectionnez Préférences : Ouvrir les paramètres de l'espace de travail (JSON).
Ajoutez les variables de configuration à vos paramètres. Les variables de configuration varient selon que votre méthode d'authentification est OAuth ou les identifiants d'API.

S'authentifier avec OAuth (recommandé)

Le flux d'authentification OAuth 2.1 est recommandé. Collez ces paramètres dans le fichier settings.json de votre espace de travail.

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

Remplacez les éléments suivants :

https://YOUR_INSTANCE_URL : URL de votre instance Looker.
YOUR_OAUTH_CLIENT_ID : ID client OAuth (client_guid) que vous recevez de votre administrateur Looker.
YOUR_PROJECT_ID : nom du projet que vous souhaitez modifier. Pour le trouver, ouvrez la page Projets LookML dans votre instance Looker. L'ID du projet se trouve dans la colonne Projet.

S'authentifier avec des identifiants API

Si vous préférez utiliser des clés API Looker, suivez la documentation pour créer des identifiants API. Vous devez également fournir l'ID de votre projet.

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

Remplacez les éléments suivants :

https://YOUR_INSTANCE_URL : URL de votre instance Looker.
YOUR_CLIENT_ID et YOUR_CLIENT_SECRET : ID client et code secret du client pour les identifiants API que vous utilisez pour l'authentification. Pour trouver ces identifiants, ouvrez la page Compte dans votre instance Looker, puis cliquez sur le bouton Gérer dans la section Clés API. La page Clés API s'ouvre, sur laquelle vous pouvez afficher vos ID client et vos codes secrets.
YOUR_PROJECT_ID : nom du projet que vous souhaitez modifier. Pour trouver le nom du projet, ouvrez la page Projets LookML dans votre instance Looker. L'ID du projet se trouve dans la colonne Projet.

Paramètres

Vous pouvez configurer les paramètres MCP suivants dans votre espace de travail IDE.

Paramètre	Description	Par défaut
`looker.instanceURL`	URL de base de l'instance Looker (par exemple, `https://mycompany.looker.com`).	-
`looker.authURL`	URL à utiliser pour l'authentification OAuth. Ne définissez cette valeur que si elle est différente de l'URL de votre instance.	`looker.instanceURL`
`looker.sdkURL`	URL à utiliser pour les requêtes d'API. Ne définissez cette valeur que si elle est différente de l'URL de votre instance.	`looker.instanceURL`
`looker.oauthClientId`	ID client OAuth Looker. Obligatoire pour OAuth.	-
`looker.clientId`	ID client de l'API Looker. Obligatoire pour l'authentification par clé API.	-
`looker.clientSecret`	Code secret du client de l'API Looker. Obligatoire pour l'authentification par clé API.	-
`looker.projectId`	ID du projet Looker.	-
`looker.mcpServerUrl`	URL du serveur MCP externe à proxyser (par exemple, `http://localhost:5000/mcp`).	-
`looker.acceptSelfSignedCertificates`	Ignorer les erreurs de certificat SSL (par exemple, pour les certificats auto-signés). Avertissement : Nous vous déconseillons d'activer cette option.	`false`
`looker.askBeforeOverwritingRemote`	Demander toujours avant d'écraser les fichiers distants en cas de conflit	`false`

S'authentifier via Looker

Si vous utilisez l'authentification OAuth, vous devez vous connecter pour associer votre IDE local à votre compte Looker.

Ouvrez la palette de commandes.
Exécutez la commande Looker: Sign In (OAuth).
Confirmez l'invite pour ouvrir votre navigateur.
Dans le navigateur, autorisez l'extension à accéder à votre compte Looker.
Une fois l'autorisation accordée, le navigateur vous redirige vers votre IDE. La notification Connexion à Looker réussie ! devrait s'afficher.

Cloner votre projet LookML

Pour commencer le développement, vous devez cloner votre dépôt LookML sur votre machine locale.

Dans VS Code, ouvrez une nouvelle fenêtre.
Ouvrez la palette de commandes et sélectionnez Git : Cloner.
Saisissez l'URL de votre dépôt Git distant (par exemple, depuis GitHub ou GitLab) et choisissez un dossier local.
Ouvrez le dossier cloné dans votre IDE.

L'extension détecte automatiquement les fichiers LookML et commence à se synchroniser avec la branche extraite dans le mode Développement de votre instance Looker.

Dépannage

Vous pouvez afficher les journaux d'extension dans le panneau Output (Sortie) de votre IDE. Sélectionnez le canal Looker pour afficher les journaux. Pour obtenir des journaux plus détaillés, ouvrez la palette de commandes, exécutez la commande Développeur : Définir le niveau de journalisation, puis sélectionnez Déboguer ou Tracer.

Erreurs d'authentification : vérifiez que vos looker.instanceUrl et looker.oauthClientId sont corrects. Assurez-vous que l'URI de redirection dans Looker correspond exactement.
Problèmes de synchronisation : consultez les journaux d'extension pour résoudre les problèmes de synchronisation. Pour afficher les journaux, ouvrez le panneau Output (Sortie) et sélectionnez Looker dans le menu déroulant.
Réponse "Bad Request" (Requête incorrecte) lors de l'authentification OAuth : assurez-vous que votre instance Looker est accessible depuis votre réseau local et que vous disposez d'une connexion Internet valide.

Si vous rencontrez des problèmes avec l'extension, l'exécution de la commande Developer: Reload Window (Développeur : Recharger la fenêtre) à partir de la palette de commandes peut vous aider à les résoudre.