Utilizza MCP Toolbox for Databases

Nota: il server MCP gestito da Looker è il metodo consigliato per connettere le applicazioni AI alle istanze di Looker ospitate da Looker. Fornisce un'integrazione integrata, sicura e senza infrastruttura direttamente all'interno della piattaforma Looker. Per le istruzioni di configurazione, consulta la pagina della documentazione relativa al server MCP gestito da Looker.

Questa pagina mostra come utilizzare MCP Toolbox for Databases per connettere la tua istanza di Looker ad ambienti di sviluppo integrati (IDE) e strumenti per sviluppatori che supportano il Model Context Protocol (MCP). La casella degli strumenti MCP è una buona opzione se utilizzi un'istanza ospitata dal cliente o se preferisci gestire la tua infrastruttura. In caso contrario, ti consigliamo di utilizzare il server MCP gestito da Looker.

Ti consigliamo di utilizzare l'estensione Looker dedicata per Gemini CLI con MCP Toolbox. Utilizza il livello semantico di Looker per fornire a Gemini CLI un accesso sicuro, controllato e on demand ai dati attendibili e accelera i flussi di lavoro automatizzando la creazione di report, visualizzazioni e dashboard da prompt in linguaggio naturale. In qualità di interfaccia a riga di comando di nuova generazione di Google Cloud, Gemini CLI è lo strumento consigliato per interagire con le tue istanze di Looker dalla riga di comando.

Puoi anche connettere altri ambienti di sviluppo integrati (IDE) e strumenti per sviluppatori che supportano il Model Context Protocol (MCP) utilizzando l'MCP Toolbox for Databases per uso generico. MCP Toolbox è un server MCP open source che semplifica la connessione degli agenti AI ai tuoi dati gestendo complessità come l'autenticazione e il pooling delle connessioni, consentendoti di interagire con i tuoi dati utilizzando il linguaggio naturale direttamente dal tuo IDE. Per questi strumenti, questo metodo fornisce funzionalità di interazione con il database di base.

Nota: MCP Toolbox è un progetto open source fornito "così com'è". Non è un prodotto Google Cloud supportato e non è coperto dalle Google Cloud Linee guida per i servizi di assistenza tecnica o dagli SLA. Per assistenza, consulta la pagina dei problemi di GitHub del progetto.

Informazioni su Gemini CLI e sulle estensioni

Gemini CLI è un agente AI open source progettato per accelerare i workflow di sviluppo fornendo assistenza per la programmazione, il debug, l'esplorazione dei dati e la creazione di contenuti. La sua missione è fornire un'esperienza agentica elegante per l'interazione con i servizi Data Cloud e i database open source più diffusi.

Funzionamento delle estensioni

Gemini CLI è altamente estensibile e consente di aggiungere nuovi strumenti e funzionalità tramite estensioni. Queste estensioni sono semplici da installare. Puoi caricarli da un URL GitHub, da una directory locale o da un registry configurabile. Queste estensioni offrono un ricco insieme di funzionalità, tra cui nuovi strumenti, comandi slash e prompt per semplificare il tuo workflow.

Prepara l'autenticazione di Looker

Hai due opzioni per autenticare il tuo client MCP con Looker: puoi utilizzare le credenziali API standard o autenticare il client tramite la registrazione di un'applicazione OAuth.

Opzione 1: credenziali API

1. Ottieni un ID client e un client secret di Looker. Segui le istruzioni riportate nella pagina della documentazione Autenticazione dell'API Looker.
2. Tieni a portata di mano l'URL di base dell'istanza di Looker. Probabilmente è simile a https://looker.example.com. In alcuni casi l'API è in ascolto su una porta diversa e dovrai utilizzare https://looker.example.com:19999.

Opzione 2: registrazione dell'applicazione OAuth

