Fogli connessi per Looker consente agli utenti di esplorare in modo interattivo i dati dei modelli LookML tramite 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 poiché Fogli connessi presenta una visualizzazione organizzata del modello con viste, campi e misure, proprio come erano definiti in Looker. I dati di Looker tramite Fogli connessi possono essere utilizzati nei costrutti standard di Fogli, come tabelle pivot, grafici e formule, consentendo una maggiore flessibilità di analisi attraverso costrutti familiari.
Attivazione di Fogli connessi
Per utilizzare Fogli connessi:
- In Looker (originale), l'amministratore di Looker deve attivare il pulsante di attivazione/disattivazione Connettori BI di Looker o Fogli connessi sul riquadro Connettori BI nella sezione Piattaforma del menu Amministrazione di Looker. In Looker (Google Cloud Core), queste opzioni sono abilitate per impostazione predefinita.
- L'istanza di Looker deve essere ospitata su Looker.
- Se è ospitata su Google Cloud, l'istanza di Looker deve eseguire Looker 22.20 o versioni successive. Se l'istanza di Looker non è ospitata su Google Cloud, deve eseguire Looker 23.4 o versioni successive.
- Ogni utente che vuole connettersi alla tua istanza Looker da Fogli Google deve utilizzare nell'account utente Looker lo stesso indirizzo email che utilizza per l'account Google Workspace. Se gli indirizzi email degli account Workspace e Looker sono diversi, riceveranno un errore quando proveranno a connettersi a Looker da Fogli.
- L'accesso ai servizi non controllabili individualmente deve essere attivato nella Console di amministrazione Google Workspace. In genere questa opzione è abilitata per impostazione predefinita. Per ulteriori informazioni, consulta l'articolo del Centro assistenza Gestire l'accesso ai servizi non controllabili individualmente.
Connessione a Looker da Fogli Google
Nel menu Dati di Fogli Google, seleziona Connettori dati e poi Connetti a Looker.
Nella finestra di dialogo Connetti a Looker, inserisci il nome dell'istanza di Looker o seleziona il nome di un'istanza a cui ti sei connesso di recente e seleziona Continua.
Nelle finestre di dialogo seguenti, seleziona il model e l'esplorazione di Looker che vuoi utilizzare per la query, poi seleziona Connetti.
Quando Fogli si connette alla tua istanza Looker, apre un nuovo foglio che mostra la struttura dell'esplorazione selezionata, incluse le visualizzazioni, le dimensioni, le misure e le eventuali descrizioni dei campi aggiunte dallo sviluppatore Looker.
Creazione di query di Looker con Fogli Google
Le query di Looker vengono create utilizzando una tabella pivot di Fogli. Per aggiungere dati di Looker al foglio:
Dal foglio che mostra la tua esplorazione, seleziona Tabella pivot.
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 tabella pivot. Puoi aggiungere righe, colonne, valori e filtri per creare la tua query in base alle dimensioni e alle misure nella tua esplorazione di Looker.
Le righe, le colonne, i valori e i filtri nell'editor pivot corrispondono alle dimensioni e alle misure di Looker nei seguenti modi:
- Le righe equivalgono alle dimensioni di Looker.
- Le colonne equivalgono alle dimensioni sottoposte a pivot di Looker.
- I valori equivalgono alle misure di Looker. Puoi creare una misura personalizzata selezionando una dimensione Looker e una funzione Riepiloga per di Fogli.
- I filtri equivalgono ai filtri di Looker.
L'editor pivot mostra anche un elenco delle visualizzazioni che fanno parte dell'esplorazione, che puoi selezionare per visualizzare le dimensioni e le misure incluse in quella vista.
Seleziona Aggiungi per aggiungere una riga, una colonna, un valore o un filtro. Fogli connessi mostra un elenco delle visualizzazioni disponibili in Esplora. Seleziona il nome di una vista per mostrare l'elenco delle dimensioni e delle misure nella vista, poi seleziona il campo che fornisce i dati per la riga, la colonna, il valore o il filtro.
Dopo aver aggiunto i campi e i filtri di Looker per creare la query, seleziona Applica. Il foglio verrà completato con i dati dell'istanza Looker.
Dopo aver aggiunto i dati di Looker a una tabella pivot, puoi utilizzare la normale funzionalità di Fogli Google per formattare i dati o creare nuove formule di Fogli basate sui tuoi dati di Looker.
Opzioni di filtro
Dalla release iniziale di Fogli connessi per Looker, sono state aggiunte nuove opzioni di filtro.
Filtra per valore - Aggiunta ad agosto 2023
È possibile filtrare le dimensioni di Looker in Fogli connessi per le tabelle pivot di Looker visualizzando un elenco di valori e selezionando e deselezionando i valori di interesse. In precedenza, dovevi digitare manualmente i valori del filtro quando veniva applicato un filtro in base a una condizione.
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à da Looker i 500 valori più frequenti.
Puoi quindi cercare tra gli elementi, scegliere di selezionare o cancellare tutti gli elementi oppure di ordinarli in base alla frequenza o in ordine alfabetico. Se fai clic su OK in basso, in Fogli vengono memorizzate le tue scelte. Puoi quindi fare clic su Applica per aggiornare la tabella pivot come di consueto, con il nuovo filtro applicato.
Filtri che utilizzano le espressioni di filtro di Looker - aggiunti a settembre 2023
In Fogli connessi puoi applicare filtri di data relativi, oltre a molti altri filtri avanzati, 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:
Aggiungi un campo alla sezione dei filtri della tabella pivot.
Fai clic sul menu a discesa Stato per visualizzare le opzioni di filtro e seleziona Espressione di filtro.
Inserisci un'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".
Fai clic su OK.
Oltre al filtro della data relativa, ora è possibile applicare altri filtri, ad esempio:
- 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 relativa alle espressioni di filtro di Looker.
Utilizzo dei parametri di Looker e dei campi di solo filtro (aggiunta a ottobre 2023)
Ora in Fogli connessi puoi utilizzare parametri e campi solo filtro.
I campi e i parametri solo filtro verranno visualizzati nella sezione CAMPI SOLO FILTRI del selettore campi in Fogli, proprio come in Looker. Per utilizzarle, segui questi passaggi:
- Aggiungi o trascina i parametri selezionati e i campi di solo filtro nella sezione Filtri, proprio come faresti per filtrare in base a una dimensione o una misura.
- Per i parametri con valori consentiti, questi valori verranno visualizzati in un menu a discesa nella finestra di dialogo Filtra per condizione.
- Per i campi solo filtro, puoi utilizzare la normale finestra di dialogo Filtra per condizione. Se il campo contiene suggerimenti definiti nel modello Looker, puoi utilizzare anche la funzionalità Filtra per valore.
Aggiornamento dei dati in Fogli Google
I dati della tabella pivot sono statici, ma possono essere aggiornati in qualsiasi momento. Se aggiorni i dati, Looker eseguirà una query sul database e aggiornerà la tabella pivot con i dati più recenti.
Sia la tabella pivot sia il foglio che mostra la tua esplorazione mostrano la data e l'ora dell'ultimo aggiornamento.
Seleziona Aggiorna per aggiornare i dati nella tabella pivot.
Pianificare tempi 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 da includere 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 utilizzando il gruppo di campi Proprietà client dell'API Query nell'esplorazione della cronologia delle attività del sistema. Viene creata una voce nell'esplorazione della cronologia ogni volta che viene eseguita una nuova query.
Nel gruppo di campi Proprietà client dell'API Query sono presenti tre nuovi campi per Fogli connessi:
- Nome client API: questo campo mostrerà sempre
Connected Sheetsper identificare le voci di Fogli connessi. - ID foglio di lavoro Fogli connessi: questo campo mostra l'ID del foglio, che è incluso nell'URL di Fogli Google per quel foglio.
- Attivatore 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
Aspetti da tenere presenti
- La sensibilità alle maiuscole per i dati mostrati nella tabella pivot è determinata dall'impostazione relativa alla 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 come Visualizzatore al foglio 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. Ciò include l'accesso al modello su cui si basa la tabella pivot, le autorizzazioni per visualizzare i dati e l'accesso corretto ai dati tramite qualsiasi filtro di accesso o concessione 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 per le dimensioni dei dati. Anche le query che restituiscono troppi dati generano un errore.
Se visualizzi uno di questi errori, ti consigliamo di aggiungere filtri o di utilizzare meno dimensioni e/o meno granulari nella query.
Risolvere i problemi relativi a Fogli connessi
Potresti riscontrare alcuni problemi quando provi a connetterti 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 Looker è stato inserito in modo errato. In questo caso, verifica il nome dell'istanza Looker e riprova a connetterti.
- Fogli non può connettersi all'API Looker. Questo può accadere se la tua istanza di Looker non utilizza l'URL dell'host dell'API predefinito. Per risolvere il problema, lascia vuoto il campo URL host API nel pannello di amministrazione dell'API.
Errore: l'istanza di Looker non è configurata per l'utilizzo di questa funzionalità. Contatta l'amministratore di Looker per assicurarti che l'account sia idoneo.
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 connessi.
- Stai tentando di connetterti a un'istanza di Looker non ospitata da Looker. Connettiti a un'altra istanza Looker ospitata da Looker.
Nessun modello visualizzato dopo la connessione a un'istanza di Looker
Questo indica che non hai le autorizzazioni necessarie per visualizzare i modelli nella tua istanza.
Un utente Looker con il ruolo Visualizzatore non dispone di autorizzazioni sufficienti per creare connessioni in Fogli, in quanto non dispone di autorizzazioni sufficienti per utilizzare l'interfaccia utente Esplora 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 Looker che utilizza il tuo indirizzo email Google attuale.
Errore: richiesta errata: nessun client di abilitazione trovato.
Questo errore indica che il connettore Fogli connessi non è stato attivato. Un amministratore di Looker deve abilitare il pulsante di attivazione/disattivazione Connettori BI di Looker o Fogli connessi sul riquadro Connettori BI nella sezione Piattaforma del menu Amministrazione di Looker.
Errore: 403 Accesso negato
Se per la tua istanza di Looker è stata configurata una lista consentita IP, la lista consentita 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 viene visualizzato l'errore Indirizzo IP non nella lista consentita.