Guida introduttiva all'estensione Looker per VS Code

L'estensione Looker per VS Code ti consente di sviluppare LookML direttamente nel tuo ambiente desktop locale. Fornisce l'evidenziazione della sintassi avanzata, la sincronizzazione bidirezionale dei file con l'istanza di Looker e l'integrazione con gli agenti di codifica AI per la "codifica di vibrazioni".

L'estensione è creata utilizzando il framework Visual Studio Code (VS Code) e supporta gli IDE basati su VS Code, come i seguenti IDE e strumenti di codifica:

Claude Code
Codex
Cursore
Kiro
VS Code
Windsurf
Zed

Gli IDE che non sono fork di VS Code, come IntelliJ ed Eclipse, non sono supportati dall'estensione Looker per VS Code.

Questa guida spiega come configurare e autenticare l'estensione.

Workflow abilitato all'AI

L'estensione Looker per VS Code fa parte di un flusso di lavoro di sviluppo agentico basato sull'AI per la modifica e la creazione di file LookML. Per attivare questo flusso di lavoro, configura i seguenti strumenti:

L'estensione Looker per VS Code.
Un IDE locale basato su VS Code. L'IDE deve contenere un agente AI integrato (ad esempio Cursor) oppure, se non lo contiene (come VS Code di base), deve essere integrato con uno strumento agentico autonomo (come Gemini CLI o Claude Code). Consulta la documentazione del tuo IDE locale per scoprire come connetterlo a un agente.
Un server MCP, ad esempio MCP Toolbox for Databases.

Per saperne di più sul flusso di lavoro reso possibile dall'AI, consulta la pagina di documentazione Sviluppo assistito dall'AI (vibe coding) con Looker.

Prima di iniziare

Prima di installare l'estensione, devi soddisfare i seguenti requisiti:

Connettiti agli strumenti di AI: se prevedi di utilizzare lo sviluppo assistito dall'AI, connetti il tuo IDE e il tuo agente AI a MCP Toolbox for Databases. Ad esempio, una configurazione di esempio per connettere MCP Toolbox a Gemini CLI è riportata nella documentazione Utilizzare Looker con MCP, Gemini CLI e altri agenti. Per ulteriori dettagli, consulta la documentazione degli strumenti.
Autorizzazioni Looker: devi disporre dell'autorizzazione Looker develop per tutti i modelli che vuoi modificare.
Istanza di Looker: la tua istanza deve eseguire Looker 26.6 o versioni successive.
Installazione di Git: devi aver installato Git sulla tua macchina locale per clonare e gestire il repository LookML.
Configurazione del progetto: il tuo progetto LookML deve essere configurato per Git.
ID client OAuth: se utilizzi l'autenticazione OAuth (consigliata), devi ottenere un ID client OAuth dall'amministratore di Looker.

Configurazione amministratore

Se la tua organizzazione utilizza OAuth per l'autenticazione, un amministratore di Looker deve registrare l'estensione Looker per VS Code come client OAuth nell'interfaccia utente di amministrazione di Looker.

Utilizza Explorer API di Looker per configurare l'integrazione OAuth. Puoi accedere a Explorer API utilizzando uno dei seguenti metodi:

Se nella tua istanza di Looker è già installato Explorer API, puoi accedervi con questo formato URL:
```
https://LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/
```
Se la tua istanza Looker non dispone di Explorer API, puoi installarlo da Looker Marketplace. Per informazioni, consulta la pagina Utilizzo di Explorer API.

Per registrare l'estensione, completa i seguenti passaggi:

Segui le istruzioni riportate nella documentazione Registrazione di un'applicazione client OAuth per registrare l'estensione.
Per il campo client_guid, completa i seguenti passaggi:
- Utilizza un ID univoco globale.
- Prepara la distribuzione dell'ID a tutti gli sviluppatori LookML che vogliono utilizzare l'estensione.

Per redirect_uri, utilizza:

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

Completa display_name e description come descritto nella documentazione Registrazione di un'applicazione client OAuth.

Una volta registrata l'app, Explorer API restituirà una risposta con un riepilogo della registrazione. Puoi utilizzare l'endpoint Get OAuth Client App con client_guid per esaminare i dettagli della registrazione.

Fornisci il client_guid generato agli sviluppatori, che lo utilizzeranno per configurare l'estensione.

Installare l'estensione

Per installare l'estensione, completa i seguenti passaggi:

Installa l'estensione Looker per VS Code da Visual Studio Marketplace.
Apri l'IDE, ad esempio VS Code o Cursor.
Fai clic sull'icona Estensioni nella barra delle attività.
Trova l'estensione Looker per VS Code e fai clic su Installa.
Una volta installata l'estensione, nella barra delle attività viene visualizzata l'icona Looker.

Configurare l'estensione

Devi configurare l'estensione con i dettagli dell'istanza di Looker nel file settings.json del tuo spazio di lavoro.

Con uno spazio di lavoro aperto, apri il riquadro dei comandi (Cmd+Shift+P su Mac o Ctrl+Shift+P su Windows/Linux).
Cerca e seleziona Preferenze: apri impostazioni di Workspace (JSON).
Aggiungi le variabili di configurazione alle impostazioni. Le variabili di configurazione variano a seconda che il metodo di autenticazione sia OAuth o le credenziali API.

