Download dei contenuti in corso...

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

Per scaricare contenuti, devi aver ricevuto 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 il download venga eseguito da un Look o da un'esplorazione, da una dashboard o da una query dei risultati unita.

Scaricare i dati da un Look o da un'esplorazione

Per scaricare i dati da una pagina Look o Esplora, seleziona il menu a forma di ingranaggio in alto a destra e seleziona Scarica.

Looker visualizza la finestra Scarica in cui puoi assegnare un nome e un formato al download.

Nelle sezioni seguenti vengono descritti tutti i campi della finestra Scarica:

Formato

I download nei formati che utilizzano il renderer (PNG e PDF) si baseranno sui risultati della modalità Produzione. Se il download è in un altro formato, verranno visualizzati i risultati della modalità in cui ti trovi, ovvero sviluppo o produzione.

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

  • TXT (valori delimitati da tabulazioni)
  • Foglio di lavoro di Excel (Excel 2007 o versioni successive)
  • 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 le etichette dei campi come valore visualizzato nell'output JSON. Consulta il post della scheda Community Modifica della formattazione JSON per saperne di più su come Looker esegue il rendering dei campi in formato JSON.

Le tabelle trasposte verranno visualizzate solo nei download in formato PNG.

Per gli sviluppatori Looker, se sei in modalità di sviluppo, i download dei dati nella maggior parte dei formati file eseguono query sul modello così com'è in modalità sviluppo. Fanno eccezione i formati file PDF e PNG; i download di dati in questi formati eseguono query sempre sul modello come se fosse in modalità Produzione.

Nome del file

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

Risultati

Nella sezione Risultati, scegli se vuoi applicare le impostazioni di visualizzazione al download di dati TXT, Excel, CSV, JSON, HTML o Markdown.

Se scegli Con le opzioni di visualizzazione applicate, Looker applica alcune delle impostazioni di visualizzazione al download. Al download dei dati verrà applicata una qualsiasi delle seguenti impostazioni configurate per la visualizzazione nei menu Traccia, Serie e Formattazione:

La formattazione condizionale verrà mostrata nei caricamenti Excel di Look ed esplorazioni con visualizzazioni di grafici a tabella solo se viene applicata la regola lungo una scala.

Alcune impostazioni di visualizzazione non vengono applicate ai risultati scaricati. Ad esempio:

  • Il colore personalizzato del testo dell'intestazione e dello sfondo non vengono applicati ai risultati scaricati, ad eccezione dei file PNG.
  • Per le tabelle dei risultati con pivot e più misure, ogni valore pivot viene ripetuto in più colonne anziché come una colonna unita. I download HTML e PNG sono un'eccezione, pertanto la colonna unita viene mantenuta.
  • Quando esegui il download da una dashboard, il titolo del riquadro della dashboard non è incluso nei risultati scaricati.
  • I valori di Totali e Totali riga sono inclusi nei risultati scaricati, ma le rispettive righe e colonne non sono etichettate.
  • I subtotali non verranno scaricati per le query che non possono essere trasmesse in streaming.

Le colonne nei grafici a tabella riordinati manualmente verranno 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 verranno applicate e il download apparirà come la tabella di 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 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 di caratteri speciali utilizzati 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, l'aspetto dei dati sarà simile a quello dell'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 file TXT, CSV, Excel o JSON.

Numero di righe e colonne da includere

Per scegliere la quantità di dati da scaricare:

  • Tabella dei risultati attuali: il numero di righe specificato dal limite di righe dei tuoi 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 download_with_limit hanno un limite di 5000 righe. Il limite per gli altri utenti è in genere 100.000.

Tutti i risultati

Quando selezioni Esegui in un Look o in un'esplorazione, Looker controlla le tue autorizzazioni e determina se la complessità della query e il dialetto del database consentiranno il download dell'intera query. Se disponi delle autorizzazioni (per risultati che superano un limite impostato) e se Looker stabilisce che è possibile scaricare l'intera query, nella finestra Scarica sarà disponibile l'opzione Tutti i risultati.

