Connettore Looker-Excel

Il connettore Looker-Excel ti consente di esportare le query da un'esplorazione di Looker in un formato riconosciuto da Microsoft Excel. Quando il connettore Looker-Excel è abilitato, le esplorazioni di Looker mostrano l'opzione Apri in Excel nel menu a forma di ingranaggio di Esplora. Quando selezioni questa opzione, Looker esporta la query di Esplora in un file ODC sul tuo PC Windows. Se hai installato il driver ODBC, puoi aprire il file ODC in Microsoft Excel per Windows.

Prima di iniziare

Per utilizzare il connettore Looker-Excel, devi disporre di quanto segue:

• Un PC Windows a 64 o 32 bit.
• Un'istanza di Looker che soddisfi i seguenti requisiti:
  • Eseguire Looker 25.16 o versioni successive.
  • Attivata per il connettore BI di Microsoft Excel. Un amministratore di Looker deve attivare il client Microsoft Excel preconfigurato dalla scheda Libreria di applicazioni nella pagina Gestisci client OAuth (Amministratore > Autenticazione > Gestisci client OAuth) o attivare l'opzione Microsoft Excel nella pagina Connettori BI di Looker.
• Un account Looker con un ruolo utente che include l'autorizzazione explore sul modello LookML a cui l'utente vuole accedere con Looker-Excel Connector.

Devi anche installare il driver ODBC, come descritto nella sezione seguente.

Installazione del driver ODBC

Il driver ODBC di Looker è un software che deve essere installato sul computer locale di ogni utente del connettore Looker-Excel. Il driver ODBC consente ai client compatibili con ODBC di connettersi alla tua istanza di Looker come se fosse un database SQL.

Per utilizzare un driver ODBC, devi avere installato un programma di gestione ODBC. In genere, Windows viene fornito con un programma preinstallato chiamato Origini dati ODBC come strumento di gestione. Per saperne di più, consulta la documentazione di Microsoft sull'Amministratore origine dati ODBC.

Per installare il driver ODBC, segui questi passaggi:

1. Utilizza i seguenti link per scaricare il programma di installazione ODBC più recente per l'architettura del tuo sistema Windows (64 bit o 32 bit):

   • 64-bit
   • 32 bit

2. Apri il file del programma di installazione ODBC e segui le istruzioni sullo schermo.

3. Potresti visualizzare una finestra di dialogo di Windows con il messaggio PC protetto da Windows. Se vedi questa finestra di dialogo, fai clic sul link Ulteriori informazioni e poi sul pulsante Esegui comunque.

La prima volta che apri un file ODC dopo aver installato il driver ODBC sul tuo PC Windows, Windows ti chiede di creare un nome origine dati (DSN) per consentirti di utilizzare il driver ODBC con client ODBC come Excel. Il DSN è una configurazione salvata che contiene le informazioni dell'istanza di Looker e le credenziali di autenticazione.

Utilizzo del connettore Looker-Excel

Una volta soddisfatti i prerequisiti e installato il driver ODBC sul computer, puoi aprire i dati di Looker in Microsoft Excel seguendo questi passaggi:

1. Sul tuo PC Windows, apri l'istanza di Looker in un browser.
2. Apri un'esplorazione ed esegui una query.
3. Fai clic sul menu a forma di ingranaggio di Esplora e seleziona l'opzione Apri in Excel.