Eseguire l'autenticazione con OAuth (consigliato)

OAuth 2.1 è il flusso di autenticazione consigliato. Incolla queste impostazioni nel file settings.json del tuo workspace.

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

Sostituisci quanto segue:

https://YOUR_INSTANCE_URL: l'URL della tua istanza di Looker.
YOUR_OAUTH_CLIENT_ID: l'ID client OAuth (client_guid) che ricevi dall'amministratore di Looker.
YOUR_PROJECT_ID: il nome del progetto che vuoi modificare. Per trovarlo, all'interno dell'istanza di Looker, apri la pagina Progetti LookML. L'ID progetto si trova nella colonna Progetto.

Autenticarsi con le credenziali API

Se preferisci utilizzare le chiavi API Looker, segui la documentazione per creare le credenziali API. Devi anche fornire l'ID progetto.

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

Sostituisci quanto segue:

https://YOUR_INSTANCE_URL: l'URL della tua istanza di Looker.
YOUR_CLIENT_ID e YOUR_CLIENT_SECRET: l'ID client e il client secret per le credenziali API che stai utilizzando per l'autenticazione. Per trovare queste credenziali, all'interno dell'istanza di Looker, apri la pagina Account, poi fai clic sul pulsante Gestisci nella sezione Chiavi API. Si apre la pagina Chiavi API, dove puoi visualizzare gli ID client e i secret.
YOUR_PROJECT_ID: il nome del progetto che vuoi modificare. Per trovare il nome del progetto, all'interno dell'istanza di Looker, apri la pagina Progetti LookML. L'ID progetto si trova nella colonna Progetto.

Impostazioni

Puoi configurare le seguenti impostazioni di MCP nello spazio di lavoro dell'IDE.

Impostazione	Descrizione	Predefinito
`looker.instanceURL`	URL di base dell'istanza di Looker (ad esempio, `https://mycompany.looker.com`).	-
`looker.authURL`	URL da utilizzare per l'autenticazione OAuth. Imposta solo se diverso dall'URL dell'istanza.	`looker.instanceURL`
`looker.sdkURL`	URL da utilizzare per le richieste API. Imposta solo se diverso dall'URL dell'istanza.	`looker.instanceURL`
`looker.oauthClientId`	ID client OAuth di Looker. Obbligatorio per OAuth.	-
`looker.clientId`	ID client API Looker. Obbligatorio per l'autenticazione con chiave API.	-
`looker.clientSecret`	Client secret dell'API Looker. Obbligatorio per l'autenticazione con chiave API.	-
`looker.projectId`	ID progetto Looker.	-
`looker.mcpServerUrl`	URL del server MCP esterno da proxy (ad esempio, `http://localhost:5000/mcp`).	-
`looker.acceptSelfSignedCertificates`	Ignora gli errori del certificato SSL (ad esempio, per i certificati autofirmati). Avviso: l'attivazione di questa opzione non è consigliata.	`false`
`looker.askBeforeOverwritingRemote`	Chiedi sempre prima di sovrascrivere i file remoti quando viene rilevato un conflitto.	`false`

Autenticarsi tramite Looker

Se utilizzi l'autenticazione OAuth, devi accedere per collegare il tuo IDE locale al tuo account Looker.

Apri la tavolozza dei comandi.
Esegui il comando Looker: Sign In (OAuth).
Accetta il prompt per aprire il browser.
Nel browser, autorizza l'estensione ad accedere al tuo account Looker.
Dopo l'autorizzazione, il browser reindirizza nuovamente all'IDE. Dovresti visualizzare una notifica che indica Accesso a Looker riuscito.

Clonare il progetto LookML

Per iniziare lo sviluppo, devi clonare il repository LookML sulla tua macchina locale.

In VS Code, apri una nuova finestra.
Apri la tavolozza dei comandi e seleziona Git: Clone.
Inserisci l'URL del repository Git remoto (ad esempio da GitHub o GitLab) e scegli una cartella locale.
Apri la cartella clonata nell'IDE.

L'estensione rileva automaticamente i file LookML e inizia la sincronizzazione con il ramo estratto nella modalità di sviluppo dell'istanza Looker.

Risoluzione dei problemi

Puoi visualizzare i log delle estensioni nel riquadro Output dell'IDE. Seleziona il canale Looker per visualizzare i log. Per log più dettagliati, apri la tavolozza dei comandi, esegui il comando Sviluppatore: imposta il livello di log e seleziona Debug o Trace.

Errori di autenticazione: verifica che looker.instanceUrl e looker.oauthClientId siano corretti. Assicurati che l'URI di reindirizzamento in Looker corrisponda esattamente.
Problemi di sincronizzazione: controlla i log delle estensioni per risolvere i problemi di sincronizzazione. Per visualizzare i log, apri il riquadro Output e seleziona Looker dal menu a discesa.
Risposta Richiesta errata durante OAuth: assicurati che la tua istanza di Looker sia accessibile dalla tua rete locale e di disporre di una connessione a internet valida.

Se riscontri problemi con l'estensione, l'esecuzione del comando Sviluppatore: ricarica finestra dalla tavolozza dei comandi può aiutarti a risolverli.