In genere, l'opzione Tutti i risultati viene 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, contenenti migliaia o milioni di righe, il che può sovraccaricare la maggior parte dei programmi per fogli di lavoro o perfino l'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 modalità flusso

Per flusso di dati si intende la capacità di Looker di elaborare i dati in blocchi, anziché tutti in una volta. Se Looker è in grado di trasmettere in streaming un insieme di risultati, sono possibili download illimitati. L'opzione Tutti i risultati si basa sulla capacità di Looker di trasmettere in streaming i risultati e Tutti i risultati non sarà disponibile se non è possibile visualizzare i risultati in streaming.

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

  1. Calcoli tabulari: i calcoli tabulari non possono essere trasmessi in flusso. Pertanto, 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 creare flussi di dati se nella query sono inclusi pivot. Per questi database, devi rimuovere i pivot per scaricare un numero illimitato di risultati. Alcuni database non possono trasmettere alcun risultato in streaming, il che significa che non sono possibili download illimitati.

Questi database supportano i flussi di dati:

Dialetto Supportata?
Valanga Actia
Sì
Amazon Athena
Sì
Amazon Aurora MySQL
Sì
Amazon Redshift
Sì
Druid Apache
No
Apache Druid 0.13 o versioni successive
No
Apache Druid 0.18 o versioni successive
No
Apache Hive 2.3 o versioni successive
Sì
Apache Hive 3.1.2 o versioni successive
Sì
Apache Spark 3 e versioni successive
Sì
ClickHouse
Sì
Cloudera Impala 3.1 o versioni successive
Sì
Cloudera Impala 3.1 o versioni successive con driver nativo
Sì
Cloudera Impala con driver nativo
Sì
DataVirtuality
Sì
Databricks
Sì
Denodo 7
Sì
Denodo 8
Sì
Dremio
Sì
Dremio 11+
Sì
Exasol
Sì
Firebolt
Sì
SQL precedente di Google BigQuery
Sì
SQL standard di Google BigQuery
Sì
Google Cloud PostgreSQL
Sì
Google Cloud SQL
Sì
Google Spanner
No
Greenplum
Sì
HyperSQL
No
Netezza di IBM
No
MariaDB
Sì
PostgreSQL Microsoft Azure
Sì
Database SQL di Microsoft Azure
Sì
Microsoft Azure Synapse Analytics
Sì
Microsoft SQL Server 2008 e versioni successive
Sì
Microsoft SQL Server 2012 o versioni successive
Sì
Microsoft SQL Server 2016
Sì
Microsoft SQL Server 2017 o versioni successive
Sì
MongoBI
Sì
MySQL
Sì
MySQL 8.0.12 o versioni successive
Sì
Oracle
Sì
Oracle ADWC
Sì
PostgreSQL 9.5 e versioni successive
Sì
PostgreSQL pre-9.5
Sì
PrestoDB
Sì
PrestoSQL
Sì
SAP HANA 2 o versioni successive
No
SingleStore
Sì
SingleStore 7+
Sì
Snowflake
Sì
Teradata
Sì
Trino
Sì
Vettore
Sì
Vertica
Sì

Di seguito sono riportati i database che supportano i flussi di dati con pivot applicati:

