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. Elle offre une mise en évidence de la syntaxe enrichie, une synchronisation bidirectionnelle des fichiers avec votre instance Looker et une intégration avec des agents de codage IA pour le "vibe coding".

L'extension est conçue à l'aide du framework Visual Studio Code (VS Code) et est compatible avec les environnements de développement intégrés (IDE) basés sur l'IDE VS Code, tels que les IDE et outils de codage 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 et authentifier l'extension.

Workflow compatible avec l'IA

L'extension Looker pour VS Code fait partie d'un workflow de développement agentique compatible avec 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 IA intégré (par exemple, Cursor) ou, s'il n'en contient pas (comme VS Code de base), il doit être intégré à un outil agentique autonome (tel que Gemini CLI ou Claude Code). Pour savoir comment connecter votre IDE à un agent, consultez la documentation de votre IDE local.
Un serveur MCP, tel que MCP Toolbox for Databases.

Pour en savoir plus sur le workflow compatible avec l'IA, consultez la page de documentation Développement assisté par l'IA (vibe coding) 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 IA à la 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é dans votre instance Looker, vous pouvez y accéder avec le format d'URL suivant :
```
https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/
```
Si l'explorateur d'API n'est pas installé dans votre instance Looker, vous pouvez l'installer à partir de Looker Marketplace. Pour en savoir plus, consultez la page Utiliser l'explorateur d'API.

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 les champs display_name et description comme décrit dans la documentation Enregistrer une application cliente OAuth.

Une fois l'application enregistrée, l'explorateur d'API renvoie une réponse contenant un résumé 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 à partir de 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 (Command+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 des identifiants d'API.

S'authentifier avec OAuth (recommandé)

OAuth 2.1 est le flux d'authentification 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 d'API

Si vous préférez utiliser des clés API Looker, suivez la documentation pour créer des identifiants d'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 d'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 et vous permet d'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 option que si elle est différente de l'URL de votre instance.	`looker.instanceURL`
`looker.sdkURL`	URL à utiliser pour les requêtes API. Ne définissez cette option 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 à utiliser comme proxy (par exemple, `http://localhost:5000/mcp`).	-
`looker.acceptSelfSignedCertificates`	Ignorer les erreurs de certificat SSL (par exemple, pour les certificats auto-signés). Avertissement : Il n'est pas recommandé d'activer cette option.	`false`
`looker.askBeforeOverwritingRemote`	Toujours demander avant d'écraser des 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 suivante : Looker: Sign In (OAuth) (Looker : se connecter (OAuth)).
Acceptez l'invite à ouvrir votre navigateur.
Dans le navigateur, autorisez l'extension à accéder à votre compte Looker.
Une fois l'autorisation accordée, le navigateur redirige vers votre IDE. Une notification indiquant Successfully signed in to Looker! (Vous êtes connecté à Looker) 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: Clone (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 la synchronisation avec votre branche extraite en 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 Developer: Set Log Level (Développeur : définir le niveau de journalisation), puis sélectionnez Debug (Débogage) ou Trace.

Erreurs d'authentification : vérifiez que 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 : actualiser la fenêtre) à partir de la palette de commandes peut vous aider à les résoudre.