Utilizzare Fogli connessi per Looker

Nota: questa pagina fa parte della serie di tutorial Recupero dei dati e creazione di grafici.

Fogli connessi per Looker consente agli utenti di esplorare in modo interattivo i dati dei modelli LookML attraverso la nota interfaccia dei fogli di lavoro di Fogli Google. Gli utenti di Fogli avranno accesso ai dati regolati da oltre 50 database supportati da Looker. L'esplorazione è intuitiva perché Fogli connessi presenta una visualizzazione organizzata del modello con visualizzazioni, campi e misure così come sono stati definiti in Looker. I dati di Looker tramite Fogli connessi possono essere utilizzati in strutture di Fogli standard, come tabelle pivot, grafici e formule, consentendo una maggiore flessibilità di analisi tramite strutture familiari.

Nota: Fogli connessi per Looker è disponibile solo per le istanze ospitate da Looker.

Attivare Fogli connessi

Per utilizzare Fogli connessi:

• In Looker (originale), l'amministratore di Looker deve attivare l'opzione Tutti i connettori BI di Looker o Fogli connessi nel riquadro dei connettori BI nella sezione Piattaforma del menu Amministratore di Looker. In Looker (Google Cloud core), queste opzioni sono abilitate per impostazione predefinita.
• L'istanza di Looker deve essere ospitata da Looker.
• Se l'istanza è ospitata su Google Cloud, deve essere in esecuzione Looker 22.20 o versioni successive. Se la tua istanza di Looker non è ospitata su Google Cloud, deve eseguire Looker 23.4 o versioni successive.
• Ogni utente che vuole connettersi alla tua istanza di Looker da Fogli Google deve utilizzare nel proprio account utente Looker lo stesso indirizzo email che usa per il proprio account Google Workspace. Se gli indirizzi email degli account Google Workspace e Looker sono diversi, l'utente riceverà un messaggio di errore quando tenta di connettersi a Looker da Fogli.
• L'accesso ai servizi non controllabili singolarmente deve essere attivato nella Console di amministrazione Google Workspace. In genere questa opzione è attiva per impostazione predefinita. Per saperne di più, consulta l'articolo del Centro assistenza Gestire l'accesso ai servizi non controllabili individualmente.

Connessione a Looker da Fogli Google

1. Nel menu Dati di Fogli Google, seleziona Connettori di dati e poi Connetti a Looker.

2. Nella finestra di dialogo Connetti a Looker, inserisci il nome della tua istanza di Looker o seleziona il nome di un'istanza a cui hai eseguito di recente il collegamento e seleziona Continua.

   Nota: la prima volta che ti colleghi a un'istanza di Looker da Fogli Google, ti verrà chiesto di collegare i tuoi account Google e Looker. Puoi scollegare i tuoi account in qualsiasi momento. Per ulteriori informazioni sul collegamento dell'Account Google, leggi l'articolo del Centro assistenza Gestire gli account di terze parti collegati a Google.

3. Nelle finestre di dialogo seguenti, seleziona il modello e l'esplorazione di Looker che vuoi utilizzare per la query e seleziona Connetti.

Quando Fogli si connette all'istanza di Looker, apre un nuovo foglio che mostra la struttura dell'esplorazione selezionata, incluse visualizzazioni, dimensioni, misure e eventuali descrizioni dei campi aggiunte dallo sviluppatore di Looker.

Creazione di query di Looker utilizzando Fogli Google

Le query di Looker vengono create utilizzando una tabella pivot di Fogli. Per aggiungere dati di Looker al foglio:

1. Nel foglio che mostra l'esplorazione, seleziona Tabella pivot.

2. Scegli se inserire una nuova tabella pivot in un nuovo foglio o in un foglio esistente e seleziona Crea.

   Viene creata una nuova tabella pivot vuota e si apre la finestra Editor di tabelle pivot. Puoi aggiungere righe, colonne, valori e filtri per creare la tua query in base alle dimensioni e alle misure nell'esplorazione di Looker.

   

   Le righe, le colonne, i valori e i filtri nell'editor pivot sono equivalenti alle dimensioni e alle misure di Looker nei seguenti modi:

   • Le righe sono equivalenti alle dimensioni di Looker.
   • Le colonne equivalgono alle dimensioni pivot di Looker.
   • I valori sono equivalenti alle misure di Looker. Puoi creare una misura personalizzata selezionando una dimensione Looker e una funzione Riepiloga in base a di Fogli.
   • I filtri sono equivalenti ai filtri di Looker.

   L'editor pivot mostra anche un elenco delle viste che fanno parte della tua esplorazione, che puoi selezionare per visualizzare le dimensioni e le misure incluse in quella visualizzazione.