Dialetto Supportata?
Valanga Actia
Sì
Amazon Athena
Sì
Amazon Aurora MySQL
No
Amazon Redshift
Sì
Druid Apache
No
Apache Druid 0.13 o versioni successive
No
Apache Druid 0.18 o versioni successive
No
Apache Hive 2.3 o versioni successive
No
Apache Hive 3.1.2 o versioni successive
No
Apache Spark 3 e versioni successive
Sì
ClickHouse
No
Cloudera Impala 3.1 o versioni successive
Sì
Cloudera Impala 3.1 o versioni successive con driver nativo
Sì
Cloudera Impala con driver nativo
Sì
DataVirtuality
No
Databricks
Sì
Denodo 7
No
Denodo 8
No
Dremio
No
Dremio 11+
No
Exasol
Sì
Firebolt
Sì
SQL precedente di Google BigQuery
Sì
SQL standard di Google BigQuery
Sì
Google Cloud PostgreSQL
Sì
Google Cloud SQL
No
Google Spanner
No
Greenplum
Sì
HyperSQL
No
Netezza di IBM
Sì
MariaDB
No
PostgreSQL Microsoft Azure
Sì
Database SQL di Microsoft Azure
Sì
Microsoft Azure Synapse Analytics
Sì
Microsoft SQL Server 2008 e versioni successive
Sì
Microsoft SQL Server 2012 o versioni successive
Sì
Microsoft SQL Server 2016
Sì
Microsoft SQL Server 2017 o versioni successive
Sì
MongoBI
No
MySQL
No
MySQL 8.0.12 o versioni successive
No
Oracle
Sì
Oracle ADWC
Sì
PostgreSQL 9.5 e versioni successive
Sì
PostgreSQL pre-9.5
Sì
PrestoDB
Sì
PrestoSQL
Sì
SAP HANA 2 o versioni successive
No
SingleStore
Sì
SingleStore 7+
Sì
Snowflake
Sì
Teradata
Sì
Trino
Sì
Vettore
Sì
Vertica
Sì

Rimuovi tutti gli ordinamenti dalla query

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

L'opzione Rimuovi tutti gli ordinamenti dalla query non è supportata per i risultati sottoposti a 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 di Google Cloud Scrittura dei risultati delle query. 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, il processo di download è influenzato come segue:

  • L'opzione BigQuery allowLargeResults è impostata su true per la query.
  • Le clausole ORDER BY nella query vengono rimosse.
  • La query scriverà su uno schema temporaneo PPT e richiede l'autorizzazione per scrivere su uno.
  • I risultati della query vengono archiviati in questo schema temporaneo temporaneo per un'ora sotto un nome di tabella casuale.

Scarica o apri nel browser

Una volta selezionate le opzioni, puoi selezionare il pulsante Scarica per scaricare un file sul computer o selezionare Apri nel browser per visualizzare il file nel browser.

Download dei dati da una query dei risultati unita

Per scaricare le query dei risultati uniti, puoi salvarla in una dashboard e poi scaricarla in formato PDF o come 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 unita.

Download dei dati da una dashboard

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

Si apre una finestra di dialogo che consente di selezionare PDF o CSV come formato di download.

Scaricare una dashboard in formato PDF

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

I download in formato PDF restituiscono sempre i dati dal modello come se si trovasse in modalità Produzione, anche se ti trovi in modalità Sviluppo.