1. Apri Explorer API Looker.

   Explorer API installato

   Se nella tua istanza di Looker è già installato Explorer API, puoi accedervi con questo formato di URL:

   LOOKER_INSTANCE_URL/extensions/marketplace_extension_api_explorer::api-explorer/
   

   Explorer API non installato

   Se la tua istanza di Looker non dispone di Explorer API, puoi installarlo da Looker Marketplace. Per informazioni su come installare Explorer API, consulta la pagina Utilizzo di Explorer API.

   Istanza privata PSA

   Se utilizzi un'istanza di connessioni private di Looker (Google Cloud core) che utilizza l'accesso privato ai servizi, il Marketplace di Looker e Explorer API non sono supportati. Per registrare un agente AI, devi chiamare direttamente l'endpoint API oauth_client_apps. Se utilizzi questo metodo, puoi saltare i passaggi rimanenti di questa procedura di Explorer API.

   Di seguito è riportato un esempio di comando curl che puoi utilizzare con l'endpoint oauth_client_apps per registrare l'agente.

   curl -X POST "https://LOOKER_INSTANCE_URL/api/4.0/oauth_client_apps/CLIENT_GUID" \
   -H "Authorization: token ACCESS_TOKEN" \
   -H "Content-Type: application/json" \
   -d '{
     "redirect_uri": "REDIRECT_URI",
     "display_name": "CLIENT_NAME",
     "description": "OAuth client to access MCP server using CLIENT_NAME",
     "enabled": true
   }'
   

2. Nel metodo Auth, individua l'endpoint API Register OAuth App. Puoi anche cercare "app oauth" nel campo Cerca.

3. Seleziona Esegui.

4. Per client_guid, inserisci una stringa personalizzata (ad esempio, gemini_cli o claude-desktop).

5. Nel corpo della richiesta, inserisci la seguente configurazione JSON:

   {
     "redirect_uri": "AI_AGENT_REDIRECT_URI",
     "display_name": "APPLICATION_NAME",
     "description": "APPLICATION_DESCRIPTION",
     "enabled": true
   }
   

   Sostituisci quanto segue:

   • AI_AGENT_REDIRECT_URI: l'URI di reindirizzamento per l'estensione dell'agente AI o l'applicazione di servizio condiviso.

     • Per le applicazioni in hosting su cloud, potrebbe essere simile a un URL HTTPS sicuro: https://AI_AGENT_URL/oauth2callback

     • Per le applicazioni in esecuzione in locale, deve essere un URL localhost con una porta statica: http://localhost:7777/oauth/callback

       Nota: alcuni strumenti, come Gemini CLI, potrebbero richiedere l'impostazione di una variabile di ambiente (ad esempio export OAUTH_CALLBACK_PORT=7777) per garantire che utilizzino una porta statica corrispondente all'URI di reindirizzamento registrato.

     • Per gli IDE, potrebbe essere simile al seguente: vscode://google.vscode-looker-official/oauth_callback

   • APPLICATION_NAME: il nome visualizzato della tua applicazione OAuth, ad esempio Claude Desktop.

   • APPLICATION_DESCRIPTION: una breve descrizione della tua applicazione OAuth.

6. Seleziona la casella di conferma accanto a Comprendo che questo endpoint API modificherà i dati, quindi seleziona Esegui.

Installa MCP Toolbox

Nota: se utilizzi Gemini CLI o Gemini Code Assist per connetterti alla tua istanza di Looker utilizzando MCP Toolbox for Databases, non è necessario installare MCP Toolbox. MCP Toolbox verrà installato quando l'estensione Gemini viene installata durante il passaggio di configurazione.

1. Scarica l'ultima versione di MCP Toolbox come file binario. Seleziona il file binario corrispondente al tuo sistema operativo e alla tua architettura della CPU. Devi utilizzare MCP Toolbox versione V1.0.0 o successive.

   linux/amd64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/linux/amd64/toolbox
   
   

   darwin/arm64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/arm64/toolbox
   
   

   darwin/amd64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/darwin/amd64/toolbox
   
   

   windows/amd64

   curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/v1.0.0/windows/amd64/toolbox.exe
   
   

2. Rendi eseguibile il file binario.

   chmod +x toolbox
   

3. Verifica l'installazione.

   ./toolbox --version
   

Esegui MCP Toolbox come servizio condiviso

Per i client MCP che richiedono l'autenticazione OAuth tramite HTTPS, devi eseguire il deployment di MCP Toolbox dietro un reverse proxy HTTPS (ad esempio Cloud Run). Il reverse proxy termina l'SSL e inoltra le richieste al container MCP Toolbox.

Configura l'ambiente del server