3. Seleziona Aggiungi per aggiungere una riga, una colonna, un valore o un filtro. Fogli connessi mostra un elenco delle visualizzazioni disponibili in Esplora. Seleziona un nome di visualizzazione per visualizzare l'elenco delle dimensioni e delle misure nella visualizzazione, quindi seleziona il campo che fornisce i dati per la riga, la colonna, il valore o il filtro.

4. Dopo aver aggiunto i campi e i filtri di Looker per creare la query, seleziona Applica. Il foglio verrà compilato con i dati dell'istanza Looker.

   

Dopo aver aggiunto i dati di Looker a una tabella pivot, puoi utilizzare Fogli Google per formattarli o creare nuove formule di Fogli in base ai dati di Looker.

Opzioni di filtro

Dalla versione iniziale di Fogli connessi per Looker sono state aggiunte nuove opzioni di filtro.

Suggerimento: per filtrare le date relative, consulta la sezione Filtri che utilizzano le espressioni di filtro di Looker più avanti in questo documento.

Filtra per valore: aggiunto ad agosto 2023

È possibile filtrare le dimensioni di Looker nelle tabelle pivot di Fogli connessi per Looker visualizzando un elenco di valori e selezionando e deselezionando i valori di interesse. In precedenza, quando si utilizzava il filtro in base a una condizione, era necessario digitare manualmente i valori del filtro.

Per utilizzare questa funzionalità, aggiungi un campo alla sezione Filtri della tabella pivot e fai clic sul menu a discesa Stato per aprire le opzioni di filtro. Poi, fai clic su Aggiungi filtro:

Si aprirà una barra laterale e Fogli recupererà i 500 valori più frequenti da Looker.

Puoi quindi cercare tra gli elementi, scegliere di selezionarli o annullarne la selezione tutti oppure ordinarli in base alla frequenza o in ordine alfabetico. Se fai clic su OK in basso, Fogli memorizzerà le tue scelte. A questo punto, puoi fare clic su Applica per aggiornare la tabella pivot come di consueto, con il nuovo filtro applicato.

Filtri che utilizzano espressioni di filtro di Looker (aggiunto a settembre 2023)

Puoi applicare filtri di date relative, oltre a molti altri filtri avanzati, in Fogli connessi utilizzando le espressioni di filtro di Looker. Ad esempio, in Fogli connessi puoi applicare filtri come "è negli ultimi 30 minuti" o "è negli ultimi 10 giorni".

Per utilizzare le espressioni di filtro di Looker:

1. Aggiungi un campo alla sezione dei filtri della tabella pivot.

2. Fai clic sul menu a discesa Stato per visualizzare le opzioni di filtro e seleziona Espressione di filtro.

   

3. Inserisci qualsiasi espressione di filtro di Looker nel campo Valore.

   

   Ad esempio, per filtrare in base agli ultimi 7 giorni, puoi scrivere "7 giorni" o "ultimi 7 giorni".

4. Fai clic su OK.

Oltre al filtro della data relativa, altri esempi di filtri che ora sono possibili includono:

• Una stringa che non inizia con: -FOO%
• Un intervallo numerico inclusivo ed esclusivo: (12, 20]

Per visualizzare tutte le espressioni di filtro disponibili, consulta la pagina della documentazione Espressioni di filtro di Looker.

Utilizzo dei parametri e dei campi con solo filtri di Looker (aggiunto a ottobre 2023)

Ora puoi utilizzare parametri e campi con solo filtri in Fogli connessi.

I campi e i parametri con solo filtri verranno visualizzati nella sezione CAMPI SOLO CON FILTRI del selettore campi di Fogli, proprio come in Looker. Per utilizzarli, segui questi passaggi:

1. Aggiungi o trascina i parametri e i campi con solo filtri selezionati nella sezione Filtri, proprio come faresti per filtrare in base a una dimensione o una misura.
2. Per i parametri con valori consentiti, questi valori verranno visualizzati in un menu a discesa nella finestra di dialogo Filtra per condizione.
3. Per i campi con solo filtri, puoi utilizzare la normale finestra di dialogo Filtra per condizione. Se il campo ha suggerimenti definiti nel modello Looker, puoi utilizzare anche la funzionalità di filtro per valore.