Per scaricare una dashboard in formato PDF, procedi nel seguente modo:

  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 per le dashboard (1260 px). Altre opzioni di formato della carta consentono di ridimensionare il PDF in modo che corrisponda al formato carta standard e che si adatti interamente o parzialmente alla dashboard al suo interno. A seconda del layout della dashboard e delle dimensioni della carta selezionate, alcuni output di PDF potrebbero differire dal layout della dashboard quando visualizzati in Looker. Ad esempio, quando le dimensioni della carta selezionate sono più strette di quelle della dashboard, potrebbero verificarsi problemi di spaziatura o altra formattazione e potrebbero essere necessarie alcune modifiche:

    • Potrebbe essere necessario ridimensionare le visualizzazioni di grandi dimensioni o i gruppi di riquadri sovrapposti per adattarli al PDF.
    • I riquadri che contengono tabelle potrebbero non mostrare tutte le colonne della tabella nel PDF.
    • La larghezza dei riquadri può essere ridotta per adattarsi al PDF. Allo stesso modo, i riquadri che richiedono lo scorrimento nell'app Looker potrebbero non espandersi per visualizzare tutti i contenuti.

    Se non vedi l'opzione Dimensione carta, rivolgiti all'amministratore di Looker per installare l'ultima versione del renderer Chromium per la tua istanza di Looker.

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

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

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

    • Le personalizzazioni dei colori di sfondo e delle dimensioni dei caratteri vengono rimosse dalle intestazioni di colonna e dalle righe del subtotale.
    • Se non è impostato alcun tema personalizzato, le tabelle vengono visualizzate nel tema bianco. In caso contrario, il tema personalizzato viene applicato al termine del download.
    • L'icona di ordinamento non viene visualizzata nelle tabelle pivot non ordinate manualmente.
    • Le tabelle in cui è attivata l'opzione Imposta dimensioni delle colonne per adattarle si estendono fino all'intera larghezza del riquadro.

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

    Se non vedi l'opzione Espandi le tabelle per mostrare tutte le righe, rivolgiti all'amministratore di Looker per installare la versione appropriata del Renderer Chromium per la tua istanza Looker.

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

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

  7. Seleziona Annulla se non vuoi più scaricare la dashboard.

  8. Seleziona Scarica per avviare il download. Si aprirà una nuova scheda del browser in cui viene indicato lo stato del download.

Scaricare 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:

  1. Seleziona CSV dal menu a discesa Formato.
  2. Seleziona Annulla se non vuoi più scaricare la dashboard.
  3. Seleziona Scarica per avviare il 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 nei riquadri corrispondenti.

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

Download dei dati dai riquadri della dashboard

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

Per scaricare i dati da un riquadro di una dashboard, seleziona l'icona con tre puntini nel riquadro e seleziona Scarica dati:

Si apre una finestra di dialogo con diverse opzioni simili a quelle per un Look o un'esplorazione. Espandi il menu Opzioni avanzate per i dati 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 lavoro di Excel (Excel 2007 o versioni successive)
  • CSV
  • JSON
  • HTML
  • Markdown
  • PNG (immagine di visualizzazione)

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

Se non sono presenti 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 le etichette dei campi come valore visualizzato nell'output JSON. Consulta il post della scheda Community Modifica della formattazione JSON per saperne di più su come Looker esegue il rendering dei campi in formato JSON.

Le visualizzazioni delle tabelle 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 nella modalità Produzione, anche se sei in modalità Sviluppo.

Risultati

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

Se scegli Come visualizzato nella tabella dati, le opzioni di visualizzazione non verranno applicate e il download apparirà come la tabella di 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 Formattati, i dati appariranno più simili 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 di caratteri speciali impostati dagli sviluppatori di 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 utilizzate, il nome di questa sezione è Numero di righe e colonne da includere. Le opzioni disponibili sono:

Considerazioni sull'utilizzo dell'opzione Tutti i risultati o Personalizzato

Looker controlla le tue autorizzazioni e determina se la complessità della query e il dialetto del database consentiranno il download dell'intera query. Se hai le autorizzazioni per scaricare risultati che superano un limite impostato e se Looker determina che è possibile scaricare l'intera query, nella finestra Scarica sarà disponibile l'opzione Tutti i risultati.

L'opzione Tutti i risultati è in genere 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, contenenti migliaia o milioni di righe, il che può sovraccaricare la maggior parte dei programmi per fogli di lavoro o perfino l'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. Se selezioni Personalizzato, puoi specificare un numero di righe di risultati da scaricare. Se la query contiene dimensioni utilizzate, puoi anche specificare una serie 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 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 per gli amministratori sul processo di download:

Per scoprire di più sulle autorizzazioni che devono essere assegnate agli utenti per consentirne il download, in particolare le autorizzazioni download_with_limit e download_without_limit, visita la pagina della documentazione Ruoli.

Per ridurre i tempi di rendering dei download dei PDF per le dashboard che contengono visualizzazioni di tabelle con molte righe, gli amministratori di Looker possono abilitare la funzionalità dei lab Visualizzazione di tabelle lunghe.