1. Imposta le seguenti variabili di ambiente nel tuo deployment:

   • LOOKER_BASE_URL=YOUR_LOOKER_BASE_URL
   • LOOKER_USE_CLIENT_OAUTH=true

2. Esegui MCP Toolbox con i seguenti argomenti:

   • --prebuilt=looker,looker-dev
   • --mcp-prm-file=prm.json
   • [--address=0.0.0.0]
   • [--port=8080]

   Normalmente, MCP Toolbox rimane in ascolto sulla porta 5000 di 127.0.0.1. Se il reverse proxy si trova su un altro host, utilizza --address=0.0.0.0 per eseguire il binding a tutti gli indirizzi IP. Utilizza l'impostazione --port= se devi utilizzare una porta di ascolto diversa da 5000. Ad esempio, Cloud Run inoltra automaticamente il traffico esterno dalla porta 443, la porta HTTPS, a 8080.

3. Crea un file di configurazione dei metadati delle risorse protette (PRM) (prm.json) con la seguente struttura:

   {
   "resource": "https://PROXY_URL/mcp",
   "authorization_servers": ["LOOKER_URL"],
   "scopes_supported": ["cors_api"]
   }
   

   Sostituisci quanto segue:

   • PROXY_URL: il dominio e il percorso di base del server proxy inverso.
   • LOOKER_URL: l'URL di base della tua istanza di Looker.

Per un esempio di come configurare il client quando esegui MCP Toolbox come servizio condiviso, consulta l'esempio di configurazione di Claude Desktop.

Configura il client MCP

Questa sezione descrive come configurare vari strumenti per sviluppatori per connetterti alla tua istanza di Looker utilizzando MCP Toolbox for Databases. La toolbox funge da server Model Context Protocol (MCP) open source che si trova tra l'IDE e il database, fornendo un control plane sicuro ed efficiente per i tuoi strumenti AI. Seleziona la scheda dello strumento specifico per visualizzare le istruzioni di configurazione.

• Gemini CLI
• Gemini Code Assist
• Claude Code
• Claude desktop
• Cline (estensione VS Code)
• Cursore
• Visual Studio Code (Copilot)
• Windsurf (Codium)

Gemini CLI

Scegli il metodo di connessione in base alla tua scelta di autenticazione:

Opzione 1: credenziali API con estensione

1. Installa Gemini CLI.
2. Installa l'estensione di Looker per Gemini CLI dal repository GitHub utilizzando il seguente comando:

   gemini extensions install https://github.com/gemini-cli-extensions/looker
   

3. Imposta le variabili di ambiente per connetterti alla tua istanza di Looker, sostituendo le seguenti variabili di ambiente con i tuoi valori:
   • LOOKER_URL: l'URL dell'istanza di Looker.
   • CLIENT_ID e CLIENT_SECRET: la chiave API utilizzata per accedere all'API Looker.
   • VERIFY_SSL: true o false, a seconda che utilizzi la crittografia SSL per connettere il database alla tua istanza di Looker.

   export LOOKER_BASE_URL="LOOKER_URL"
   export LOOKER_CLIENT_ID="CLIENT_ID"
   export LOOKER_CLIENT_SECRET="CLIENT_SECRET"
   export LOOKER_VERIFY_SSL="VERIFY_SSL"
   

4. Avvia Gemini CLI in modalità interattiva:

   gemini
   

   La CLI carica automaticamente l'estensione Looker per l'estensione Gemini CLI e i relativi strumenti, che puoi utilizzare per interagire con l'istanza di Looker.

Opzione 2: servizio condiviso remoto con OAuth

Per connetterti a un servizio condiviso remoto utilizzando OAuth, non installare l'estensione Looker. Configura invece Gemini CLI per connetterti direttamente al tuo server MCP remoto.

1. Installa Gemini CLI.
2. Aggiungi il server MCP remoto utilizzando il seguente comando, sostituendo PROXY_URL con il dominio del tuo server reverse proxy:

   gemini mcp add --transport http looker https://PROXY_URL/mcp
   

   In alternativa, puoi configurarlo manualmente aggiungendo la seguente configurazione al file settings.json (che si trova in ~/.gemini/settings.json o nella directory del progetto):

   {
     "mcpServers": {
       "looker": {
         "httpUrl": "https://PROXY_URL/mcp"
       }
     }
   }
   