4. Nella finestra di dialogo Apri in Excel, seleziona una delle seguenti opzioni per Numero di righe e colonne da includere:

   • Tabella dei risultati corrente: seleziona questa opzione per includere tutte le righe e le colonne presenti nella tabella dei risultati corrente in Esplora. Il numero di righe è limitato dal valore Limite di righe dell'esplorazione.
   • Tutti i risultati: seleziona questa opzione per includere tutti i risultati restituiti dalla query al tuo database. L'opzione Tutti i risultati è in genere disattivata per le query per cui è attivata l'opzione Totali riga o che recuperano dati da un dialetto di database che non può trasmettere i risultati percentuale del totale o che contengono i seguenti tipi di misure: percentuale del precedente o totali parziali. Avviso: anche quando l'opzione Tutti i risultati è disponibile, devi comunque prestare attenzione quando scarichi tutti i risultati. Alcune query sono molto grandi e contengono migliaia o milioni di righe, il che può sovraccaricare la maggior parte dei programmi per fogli di lavoro o persino l'istanza di Looker.
   • Personalizzato: seleziona questa opzione per specificare manualmente il numero di righe e colonne da includere nel download del file ODC.
   • Gli utenti con l'autorizzazione download_without_limit possono inserire una dimensione di riga fino a 100.000 e una dimensione di colonna fino a 200.
   • Gli utenti con l'autorizzazione download_with_limit possono inserire una dimensione di riga fino a 5000 righe e una dimensione di colonna fino a 200.
   • Per gli utenti che non dispongono dell'autorizzazione download_with_limit o download_without_limit, l'opzione Apri in Excel non verrà visualizzata.

5. Nella finestra di dialogo Apri in Excel, fai clic su Scarica. Un file ODC verrà scaricato sul tuo computer.

6. Apri il file ODC con Microsoft Excel.

7. Microsoft Excel presenta un avviso di sicurezza relativo alle connessioni dati bloccate. Fai clic su Abilita per abilitare la connessione dati.

8. Windows visualizza una finestra di dialogo per la configurazione del DSN di Google Looker. Configura il DSN seguendo questi passaggi:

   1. Nel menu a discesa Auth Type (Tipo di autenticazione), seleziona OAuth. Sebbene OAuth sia l'opzione preferita, se necessario puoi selezionare Autenticazione di base. Se selezioni Basic Auth, dovrai inserire le credenziali dell'API Looker. Consulta la sezione Autenticazione tramite autenticazione di base in questa pagina.
   2. Fai clic su Login (Accedi). Si aprirà un browser web che esegue l'autenticazione nel tuo account Looker. Dopo che il browser web mostra un accesso riuscito, chiudilo e torna alla finestra di dialogo DSN.
   3. Fai clic su OK nella finestra di dialogo DSN.
   4. Se richiesto, fai clic su OK per accettare di sovrascrivere il DSN.

Excel esegue la query e inserisce i dati in un nuovo oggetto tabella pivot. Da qui, puoi utilizzare i dati in calcoli e visualizzazioni.

Se vuoi recuperare dati aggiornati, puoi procedere in uno dei seguenti modi:

• Per eseguire nuovamente la stessa query e ottenere i dati più recenti da Looker, fai clic sul pulsante Aggiorna nella barra multifunzione di Excel.
• Per modificare la query, utilizza la UI di Esplora di Looker per aggiornare la query, quindi seleziona l'opzione Esplora Apri in Esplora per scaricare un nuovo file ODC (in altre parole, ricomincia dal passaggio 1 di questa procedura). Per impostazione predefinita, Excel aprirà un nuovo file ODC in una nuova cartella di lavoro di Excel. Se vuoi spostare una tabella pivot da una cartella di lavoro a un'altra, puoi fare clic e trascinare il foglio tra le cartelle di lavoro di Excel oppure puoi copiare e incollare la tabella pivot da una cartella di lavoro all'altra.

Limitazioni

Il connettore Looker-Excel è supportato solo su Windows, non su computer Mac o Linux.

Le seguenti funzionalità di query di Esplora non sono supportate con il connettore Looker-Excel:

• Calcoli tabulari
• Colonne pivot

Se vuoi aprire una query di Esplora in Microsoft Excel, rimuovi i calcoli tabulari e le colonne pivot prima di selezionare Apri in Excel dal menu a forma di ingranaggio di Esplora.

Risoluzione dei problemi

Le sezioni seguenti forniscono informazioni sulle procedure e sugli strumenti di risoluzione dei problemi:

• Aggiunta manuale di un DSN
• Log del programma di installazione
• Esegui l'upgrade di Microsoft Visual C++ Redistributable (MSVC)