Aggiornare i dati in Fogli Google

I dati nella tabella pivot sono statici, ma possono essere aggiornati in qualsiasi momento. Se aggiorni i dati, Looker eseguirà una query sul tuo database e aggiornerà la tabella pivot con i dati più recenti.

Nota: per migliorare le prestazioni, Looker memorizza i risultati delle query in una cache in base al criterio di memorizzazione nella cache definito nel modello. Quando aggiorni i dati da Fogli Google, i dati restituiti potrebbero provenire dalla cache di Looker. Se la cache di Looker non è scaduta dall'aggiornamento più recente di Fogli Google, l'aggiornamento di Fogli Google potrebbe restituire gli stessi dati.

Sia la tabella pivot sia il foglio che mostra l'esplorazione mostrano l'ora dell'ultimo aggiornamento.

Seleziona Aggiorna per aggiornare i dati della tabella pivot.

Pianificare orari di aggiornamento regolari

Per pianificare gli aggiornamenti automatici dei dati, seleziona il menu con tre puntini nella tabella pivot, quindi seleziona Opzioni di aggiornamento oppure seleziona Opzioni di aggiornamento nel foglio Esplora. Looker mostra la finestra di dialogo Aggiornamento pianificato.

Modifica delle impostazioni della tabella pivot

Per modificare le righe, le colonne, i valori o i filtri inclusi nella tabella pivot, seleziona l'icona a forma di matita accanto al menu con tre puntini per aprire il riquadro dell'editor della tabella pivot.

Monitoraggio di Fogli connessi

Un amministratore di Looker può visualizzare l'utilizzo di Fogli connessi tramite il gruppo di campi Proprietà client dell'API Query nell'esplorazione della cronologia delle attività del sistema. Ogni volta che viene eseguita una nuova query, viene creata una voce nell'esplorazione della cronologia.

Nel gruppo di campi Proprietà client dell'API di query sono presenti tre nuovi campi per Fogli collegati:

• Nome client API: questo campo mostrerà sempre Connected Sheets per identificare le voci Fogli connessi.
• ID foglio di lavoro Fogli connessi: questo campo mostra l'ID del foglio, incluso nell'URL di Fogli Google.
• Trigger di Fogli connessi: questo campo mostra se la query è stata attivata da un utente che ha selezionato il pulsante Aggiorna in Fogli o da un aggiornamento pianificato.

Di seguito è riportato un esempio di URL di attività di sistema che mostra l'utilizzo di Fogli connessi. Sostituisci <instance_name.looker.com> con l'URL dell'istanza.

https://<instance_name.looker.com>/explore/system__activity/history?fields=query_api_client_context.name,query_api_client_context.cs_spreadsheet_id,query_api_client_context.cs_trigger,user.name,history.created_date,history.created_time_of_day&f[query_api_client_context.cs_spreadsheet_id]=-NULL&sorts=history.created_time_of_day+desc&limit=5000

Assistenza per l'API Fogli connessi

Il supporto API per Fogli connessi per Looker è accessibile tramite le API di AppsScript e Fogli Google.

Di seguito sono riportate alcune delle cose che puoi fare in modo programmatico con il supporto delle API:

• Aggiornamento automatico dei dati: puoi pianificare aggiornamenti regolari dei fogli di lavoro basati su Looker per assicurarti di utilizzare le informazioni più recenti.
• Flussi di lavoro personalizzati: puoi creare procedure complesse che incorporano i dati di Looker nei flussi di lavoro di Fogli Google esistenti.
• Integrazione con altre applicazioni: puoi connettere i dati Looker a strumenti e servizi esterni utilizzando le API AppsScript o Fogli Google.

Per specificare Looker come origine dati con l'API Google Sheets, utilizza l'oggetto looker con la risorsa REST DataSourceSpec.

Aspetti da tenere presenti

• La sensibilità alle maiuscole per i dati mostrati nella tabella pivot è determinata dall'impostazione di sensibilità alle maiuscole per il modello. I filtri nella tabella pivot, tuttavia, forzano l'insensibilità alle maiuscole nelle situazioni in cui il filtro non fa distinzione tra maiuscole e minuscole per i dati nativi di Fogli.
• Chiunque abbia accesso al foglio come Visualizzatore potrà visualizzare i dati memorizzati nella cache in una tabella pivot.
• Oltre all'accesso come Editor al foglio, tutti gli utenti che devono modificare o aggiornare la tabella pivot dovranno disporre delle autorizzazioni corrette in Looker per accedere al modello dei dati. Sono inclusi l'accesso al modello su cui si basa la tabella pivot, le autorizzazioni per visualizzare i dati e l'accesso corretto ai dati tramite eventuali filtri di accesso o concessioni di accesso.
• Se l'utente esegue l'autenticazione con OAuth in un database BigQuery, potrebbe essere necessario concedere le autorizzazioni per il database sottostante.