3. Avvia Gemini CLI in modalità interattiva:

   gemini
   

   Quando ti viene chiesto di connetterti, l'interfaccia a riga di comando avvia il flusso di autorizzazione OAuth per l'autenticazione sicura con l'istanza Looker.

Gemini Code Assist

Ti consigliamo di configurare Gemini Code Assist per utilizzare Gemini CLI. Questo approccio elimina la necessità di configurare manualmente un server MCP.

1. Assicurati di aver installato e configurato Gemini CLI e l'estensione looker (per le credenziali API) o una configurazione del server MCP remoto (per il servizio condiviso con OAuth).
2. Configura Gemini Code Assist per utilizzare Gemini CLI.
3. Inizia a interagire con la tua istanza di Looker utilizzando il linguaggio naturale direttamente nella chat di Gemini Code Assist.

Claude Code

Scegli il metodo di connessione in base alla tua scelta di autenticazione:

Opzione 1: credenziali API

1. Installa Claude Code.
2. Crea il file .mcp.json nella directory root del progetto, se non esiste.
3. Aggiungi la seguente configurazione, sostituendo le seguenti variabili di ambiente con i tuoi valori, quindi salva.
   • LOOKER_URL: l'URL dell'istanza di Looker.
   • CLIENT_ID e CLIENT_SECRET: la chiave API utilizzata per accedere all'API Looker.
   • VERIFY_SSL: true o false, a seconda che utilizzi la crittografia SSL per connettere il database alla tua istanza di Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

Opzione 2: servizio condiviso remoto con OAuth

1. Installa Claude Code.
2. Crea il file .mcp.json nella directory root del progetto, se non esiste.
3. Aggiungi la seguente configurazione, sostituendo PROXY_URL con il dominio del tuo server proxy inverso, quindi salva.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }
  

Claude per computer

Scegli il metodo di connessione in base alla tua scelta di autenticazione:

Opzione 1: credenziali API

1. Apri Claude per computer e vai a Impostazioni.
2. Nella scheda Developer (Sviluppatore), fai clic su Edit Config (Modifica configurazione) per aprire il file di configurazione.
3. Aggiungi la seguente configurazione, sostituendo le seguenti variabili di ambiente con i tuoi valori, quindi salva.
   • LOOKER_URL: l'URL dell'istanza di Looker.
   • CLIENT_ID e CLIENT_SECRET: la chiave API utilizzata per accedere all'API Looker.
   • VERIFY_SSL: true o false, a seconda che utilizzi la crittografia SSL per connettere il database alla tua istanza di Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

Opzione 2: servizio condiviso remoto con OAuth

1. In Claude per computer, vai a Impostazioni e seleziona Connettori.
2. Scegli Aggiungi connettore personalizzato e inserisci un nome (ad esempio, Looker).
3. Per l'URL, inserisci l'endpoint del server reverse proxy con il percorso /mcp aggiunto (ad esempio, https://looker-mcp-toolbox.example.com/mcp).
4. In Impostazioni avanzate, inserisci la stringa esatta che hai utilizzato per client_guid durante la registrazione dell'app OAuth. Lascia vuoto il client secret OAuth.
5. Seleziona Aggiungi per salvare il connettore. Quando ti viene chiesto di connetterti, Claude per computer avvia in modo sicuro il flusso di autorizzazione PKCE tramite il tuo browser.

4. Riavvia Claude per computer.

Cline

Scegli il metodo di connessione in base alla tua scelta di autenticazione:

Opzione 1: credenziali API

1. Apri l'estensione Cline in VS Code e fai clic sull'icona Server MCP.
2. Fai clic su Configura i server MCP per aprire il file di configurazione.
3. Aggiungi la seguente configurazione, sostituendo le seguenti variabili di ambiente con i tuoi valori, quindi salva.
   • LOOKER_URL: l'URL dell'istanza di Looker.
   • CLIENT_ID e CLIENT_SECRET: la chiave API utilizzata per accedere all'API Looker.
   • VERIFY_SSL: true o false, a seconda che utilizzi la crittografia SSL per connettere il database alla tua istanza di Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

Una volta stabilita la connessione al server, viene visualizzato lo stato attivo verde.

Opzione 2: servizio condiviso remoto con OAuth

1. Apri l'estensione Cline in VS Code e fai clic sull'icona Server MCP.
2. Fai clic su Configura i server MCP per aprire il file di configurazione.
3. Aggiungi la seguente configurazione, sostituendo PROXY_URL con il dominio del tuo server proxy inverso, quindi salva.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }
  