Aggiunta manuale di un DSN

Quando apri un file ODC con Excel, Windows ti chiede di creare il DSN. Se devi creare o modificare manualmente il DSN, puoi utilizzare l'amministratore dell'origine dati del driver ODBC di Windows.

Nota: quando utilizzi alcune impostazioni di visualizzazione ad alta risoluzione, potrebbero verificarsi problemi visivi nella scalabilità della finestra di configurazione dell'origine dati all'interno di Excel. Se la finestra di configurazione dell'origine dati all'interno di Excel non è dimensionata correttamente sul display, puoi configurare il DSN utilizzando l'applicazione Origini dati ODBC di Windows integrata in Windows oppure puoi aumentare il fattore di scalabilità sul monitor, che aiuterà a ridimensionare la finestra di configurazione all'interno di Excel.

Per creare o modificare manualmente il DSN, segui questi passaggi:

1. Dal pannello di controllo del tuo PC Windows, apri l'applicazione Origini dati ODBC (prima di Windows 8, questa applicazione si chiamava Amministratore origine dati driver ODBC).
2. Fai clic sul pulsante Aggiungi.
3. Fai doppio clic su Google Looker ODBC Driver.
4. Nella finestra di dialogo Configura DSN di Google Looker, compila i seguenti campi:
   • Nome origine dati^*: (facoltativo) inserisci un nome per l'origine dati per aiutarti a riconoscere questo DSN in futuro.
   • Host: inserisci l'URL dell'istanza di Looker.
   • Porta: inserisci la porta a cui connetterti nell'istanza di Looker. Il valore predefinito è 443.
   • Nel menu a discesa Auth Type (Tipo di autenticazione), seleziona OAuth. Sebbene OAuth sia l'opzione preferita, se necessario puoi selezionare Autenticazione di base. Se selezioni Basic Auth, dovrai inserire le credenziali dell'API Looker. Consulta la sezione Autenticazione tramite autenticazione di base in questa pagina.
5. Fai clic su Login (Accedi). Si aprirà un browser web che esegue l'autenticazione nel tuo account Looker. Dopo che il browser web mostra un accesso riuscito, chiudilo e torna alla finestra di dialogo DSN.
6. Fai clic su Test per verificare la connessione.
7. Fai clic su OK nella finestra di dialogo DSN.
8. Se richiesto, fai clic su OK per accettare di sovrascrivere il DSN.

Autenticazione tramite autenticazione di base

OAuth è il metodo preferito per l'autenticazione su Looker. In alternativa, se selezioni Basic Auth come Auth Type nella finestra di dialogo DSN, puoi eseguire l'autenticazione utilizzando l'ID client e il client secret della chiave API. Per informazioni sulla creazione delle chiavi API, consulta la pagina della documentazione Impostazioni amministratore - Utenti.

Avviso: l'ID client e il client secret vengono archiviati in testo normale, pertanto questo metodo è appropriato solo per ambienti non sensibili, ad esempio per i test.

Log del programma di installazione

Se devi accedere ai log del programma di installazione per risolvere i problemi del connettore Looker-Excel, puoi accedervi nella directory C:\Users\<username>\lookerODBCLogs. I nomi dei log del programma di installazione utilizzano il seguente formato:

  Google_Looker_ODBC_<32/64>-bit_Driver_<timestamp>

Upgrade di Microsoft Visual C++ Redistributable (MSVC)

Il pacchetto Microsoft Visual C++ Redistributable (MSVC) versione 14 viene installato automaticamente se non è già presente.

Se il pacchetto MSVC è già installato, il programma di installazione del driver ODBC di Google Looker non eseguirà l'upgrade. Per utilizzare la versione di MSVC inclusa nel driver, disinstalla il pacchetto MSVC esistente prima di eseguire il programma di installazione.

Dopo aver disinstallato il driver, il pacchetto MSVC rimane installato per supportare altre applicazioni. Puoi disinstallarla manualmente se non ti serve più.