Download di contenuti

Questa pagina descrive il download dei contenuti (visualizzazioni o dati) da Looker.

Per scaricare contenuti, devi ottenere l'autorizzazione download_with_limit o download_without_limit da un amministratore di Looker.

La procedura e le opzioni di download e formattazione dei contenuti scaricati variano a seconda che il download sia effettuato da un Look o da un'esplorazione, da una dashboard o da una query dei risultati uniti.

Download di dati da un Look o da un'esplorazione

Per scaricare i dati da una pagina di tipo Look o Explore (Esplora), fai clic sul menu a forma di ingranaggio in alto a destra e seleziona Download (Scarica).

Si apre una finestra Download in cui puoi denominare e formattare il download:

Nelle sezioni che seguono vengono illustrati tutti i campi della finestra Download:

Formati file

I download in formato che utilizzano il renderer (PNG e PDF) utilizzeranno i risultati della modalità produzione. Se scarichi i dati in un formato diverso, i risultati del download vengono visualizzati nella modalità in cui ti trovi al momento, ovvero sviluppo o produzione.

I dati possono essere scaricati da Look ed esplorazioni, nei formati seguenti:

  • TXT (valori delimitati da tabulazioni)
  • Foglio di calcolo di Excel (Excel 2007 o versione successiva)
  • CSV
  • JSON
  • HTML
  • Markdown
  • PNG (immagine di visualizzazione)

Quando scegli il formato dei dati per il download, se non vedi le opzioni HTML o PNG (immagine di visualizzazione) per i Look, chiedi all'amministratore di Looker di installare la versione appropriata del renderer Chromium per la tua istanza di Looker.

Per il formato JSON, Looker utilizza campi di tipo labels come valore visualizzato nell'output JSON. Per ulteriori informazioni sul modo in cui Looker visualizza i campi in formato JSON, leggi il post della scheda Community relativo alla modifica della formattazione JSON.

Le tabelle trasposte vengono visualizzate solo nei download PNG.

Per gli sviluppatori di Looker, se è attiva la modalità di sviluppo, il download dei dati nella maggior parte dei formati di file esegue query sul modello così com'è in modalità di sviluppo. I formati di file PDF e PNG fanno eccezione, perché i download di dati in tali formati interrogano sempre il modello così come appare in modalità Production (Produzione).

Risultati

Nella sezione Risultati, scegli se applicare le impostazioni di visualizzazione al tuo download di dati:

  • Se scegli Con le opzioni di visualizzazione applicate, Looker applica alcune impostazioni di visualizzazione al download. Le seguenti impostazioni dei menu Traccia, Serie e Formattazione configurate per la visualizzazione vengono applicate al download dei dati:

    La formattazione condizionale viene visualizzata nelle pubblicazioni di Excel di visualizzazioni ed esplorazioni con visualizzazioni del grafico a tabella solo se viene applicata la regola Along a scale (Regola su una scala).

    Alcune impostazioni di visualizzazione non vengono applicate ai risultati scaricati. Ecco alcuni esempi:

    • Il colore di testo dell'intestazione personalizzata e il colore di sfondo non vengono applicati ai risultati scaricati, ad eccezione dei file PNG.
    • Per le tabelle dei risultati con pivot e più misurazioni, ogni valore pivot viene ripetuto tra le colonne anziché essere rappresentato come un'unica colonna unita. I download HTML e PNG fanno eccezione, pertanto la colonna unita viene preservata.
    • Quando scarichi da una dashboard, il titolo del riquadro non viene incluso nei risultati scaricati.
    • I valori Totali e Righe totali sono inclusi nei risultati scaricati, ma le rispettive righe e colonne non presentano etichetta.

    Le query nei grafici a tabella che sono state riordinate manualmente vengono visualizzate nel loro ordine originale nel download se la query include uno dei seguenti elementi:

  • Se scegli Come mostrato nella tabella dati, le opzioni di visualizzazione non vengono applicate e il download ha lo stesso aspetto della tabella dati nella sezione Dati del Look o dell'esplorazione.

Valori

