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 per il download dei contenuti e la formattazione dei contenuti scaricati variano a seconda che tu stia scaricando da un look o da un'esplorazione, da una dashboard, da una dashboard precedente o da una query dei risultati uniti.

Download di dati da un Look o da un'esplorazione

Per scaricare dati dalla pagina di un Look o di un'esplorazione, fai clic sul menu a forma di ingranaggio nell'angolo superiore destro e seleziona Download.

Viene visualizzata la finestra Scarica, in cui puoi assegnare un nome e un formato al download:

Le seguenti sezioni descrivono i singoli campi nella finestra Download:

Formati file

I download nei formati che utilizzano il renderer (PNG e PDF) sono basati sui 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 tabulazione)
  • Foglio di lavoro 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 l'argomento della community Cambiamento nella formattazione JSON.

Le tabelle trasposte verranno visualizzate solo nei download PNG.

Per gli sviluppatori di Looker, se sei in modalità di sviluppo, i download di dati nella maggior parte dei formati di file eseguono query sul modello così come è 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 Results (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 dell'aspetto o dell'esplorazione.

Valori

Nella sezione Valori, scegli come visualizzare i risultati della query scaricati:

  • Se scegli Senza formattazione, Looker non applica alcuna formattazione speciale ai risultati della query, 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.
  • Se scegli Formattato, i dati appariranno più simili all'esperienza Esplora in Looker, anche se alcune funzionalità (come il collegamento) non sono supportate da tutti i tipi di file.

Limiti

Puoi scegliere quanti dati vuoi scaricare nel seguente modo:

  • Risultati nella tabella: il numero di righe specificate 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 di download_with_limit possono gestire fino a 5000 righe. Il limite per gli altri utenti in genere è 100.000,a meno che il tuo amministratore Looker non abbia aumentato tale limite (vedi l'argomento della Community su consentire i download illimitati (Looker 4.14 e versioni successive)).

Tutti i risultati

Quando fai clic su Run (Esegui) in un look o in un Explore, Looker controlla le autorizzazioni e determina se la complessità della query e il dialetto del database consentono di scaricare l'intera query. Se disponi delle autorizzazioni (per i risultati superiori a un limite impostato) e se Looker determina che l'intera query può essere scaricata, l'opzione Tutti i risultati sarà disponibile nella finestra Scarica.

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

Anche quando l'opzione Tutti i risultati è disponibile, devi comunque fare attenzione quando scarichi tutti i risultati. Alcune query sono molto grandi, contengono migliaia o milioni di righe, il che può sovraccaricare la maggior parte dei programmi per fogli di lavoro e 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.

Flusso delle query sui risultati

Lo streaming si riferisce alla capacità di Looker di elaborare i dati in blocchi, anziché in una sola volta. 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 sottoposti a rendering (HTML, PNG).

Oltre alle limitazioni del formato, esistono due casi in cui lo streaming non è possibile:

  1. Calcoli delle tabelle: i calcoli tabulari non possono essere trasmessi in streaming. Di conseguenza, per scaricare un numero illimitato di risultati per una query, devi rimuovere i calcoli tabulari dalla query.
  2. Limitazioni del database: alcuni database non possono trasmettere in streaming se sono inclusi pivot nella query. Per questi database, devi rimuovere i pivot per scaricare un numero illimitato di risultati. Alcuni database non possono trasmettere i risultati in streaming, il che significa che non è possibile effettuare download illimitati. Di seguito sono riportati 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, perché l'ordinamento di una query può essere costoso in termini di prestazioni per alcuni tipi di database.

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

Consenti risultati di dimensioni elevate

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 relativa alla scrittura dei risultati della query di Google Cloud. Per scaricare risultati che superano le dimensioni massime di risposta in BigQuery, Looker deve eseguire un processo diverso.

Se selezioni Consenti risultati di grandi dimensioni, la procedura di download viene applicata come segue:

  • L'opzione allowLargeResults BigQuery è impostata su true per la query.
  • Le clausole ORDER BY nella query sono rimosse.
  • La query scriverà in uno schema di temperatura PDT e richiederà l'autorizzazione per scriverli in uno.
  • I risultati della query vengono memorizzati in questo schema temporaneo sotto un nome di 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 o Apri nel browser per visualizzare il file nel browser.

Download dei dati da una query di risultati uniti

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

Scaricare dati da una dashboard

Questa sezione descrive il download delle dashboard che utilizzano la nuova esperienza della dashboard. Per informazioni sul download di dashboard precedenti, consulta la sezione Download di dati da una dashboard precedente.

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

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

Download di una dashboard come PDF

L'intera dashboard può essere scaricata in formato PDF, ovvero riceverai un'immagine PDF con il titolo della dashboard, i filtri della dashboard, tutti i riquadri della dashboard e il fuso orario in cui è stata eseguita. Il PDF include anche un timestamp che indica quando è stata scaricata la dashboard.

Quando scarichi una dashboard come PDF, il PDF visualizza la nuova esperienza della dashboard o una dashboard legacy, a seconda del formato permanente della dashboard. In altre parole, se vedi temporaneamente la dashboard in un formato diverso perché hai cambiato l'URL, tutti i download rispecchieranno il formato permanente.

I download in formato PDF restituiscono sempre i dati del 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 in modo che corrisponda al layout della dashboard sullo schermo. Le altre opzioni di formato della carta consentono di ridimensionare il PDF in modo che corrisponda a un formato di carta standard e di adattarlo alla dashboard al suo interno. A seconda del layout della dashboard, potrebbe essere necessario ridimensionare le visualizzazioni o i gruppi di riquadri sovrapposti in base a una determinata dimensione della pagina.



    Se non vedi l'opzione Dimensioni carta, chiedi all'amministratore di Looker di installare la versione più recente del renderer Chromium per la tua istanza di Looker.
  3. Se selezioni qualcosa di diverso da Adatta alla pagina alla dashboard nel menu a discesa Formato carta, viene visualizzata un'opzione Orientamento. Puoi scegliere di orientare la dashboard in verticale oppure in orizzontale.
  4. Seleziona o lascia deselezionata Espandi tabelle per visualizzare tutte le righe. Se selezioni questa opzione, per i riquadri della dashboard che utilizzano le visualizzazioni della tabella, il PDF mostrerà tutte le righe disponibili nella visualizzazione della tabella, non solo le righe visibili nella miniatura del riquadro della dashboard. Se non selezioni questa opzione, nel PDF verranno mostrate solo le righe visibili nella miniatura senza scorrere. I filtri di dashboard e query continueranno a essere applicati, così come le impostazioni di visualizzazione, come i limiti di righe, i limiti di colonne e le impostazioni configurate con l'opzione Limita righe visualizzate. Se non vedi l'opzione Espandi le tabelle per mostrare 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 deselezionato Disponi riquadri 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, che mostra lo stato del download.

Se l'amministratore di Looker ha abilitato la funzionalità Render Long Tables (Crea tabelle lunghe) e l'opzione Espandi le tabelle per mostrare tutte le righe è selezionata, i riquadri che contengono visualizzazioni di tabelle potrebbero avere un aspetto leggermente diverso nei PDF scaricati rispetto a quanto avviene all'interno di Looker. Per saperne di più sulle differenze, visita la pagina della documentazione relativa a Labs.

Download di una dashboard in formato CSV

Puoi scaricare tutti i riquadri delle query dalla dashboard come raccolta zip di file CSV. I riquadri di testo non sono inclusi nel file ZIP. Per scaricare la dashboard come una raccolta di file CSV, segui questi passaggi:

  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 il download della raccolta CSV compresso.

Quando scarichi una dashboard come file CSV, le opzioni per la formattazione dei download, ad esempio l'impostazione di limiti di righe personalizzate 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 ZIP utilizzando la codifica UTF-8. Se i caratteri nei nomi file CSV presentano caratteri 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 che eventuali applicazioni di terze parti siano configurate per supportare UTF-8.

Download dei dati dai riquadri delle dashboard

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

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

Viene visualizzata una finestra di dialogo con diverse opzioni simili a quelli per un Look o un'esplorazione e per un download di riquadri della dashboard precedente. Espandi il menu Opzioni avanzate dei dati per visualizzare tutte le opzioni disponibili per il download:

Formatta

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

  • TXT (valori delimitati da tabulazione)
  • Foglio di lavoro 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 dei dati potrebbero non essere disponibili.

Se le opzioni HTML o PNG (immagine di visualizzazione) non sono presenti, 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 l'argomento della community Cambiamento nella formattazione JSON.

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

I download in formato PNG restituiscono sempre dati dal modello così come sono nella Modalità produzione, anche se sei in modalità Sviluppo.

Risultati

Nella sezione Results (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 dell'aspetto o dell'esplorazione.

Valori dei dati

Nella sezione Valori dei dati, scegli la modalità di visualizzazione dei risultati scaricati:

  • Se scegli Formattati, i dati appariranno in modo più simile all'esperienza Esplora in Looker, anche se alcune funzionalità (come il collegamento) non sono supportate da tutti i formati file.
  • Se scegli Senza formattazione, 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 personalizzati

Looker controlla le autorizzazioni e determina se la complessità della query e del dialetto del database consente di scaricare l'intera query. Se hai le autorizzazioni per scaricare i risultati oltre un limite impostato e se Looker determina che l'intera query può essere scaricata, l'opzione Tutti i risultati sarà disponibile nella finestra di download.

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

Anche quando l'opzione Tutti i risultati è disponibile, devi comunque fare attenzione quando scarichi tutti i risultati. Alcune query sono molto grandi, contengono migliaia o milioni di righe, il che può sovraccaricare la maggior parte dei programmi per fogli di lavoro e 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 Personalizzata, puoi specificare un numero di righe di risultati da scaricare. Se la query contiene dimensioni pivot, puoi anche specificare un numero di colonne da scaricare.

Download dei dati da una dashboard precedente

Questa sezione riguarda le dashboard precedenti. Per informazioni sul download delle dashboard utilizzando la nuova esperienza della dashboard, consulta la sezione Scaricare i dati da una dashboard.

Looker ti consente di scaricare la dashboard precedente per consentirti di archiviare o condividere i dati attuali. Puoi scaricare la dashboard precedente in formato PDF o come raccolta zip di file CSV.

Download di una dashboard precedente come PDF

Per scaricare la dashboard precedente in formato PDF:

  1. Fai clic sull'icona a forma di ingranaggio nell'angolo in alto a destra della pagina.

  2. Seleziona Scarica come PDF.

    Viene visualizzata la finestra Download, in cui puoi assegnare un nome e un formato al download.

  3. Facoltativamente, utilizza la casella Nome file per modificare il nome del file PDF.

  4. Facoltativamente, espandi il menu Opzioni avanzate per personalizzare ulteriormente il PDF.

    Seleziona la casella Formato colonna singola se vuoi che il PDF mostri i riquadri precedenti della dashboard in un'unica colonna verticale. Lascia deselezionata la casella se vuoi che il PDF mostri i riquadri così come sono disposti nella dashboard precedente.

    Se selezioni l'opzione Espandi tabelle per mostrare tutte le righe, per i riquadri della dashboard che utilizzano la visualizzazione 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 mostrate solo le righe visibili nella miniatura senza scorrere. I filtri di dashboard e query continueranno a essere applicati, così come le impostazioni di visualizzazione, come i limiti di righe, i limiti di colonne e le impostazioni configurate con l'opzione Limita righe visualizzate.

    Puoi anche specificare le dimensioni e l'orientamento ottimali del PDF selezionandolo dal menu a discesa Dimensioni carta. Potrebbe essere necessario ridimensionare le visualizzazioni di grandi dimensioni o i gruppi di riquadri sovrapposti per adattarli a una pagina di tipo PDF.

    Se non vedi le opzioni Dimensioni carta o Espandi tabelle per mostrare tutte le righe, chiedi all'amministratore di Looker di installare la versione appropriata del renderer Chromium per la tua istanza di Looker.

  5. Fai clic su Scarica o Apri nel browser.

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

Quando scarichi una dashboard come PDF, il PDF visualizza la nuova esperienza della dashboard o una dashboard precedente, a seconda del formato permanente della dashboard. In altre parole, se vedi temporaneamente la dashboard in un formato diverso perché hai cambiato l'URL, tutti i download rispecchieranno il formato permanente.

Download di una dashboard precedente in formato CSV

Per scaricare un file CSV da una dashboard precedente, fai clic sull'icona a forma di ingranaggio nell'angolo in alto a destra della dashboard e seleziona Scarica come CSV per avviare il download:

La directory ZIP conterrà un file CSV separato per ogni riquadro della dashboard. Ogni file CSV include i dati formattati utilizzati per creare il riquadro nella dashboard:

Quando scarichi una dashboard come file CSV, le opzioni per la formattazione dei download, come 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 ZIP utilizzando la codifica UTF-8. Se i caratteri nei nomi file CSV presentano caratteri 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 suggerisce di utilizzare un estrattore di file che riconosce UTF-8, ad esempio 7-Zip, e di garantire che qualsiasi applicazione di terze parti sia configurata per supportare UTF-8.

Download di dati da riquadri di dashboard precedenti

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

La finestra di download del riquadro e le opzioni sono simili a quelle di un Look o di un'esplorazione. Per ulteriori informazioni sulle opzioni disponibili per personalizzare il download dei dati, consulta la sezione Download di dati da un Look o da un'esplorazione. Se scarichi Tutti i risultati, non vedrai l'opzione per rimuovere ordinamenti dalla query come faresti per un look o un'esplorazione.

Non puoi scaricare i dati dai riquadri della dashboard precedenti in base alle query sui risultati uniti, ma i dati dei riquadri dei risultati uniti sono inclusi se scarichi una dashboard precedente come PDF o come una raccolta di file CSV.

Per gli amministratori: abilitazione del download dei dati per la tua istanza di Looker

Alcune opzioni di download richiedono che gli amministratori dei deployment 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 sulla gestione delle funzionalità per utenti aziendali contiene importanti informazioni amministrative sulla procedura di download.

Per saperne di più sulle autorizzazioni che devono essere assegnate agli utenti per consentire loro di scaricare, 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 le dashboard che contengono visualizzazioni di tabella con molte righe, gli amministratori di Looker possono attivare la funzionalità Render Long Tables (Eseguire tabelle lunghe).