Una volta stabilita la connessione al server, viene visualizzato lo stato attivo verde.

Cursore

Scegli il metodo di connessione in base alla tua scelta di autenticazione:

Opzione 1: credenziali API

1. Se non esiste, crea la directory .cursor nella directory root del progetto.
2. Crea il file .cursor/mcp.json se non esiste e aprilo.
3. Aggiungi la seguente configurazione, sostituendo le seguenti variabili di ambiente con i tuoi valori, quindi salva.
   • LOOKER_URL: l'URL dell'istanza di Looker.
   • CLIENT_ID e CLIENT_SECRET: la chiave API utilizzata per accedere all'API Looker.
   • VERIFY_SSL: true o false, a seconda che utilizzi la crittografia SSL per connettere il database alla tua istanza di Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

4. Apri Cursor e vai a Settings > Cursor Settings > MCP (Impostazioni > Impostazioni di Cursor > MCP). Quando il server si connette, viene visualizzato lo stato attivo verde.

Opzione 2: servizio condiviso remoto con OAuth

1. Se non esiste, crea la directory .cursor nella directory root del progetto.
2. Crea il file .cursor/mcp.json se non esiste e aprilo.
3. Aggiungi la seguente configurazione, sostituendo PROXY_URL con il dominio del tuo server proxy inverso, quindi salva.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }
  

4. Apri Cursor e vai a Settings > Cursor Settings > MCP (Impostazioni > Impostazioni di Cursor > MCP). Quando il server si connette, viene visualizzato lo stato attivo verde.

Visual Studio Code (Copilot)

Scegli il metodo di connessione in base alla tua scelta di autenticazione:

Opzione 1: credenziali API