Nella sezione Valori, scegli come vuoi che vengano visualizzati i risultati della query scaricati:

  • Se scegli Non formattato, Looker non applicherà alcuna formattazione speciale ai risultati della query, come l'arrotondamento dei numeri lunghi o l'aggiunta di caratteri speciali previsti dagli sviluppatori di Looker. Questa è in genere l'opzione preferita per i dati che devono essere inviati a un altro strumento per l'elaborazione.
  • Se scegli Formattati, i dati appaiono più simili all'esperienza Esplora in Looker, anche se alcune funzionalità (come il collegamento) non sono supportate da tutti i tipi di file. Ad esempio, la formattazione applicata con il parametro html non verrà applicata ai download di TXT, CSV, Excel o JSON.

Limiti

Puoi scegliere la quantità di dati da scaricare, come segue:

  • Risultati nella tabella: il numero di righe specificato dal limite di righe dei contenuti.
  • Tutti i risultati: tutti i risultati restituiti dalla query. Prima di selezionare questa opzione, consulta la sezione Tutti i risultati di questa pagina.
  • Personalizzato: un numero personalizzato di righe. Gli utenti con autorizzazioni per download_with_limit sono limitati a 5000 righe. Il limite per gli altri utenti è in genere 100.000,a meno che il tuo amministratore Looker non abbia aumentato questo limite (vedi Funzionalità precedente: Autorizzazione dei download illimitati (Looker 4.14+) post della scheda Community.

Tutti i risultati

Quando fai clic su Run (Esegui) in un look o su un'esplorazione, Looker controlla le tue autorizzazioni e determina se la complessità della query e del dialetto del database consentono di scaricare l'intera query. Se disponi delle autorizzazioni (per i risultati che superano un limite impostato) e Looker stabilisce che è possibile scaricare l'intera query, l'opzione Tutti i risultati sarà disponibile nella finestra Scarica.

L'opzione Tutti i risultati è generalmente disattivata per le query che:

Anche se l'opzione Tutti i risultati è disponibile, devi comunque prestare attenzione quando scarichi tutti i risultati. Alcune query sono molto grandi, contengono migliaia o milioni di righe, che possono sovraccaricare la maggior parte dei programmi per fogli di lavoro o persino la tua istanza di Looker.

Se l'opzione Tutti i risultati non è disponibile, puoi utilizzare l'opzione Personalizzato per specificare il numero massimo di righe consentite con le tue autorizzazioni.

Risultati delle query in streaming

Per flussi si intende la capacità di Looker di elaborare i dati in blocchi, anziché tutti contemporaneamente. Se Looker può trasmettere in streaming un set di risultati, sono possibili download illimitati.

Looker trasmette i risultati scaricati in tutti i formati tranne in quelli visualizzati (HTML, PNG).

Oltre ai limiti di formato, ci sono due casi in cui lo streaming non è possibile:

  1. Calcoli della tabella: i calcoli tabulari non possono essere inviati in streaming. Per scaricare risultati illimitati per una query, devi quindi rimuovere i calcoli tabulari dalla query.
  2. Limitazioni dei database: alcuni database non possono eseguire il flusso se nella query sono inclusi pivot. Per questi database, devi rimuovere i pivot per scaricare risultati illimitati. Alcuni database non possono trasmettere in streaming alcun risultato, il che significa che non è possibile eseguire download illimitati. Di seguito è riportato un elenco di database che supportano lo streaming e un elenco di database che supportano lo streaming con pivot applicati:

Rimuovi tutti gli ordinamenti dalla query

Quando selezioni Tutti i risultati, potresti anche visualizzare l'opzione Rimuovi tutti i tipi dalla query. Questa opzione impedisce l'ordinamento della query prima di scaricare i risultati. La selezione di questa opzione può velocizzare il download, poiché ordinare una query può essere costoso per le prestazioni di determinati tipi di database.

L'opzione Rimuovi tutti gli ordini dalla query non è supportata per i risultati pivot.

Consenti risultati di grandi dimensioni

Quando scarichi un set di risultati di grandi dimensioni in Looker utilizzando Google BigQuery come dialetto del database e selezioni Tutti i risultati, potresti vedere l'opzione Consenti risultati di grandi dimensioni. Questo perché Google BigQuery ha una dimensione massima di risposta per i risultati delle query, come descritto nell'argomento della documentazione relativo alla scrittura dei risultati delle query di Google Cloud. Per scaricare risultati che superano le dimensioni massime di risposta di BigQuery, Looker deve eseguire un processo diverso.

Se selezioni Consenti risultati di grandi dimensioni, la procedura di download influenza quanto segue:

  • L'opzione allowLargeResults BigQuery è impostata su true per la query.
  • Le clausole ORDER BY nella query sono state rimosse.
  • La query scriverà in uno schema temporaneo PDT e richiederà l'autorizzazione per la scrittura in uno.
  • I risultati della query vengono memorizzati in questo schema temporaneo temporaneo sotto un nome tabella casuale per un'ora.

Nome del file

Puoi inserire un nome file per il download o utilizzare il nome file predefinito che viene precompilato nel campo. Looker aggiungerà automaticamente l'estensione del file appropriata in base alla selezione nel campo Formato file.

Scarica o apri nel browser

Dopo aver selezionato le opzioni, puoi fare clic sul pulsante Scarica per scaricare un file sul computer, oppure fare clic su Apri nel browser per visualizzare il file nel browser.

Download dei dati da una query dei risultati uniti

Per scaricare le query dei risultati uniti, puoi salvarle in una dashboard e poi scaricarle come PDF o come raccolta di file CSV. Devi però scaricare l'intera dashboard: non puoi scaricare i dati da un solo riquadro basato su una query dei risultati uniti.

Scaricare i dati da una dashboard

Per scaricare l'intera dashboard, seleziona Scarica dal menu con tre puntini.

Viene visualizzata una finestra di dialogo che ti consente di selezionare PDF o CSV come formato di download.

Scaricare una dashboard in formato PDF

I download di PDF potrebbero non corrispondere esattamente al layout o alle dimensioni della dashboard visualizzati in Looker.

Puoi scaricare l'intera dashboard in formato PDF, il che significa che riceverai un PDF che mostra il titolo della dashboard, eventuali filtri della dashboard, alcuni o tutti i riquadri della dashboard e il fuso orario in cui è stata eseguita la dashboard. Il PDF include anche un timestamp che mostra quando è stata scaricata la dashboard.

I download in formato PDF restituiscono sempre i dati dal modello così come sono in modalità Produzione, anche se sei in modalità Sviluppo.

Per scaricare una dashboard in formato PDF, segui questi passaggi:

  1. Seleziona PDF dal menu a discesa Formato.

  2. Seleziona un'opzione dal menu a discesa Formato carta:

    L'opzione Adatta la pagina alla dashboard è l'impostazione predefinita e ridimensiona il PDF alla larghezza predefinita delle dashboard (1260 px). Altre opzioni per il formato carta si adattano al PDF in modo che corrisponda a un formato carta standard e che si adatti completamente o parzialmente al pannello al suo interno. A seconda del layout della dashboard e del formato della carta selezionato, alcuni output PDF potrebbero differire dal layout della dashboard quando vengono visualizzati in Looker. Ad esempio, quando il formato carta selezionato è inferiore a quello della dashboard, potresti riscontrare problemi di spaziatura o di altra formattazione e devi apportare alcune modifiche:

    • Grandi visualizzazioni o gruppi di riquadri sovrapposti potrebbero dover essere ridimensionati per essere adattati al PDF.
    • I riquadri che contengono tabelle potrebbero non mostrare tutte le colonne della tabella nel PDF.
    • Le schede potrebbero essere ridotte di larghezza per adattarsi al PDF. Analogamente, i riquadri che richiedono lo scorrimento nell'app Looker potrebbero non espandersi per visualizzare tutti i contenuti.



      Se non vedi l'opzione Formato carta, chiedi all'amministratore di Looker di installare la versione più recente del renderer Chromium per la tua istanza di Looker.

  3. Se selezioni un valore diverso da Adatta la pagina alla dashboard nel menu a discesa Formato carta, viene visualizzata l'opzione Orientamento. Puoi scegliere di orientare la dashboard in posizione verticale o orizzontale.

  4. Seleziona o lascia deselezionato Espandi le tabelle per visualizzare tutte le righe. Se selezioni questa opzione, per i riquadri della dashboard che utilizzano visualizzazioni tabella, il PDF mostrerà tutte le righe disponibili nella visualizzazione tabella, non solo le righe visibili nella miniatura del riquadro della dashboard. Se non selezioni questa opzione, nel PDF verranno visualizzate solo le righe visibili nella miniatura senza scorrimento. I filtri della dashboard e delle query continueranno a essere applicati, così come le impostazioni di visualizzazione, come i limiti di righe e i limiti di colonna, nonché le impostazioni configurate con l'opzione Limita righe visualizzate.

    Se l'opzione Espandi le tabelle per mostrare tutte le righe è selezionata, i riquadri della dashboard che contengono visualizzazioni di tabella potrebbero avere un aspetto leggermente diverso nei PDF scaricati rispetto a Looker. Nel PDF sono visibili le seguenti differenze:

    • Le personalizzazioni relative ai colori dello sfondo e alle dimensioni del carattere vengono rimosse dalle intestazioni delle colonne e dalle righe del totale parziale.
    • Le tabelle sono visualizzate nel tema bianco.
    • L'icona di ordinamento non viene visualizzata nelle tabelle pivot che non sono state ordinate manualmente.
    • Le tabelle con le dimensioni Adatta le colonne si estendono fino all'intera larghezza del riquadro.

    Inoltre, per le tabelle con più di 20.000 celle, nel PDF potrebbero essere presenti le seguenti differenze:

    Se non visualizzi l'opzione Espandi le tabelle per visualizzare tutte le righe, chiedi all'amministratore di Looker di installare la versione appropriata del renderer Chromium per la tua istanza di Looker.

  5. Seleziona o lascia deselezionati Disponi i riquadri della dashboard in una singola colonna. Se selezioni questa opzione, il PDF mostra i riquadri della dashboard in un'unica colonna verticale. Se non selezioni questa opzione, i riquadri della dashboard vengono visualizzati così come sono disposti nella dashboard.

  6. Fai clic su Apri nel browser per visualizzare un'immagine del PDF in una nuova scheda del browser. Da qui, puoi scegliere di scaricare il PDF utilizzando i controlli del browser.

  7. Fai clic su Annulla se non vuoi più scaricare la dashboard.

  8. Fai clic su Scarica per avviare il download. Si aprirà una nuova scheda del browser, in cui è mostrato lo stato del download.

Se l'amministratore di Looker ha abilitato la funzionalità Labs Esegui il rendering di tabelle lunghe e l'opzione Espandi le tabelle per mostrare tutte le righe è selezionata, i riquadri contenenti visualizzazioni di tabella potrebbero essere leggermente diversi nei PDF scaricati rispetto a Looker. Per ulteriori informazioni sulle differenze, visita la pagina della documentazione di Labs.

Download di una dashboard in formato CSV

Puoi scaricare tutti i riquadri delle query dalla dashboard come raccolta compressa di file CSV. I riquadri di testo non sono inclusi nel file ZIP. Per scaricare la dashboard come raccolta di file CSV, procedi nel seguente modo:

  1. Seleziona CSV dal menu a discesa Formato.
  2. Fai clic su Annulla se non vuoi più scaricare la dashboard.
  3. Fai clic su Scarica per avviare la download della raccolta CSV compressa.

Quando scarichi una dashboard come file CSV, le opzioni per la formattazione dei download, ad esempio l'impostazione di limiti di righe personalizzati o la scelta di tutti i risultati, non sono disponibili. I limiti di righe nei file scaricati sono correlati ai limiti di righe sui riquadri corrispondenti.

Looker genera file compressi utilizzando la codifica UTF-8. Se i caratteri nei nomi file CSV appaiono incomprensibili, potrebbe esserci un conflitto tra la codifica UTF-8 di Looker e la codifica predefinita del sistema operativo della macchina o di un'applicazione di terze parti. Looker consiglia di utilizzare un estrattore di file che riconosce UTF-8, ad esempio 7-Zip, e assicurati che le applicazioni di terze parti siano configurate per supportare UTF-8.

Download dei dati dai riquadri della dashboard

Non puoi scaricare i dati dei riquadri delle dashboard basati su query di risultati uniti, ma i dati provenienti dai riquadri dei risultati uniti sono inclusi se scarichi una dashboard in formato PDF o come una raccolta di file CSV.

Per scaricare i dati da un riquadro della dashboard, fai clic sull'icona con tre puntini nel riquadro e seleziona Scarica:

Si apre una finestra di dialogo con diverse opzioni simili a quelli per un Look o un'esplorazione. Espandi il menu Opzioni dati avanzate per visualizzare tutte le opzioni disponibili per il download:

Formato

I dati possono essere scaricati dai riquadri della dashboard nei seguenti formati:

  • TXT (valori delimitati da tabulazioni)
  • Foglio di calcolo di Excel (Excel 2007 o versione successiva)
  • CSV
  • JSON
  • HTML
  • Markdown
  • PNG (immagine di visualizzazione)

A seconda del formato selezionato, alcune opzioni del menu Opzioni avanzate per i dati potrebbero non essere disponibili.

Se non sono disponibili le opzioni HTML o PNG (immagine di visualizzazione), chiedi all'amministratore di Looker di installare la versione appropriata del renderer Chromium per la tua istanza di Looker.

Per il formato JSON, Looker utilizza campi di tipo labels come valore visualizzato nell'output JSON. Per ulteriori informazioni sul modo in cui Looker visualizza i campi in formato JSON, leggi il post della scheda Community relativo alla modifica della formattazione JSON.

Le visualizzazioni della tabella trasposte verranno visualizzate solo nei download in formato PDF e PNG.

I download in formato PNG restituiscono sempre i dati dal modello così come sono in modalità di produzione, anche se sei in modalità di sviluppo.

Risultati

Nella sezione Risultati, scegli se applicare le impostazioni di visualizzazione al tuo download di dati:

Se scegli Come mostrato nella tabella dati, le opzioni di visualizzazione non vengono applicate e il download ha lo stesso aspetto della tabella dati nella sezione Dati del Look o dell'esplorazione.

Valori dei dati

Nella sezione Valori dei dati, scegli come vuoi che vengano visualizzati i risultati scaricati:

  • Se scegli Formattato, i dati avranno un aspetto più simile all'esperienza Esplora in Looker, anche se alcune funzionalità (come il collegamento) non sono supportate da tutti i formati di file.
  • Se scegli Non formattato, Looker non applica alcuna formattazione speciale ai risultati, come l'arrotondamento dei numeri lunghi o l'aggiunta degli eventuali caratteri speciali previsti dagli sviluppatori Looker. Questa è in genere l'opzione preferita per i dati che devono essere inviati a un altro strumento per l'elaborazione.

Numero di righe e colonne da includere

In questa sezione puoi specificare la quantità di dati da includere nel download. Nella maggior parte dei riquadri, questa sezione del popup di download è denominata Numero di righe da includere; se la query del riquadro contiene dimensioni pivot, questa sezione è denominata Numero di righe e colonne da includere. Le opzioni disponibili sono:

Considerazioni relative all'utilizzo dell'opzione Tutti i risultati o Personalizzata

Looker controlla le tue autorizzazioni e determina se la complessità della query e del dialetto del database consentono di scaricare l'intera query. Se disponi delle autorizzazioni per scaricare i risultati al di sopra di un limite impostato e se Looker stabilisce che è possibile scaricare l'intera query, l'opzione Tutti i risultati sarà disponibile nella finestra Scarica.

L'opzione Tutti i risultati è generalmente disattivata per le query che:

Anche se l'opzione Tutti i risultati è disponibile, devi comunque prestare attenzione quando scarichi tutti i risultati. Alcune query sono molto grandi, contengono migliaia o milioni di righe, che possono sovraccaricare la maggior parte dei programmi per fogli di lavoro o persino la tua istanza di Looker.

Se l'opzione Tutti i risultati non è disponibile, puoi utilizzare l'opzione Personalizzato per specificare il numero massimo di righe consentite con le tue autorizzazioni. Quando selezioni Personalizzato, puoi specificare un numero di righe di risultati da scaricare. Se la tua query contiene dimensioni pivot, puoi anche specificare un numero di colonne da scaricare.

Per gli amministratori: abilitazione del download dei dati per l'istanza di Looker

Alcune opzioni di download richiedono che gli amministratori dei deployment di Looker ospitati dal cliente abbiano installato la versione appropriata del renderer Chromium. Se la tua istanza è ospitata da Looker, Chromium è già installato.

La pagina della documentazione Gestione delle funzionalità per gli utenti aziendali contiene importanti informazioni amministrative relative al processo di download:

Per saperne di più sulle autorizzazioni da assegnare agli utenti per avviare il download, in particolare le autorizzazioni download_with_limit e download_without_limit, visita la pagina della documentazione relativa ai ruoli.

Per ridurre il tempo di rendering dei download di PDF per dashboard che contengono visualizzazioni di tabella con molte righe, gli amministratori di Looker possono abilitare la funzionalità Eseguire il rendering delle tabelle lunghe in Labs.