Limiti di righe e dati di Fogli connessi

Le query create con Fogli connessi hanno un limite massimo di 30.000 righe. Se il risultato della query contiene più righe, Fogli mostrerà un errore all'utente. Se l'utente non dispone dell'autorizzazione download_without_limit, il risultato verrà troncato a un massimo di 5000 righe, indipendentemente dal limite di Fogli.

Inoltre, le query di Fogli connessi sono soggette a un limite di dimensioni dei dati. Anche le query che restituiscono troppi dati generano un errore.

Se riscontri uno di questi errori, valuta la possibilità di aggiungere filtri o di utilizzare nella query un numero inferiore di dimensioni e/o meno granulari.

Risoluzione dei problemi di Fogli connessi

Potresti riscontrare alcuni problemi quando cerchi di collegarti a Looker da Fogli Google. Questa sezione descrive questi problemi e come risolverli.

Errore: si è verificato un errore durante la connessione all'istanza di Looker. Riprova. Se il problema persiste, invia un feedback.

Questo errore può verificarsi per diversi motivi:

• Il nome dell'istanza di Looker è stato inserito in modo errato. In questo caso, verifica il nome dell'istanza Looker e riprova a connetterti.
• Fogli non riesce a connettersi all'API Looker. Questo può verificarsi se l'istanza di Looker non utilizza l'URL dell'host dell'API predefinito. Per risolvere il problema, lascia vuoto il campo API Host URL nel pannello di amministrazione dell'API.

Errore: l'istanza di Looker non è configurata per utilizzare questa funzionalità. Contatta l'amministratore di Looker per verificare che sia idonea.

Questo errore può verificarsi per diversi motivi:

• Stai tentando di connetterti a un'istanza Looker appena creata. Potrebbero essere necessarie fino a 24 ore prima che una nuova istanza di Looker sia disponibile in Fogli collegati.
• Stai tentando di connetterti a un'istanza di Looker non ospitata da Looker. Collegarti a un'altra istanza di Looker ospitata da Looker.

Nessun modello viene visualizzato dopo la connessione a un'istanza di Looker

Ciò indica che non disponi delle autorizzazioni necessarie per visualizzare i modelli nella tua istanza.

Un utente Looker con il ruolo Visualizzatore non dispone delle autorizzazioni sufficienti per creare connessioni in Fogli, così come non dispone di autorizzazioni sufficienti per utilizzare l'UI di esplorazione in Looker. Se l'utente vuole utilizzare Fogli connessi per Looker, deve disporre dell'autorizzazione explore. I ruoli Amministratore, Sviluppatore e Utente includono l'autorizzazione explore. Un amministratore di Looker può concedere all'utente l'autorizzazione explore, che dovrebbe consentire all'utente di visualizzare i modelli nell'istanza.

Errore: l'indirizzo email del tuo account Looker collegato è diverso dall'indirizzo email del tuo Account Google.

Questo indica che l'indirizzo email del tuo account Looker non corrisponde a quello utilizzato con il tuo Account Google. Assicurati di aver eseguito l'accesso a un Account Google con un indirizzo email corrispondente a quello del tuo account Looker. In alternativa, un amministratore di Looker può creare un nuovo account utente di Looker che utilizzi il tuo attuale indirizzo email Google.

Errore: richiesta non valida: nessun client di abilitazione trovato.

Questo errore indica che il connettore Fogli connessi non è stato attivato. Un amministratore di Looker deve attivare l'opzione Tutti i connettori BI di Looker o l'opzione di attivazione/disattivazione Fogli connessi nel pannello Connettori BI della sezione Piattaforma del menu Amministrazione di Looker.

Errore: 403 accesso negato

Se per la tua istanza di Looker è configurata una lista consentita IP, questa può impedire a Fogli di connettersi all'API Looker. Per determinare se la causa è la lista consentita, prova ad accedere all'URL dell'istanza di Looker per vedere se ricevi l'errore Indirizzo IP non presente nella lista consentita.