1. Apri VS Code e crea la directory .vscode nella directory root del progetto, se non esiste.
2. Crea il file .vscode/mcp.json se non esiste e aprilo.
3. Aggiungi la seguente configurazione, sostituendo le seguenti variabili di ambiente con i tuoi valori, quindi salva.
   • LOOKER_URL: l'URL dell'istanza di Looker.
   • CLIENT_ID e CLIENT_SECRET: la chiave API utilizzata per accedere all'API Looker.
   • VERIFY_SSL: true o false, a seconda che utilizzi la crittografia SSL per connettere il database alla tua istanza di Looker.

      {
        "servers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

Opzione 2: servizio condiviso remoto con OAuth

1. Apri VS Code e crea la directory .vscode nella directory root del progetto, se non esiste.
2. Crea il file .vscode/mcp.json se non esiste e aprilo.
3. Aggiungi la seguente configurazione, sostituendo PROXY_URL con il dominio del tuo server proxy inverso, quindi salva.

      {
        "servers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }
  

Windsurf

Scegli il metodo di connessione in base alla tua scelta di autenticazione:

Opzione 1: credenziali API

1. Apri Windsurf e vai all'assistente Cascade.
2. Fai clic sull'icona MCP, quindi su Configura per aprire il file di configurazione.
3. Aggiungi la seguente configurazione, sostituendo le seguenti variabili di ambiente con i tuoi valori, quindi salva.
   • LOOKER_URL: l'URL dell'istanza di Looker.
   • CLIENT_ID e CLIENT_SECRET: la chiave API utilizzata per accedere all'API Looker.
   • VERIFY_SSL: true o false, a seconda che utilizzi la crittografia SSL per connettere il database alla tua istanza di Looker.

      {
        "mcpServers": {
          "looker-toolbox": {
            "command": "./PATH/TO/toolbox",
            "args": ["--stdio", "--prebuilt", "looker"],
            "env": {
                "LOOKER_BASE_URL": "LOOKER_URL",
                "LOOKER_CLIENT_ID": "CLIENT_ID",
                "LOOKER_CLIENT_SECRET": "CLIENT_SECRET",
                "LOOKER_VERIFY_SSL": "VERIFY_SSL",
          }
          }
        }
      }
  

Opzione 2: servizio condiviso remoto con OAuth

1. Apri Windsurf e vai all'assistente Cascade.
2. Fai clic sull'icona MCP, quindi su Configura per aprire il file di configurazione.
3. Aggiungi la seguente configurazione, sostituendo PROXY_URL con il dominio del tuo server proxy inverso, quindi salva.

      {
        "mcpServers": {
          "looker-toolbox": {
            "type": "http",
            "url": "https://PROXY_URL/mcp"
          }
        }
      }
  

Utilizza gli strumenti AI

Il tuo strumento AI è ora connesso a Looker tramite MCP. Prova a chiedere all'assistente AI di elencare modelli, esplorazioni, dimensioni e misure. Puoi anche eseguire una query recuperando l'SQL per una query o eseguendo un Look salvato.

Nota: l'insieme di strumenti disponibili nel server MCP gestito da Looker è soggetto a modifiche man mano che gli strumenti vengono ottimizzati per prestazioni e sicurezza.

All'LLM sono disponibili i seguenti strumenti:

Modello di Looker e Query Tool

Questi strumenti vengono utilizzati per ottenere informazioni su un modello Looker ed eseguire query su quel modello.

• get_models: elenca tutti i modelli LookML nell'istanza di Looker.
• get_explores: elenca le esplorazioni in un determinato modello.
• get_dimensions: elenca le dimensioni in un'esplorazione specifica.
• get_measures: elenca le misure in un'esplorazione specifica.
• get_filters: elenca i filtri in un'esplorazione specifica.
• get_parameters: elenca i parametri in un'esplorazione specifica.
• query: esegue una query e restituisce i dati.
• query_sql: restituisce l'SQL generato da Looker per una query.
• query_url: restituisce un link alla query in Looker per un'ulteriore esplorazione.

Strumenti per i contenuti di Looker

Questi strumenti recuperano i contenuti salvati (Look e dashboard) da un'istanza di Looker e creano nuovi contenuti salvati.

• get_looks: restituisce i Look salvati che corrispondono a un titolo o a una descrizione.
• run_look: esegue un Look salvato e restituisce i dati.
• make_look: crea un Look salvato in Looker e restituisce l'URL.
• get_dashboards: restituisce le dashboard salvate che corrispondono a un titolo o a una descrizione.
• make_dashboard: crea una dashboard salvata in Looker e restituisce l'URL.
• add_dashboard_element: aggiungi un riquadro a una dashboard.

Strumenti per l'integrità delle istanze di Looker

Questi strumenti offrono gli stessi algoritmi di controllo di integrità della popolare interfaccia a riga di comando Henry.

• health_pulse: controlla l'integrità di un'istanza Looker.
• health_analyze: analizza l'utilizzo di un oggetto Looker.
• health_vacuum: trova gli elementi LookML che potrebbero non essere utilizzati.

Strumenti di creazione LookML

Questi strumenti consentono al chiamante di scrivere e modificare i file LookML, nonché di ottenere lo schema del database necessario per scrivere LookML in modo efficace.

• dev_mode: attiva e disattiva la modalità di sviluppo per la sessione. La creazione di LookML deve essere eseguita in modalità di sviluppo. Le query eseguite in modalità di sviluppo utilizzano il LookML modificato in modo da poter testare l'impatto delle modifiche.
• get_projects: recupera l'elenco dei progetti LookML disponibili.
• get_project_files: recupera l'elenco dei file LookML in un progetto.
• get_project_file: recupera i contenuti di un file LookML.
• create_project_file: crea un nuovo file LookML.
• update_project_file: modifica un file LookML esistente.
• delete_project_file: elimina un file LookML.
• get_connections: recupera l'elenco delle connessioni.
• get_connection_schemas: recupera l'elenco degli schemi per una connessione.
• get_connection_databases: recupera l'elenco dei database per una connessione.
• get_connection_tables: recupera l'elenco delle tabelle per una connessione.
• get_connection_table_columns: recupera l'elenco delle colonne di una tabella in una connessione.

Nota: gli strumenti predefiniti sono precedenti alla versione 1.0, quindi aspettati alcune modifiche tra le versioni. Poiché gli LLM si adattano agli strumenti disponibili, la maggior parte degli utenti non subirà conseguenze.