Download di contenuti in corso...

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

Per scaricare contenuti, devi ricevere 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 relativa formattazione variano a seconda che il download venga eseguito da un Look o da un'esplorazione, da una dashboard o da una query di risultati unita.

Scaricare dati da un Look o un'esplorazione

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

Looker visualizza la finestra Download, in cui puoi assegnare un nome e una formattazione al download.

Nelle sezioni seguenti vengono illustrati ciascun campo della finestra Download:

Formato

I download nei formati che utilizzano il renderer (PNG e PDF) utilizzeranno i risultati della modalità di produzione. Se il download è in un altro formato, verranno mostrati i risultati nella modalità (sviluppo o produzione) in cui ti trovi.

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), contatta l'amministratore di Looker per l'installazione della 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 PNG.

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

Nome del file

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

Risultati

Nella sezione Risultati, scegli se applicare le impostazioni di visualizzazione al download dei 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. Le seguenti impostazioni nei menu Traccia, Serie e Formattazione configurate per la visualizzazione verranno applicate al download dei dati:

La formattazione condizionale viene mostrata nelle pubblicazioni in formato Excel di Look ed esplorazioni con visualizzazioni dei grafici a tabella solo se viene applicata la regola Lunghezza di una scala.

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

  • Il colore personalizzato del testo dell'intestazione e quello 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 nelle colonne anziché essere rappresentato come un'unica 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 Totali e Totali riga sono inclusi nei risultati scaricati, ma la riga e le colonne corrispondenti non sono etichettate.
  • I subtotali non verranno scaricati per le query che non possono essere trasmesse in streaming.

Le colonne dei 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 dei dati, le opzioni di visualizzazione non verranno applicate e il download apparirà come la tabella dei dati nella sezione Dati del Look o dell'esplorazione.

Valori dei dati

Nella sezione Valori dei dati, scegli in che modo devono essere visualizzati i risultati della query scaricati:

  • Se scegli Senza formattazione, Looker non applica alcuna formattazione speciale ai risultati delle query, come l'arrotondamento dei numeri lunghi o l'aggiunta di 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 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, qualsiasi formattazione applicata con il parametro html non verrà applicata ai download TXT, CSV, Excel o JSON.

Numero di righe e colonne da includere

Puoi scegliere la quantità di dati da scaricare nel seguente modo:

  • Tabella dei risultati attuali: numero di righe specificato dal limite di righe per i tuoi contenuti.
  • Tutti i risultati: tutti i risultati restituiti dalla query. Prima di selezionare questa opzione, consulta la sezione Tutti i risultati in questa pagina.
  • Personalizzato: un numero personalizzato di righe. Gli utenti con autorizzazioni download_with_limit sono limitati a 5000 righe. Il limite per altri utenti è in genere 100.000.

Tutti i risultati

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

In genere, l'opzione Tutti i risultati è disabilitata per le query che:

Anche quando l'opzione Tutti i risultati è disponibile, dovresti comunque prestare 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 persino la tua istanza Looker.

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

Risultati delle query relative ai flussi di dati

Per flusso di dati si intende la capacità di Looker di elaborare i dati in blocchi, piuttosto che in una volta sola. Se Looker può trasmettere in streaming un insieme di risultati, sono possibili download illimitati. L'opzione Tutti i risultati si basa sulla capacità di Looker di trasmettere i risultati in streaming e Tutti i risultati non saranno disponibili se non è possibile eseguire il flusso di risultati.

Looker trasmette in streaming i risultati scaricati in tutti i formati, ad eccezione dei formati sottoposti a rendering (HTML, PNG).

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

  1. Calcoli tabulari: i calcoli tabulari non possono essere trasmessi in streaming. 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 trasmettere 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 supportano lo streaming di risultati, il che significa che non è possibile eseguire download illimitati.

Questi database supportano i flussi di dati:

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

Questi sono i database che supportano i flussi di dati con i pivot applicati:

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

Rimuovi tutti gli ordinamenti dalla query

Quando selezioni Tutti i risultati, potresti anche visualizzare l'opzione Rimuovi tutti gli ordinamenti dalla query. Questa opzione impedisce l'ordinamento in base alla query prima di scaricare i risultati. La selezione di questa opzione può velocizzare il download, poiché l'ordinamento di una query può essere costoso per le prestazioni per alcuni 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 visualizzare l'opzione Consenti risultati di grandi dimensioni. Questo perché Google BigQuery prevede una dimensione massima di risposta per i risultati delle query, come descritto nell'argomento della documentazione di Google Cloud Scrivere risultati query. Per scaricare i risultati che superano la dimensione massima di risposta di BigQuery, Looker deve eseguire un processo diverso.

Se selezioni Consenti risultati di grandi dimensioni, il processo di download influisce nel seguente modo:

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

Scarica o apri nel browser

Dopo aver selezionato le opzioni, puoi fare clic sul pulsante Scarica per scaricare un file sul computer oppure 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 scaricare la dashboard come PDF o come raccolta di file CSV. Tuttavia, devi scaricare l'intera dashboard: non puoi scaricare i dati da un singolo riquadro basato su una query di risultati unita.

Download dei dati da una dashboard

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 PDF o CSV come formato di download.

Download di una dashboard in formato PDF

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

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

I download in formato PDF restituiscono sempre i dati dal modello così com'è in modalità di produzione, anche se ti trovi in modalità di sviluppo.

Per scaricare una dashboard in formato PDF:

  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'opzione predefinita; consente di impostare il PDF alla larghezza predefinita per le dashboard (1260 px). Altre opzioni per i formati carta consentono di adattare il PDF al formato standard del foglio e adattarlo all'intera o parte della dashboard al suo interno. A seconda del layout della dashboard e delle dimensioni del foglio selezionate, alcuni output PDF potrebbero differire dal layout della dashboard visualizzato in Looker. Ad esempio, quando le dimensioni della carta selezionate sono più strette rispetto alla dashboard, potresti riscontrare problemi di spaziatura o di altra formattazione e dover apportare alcune modifiche:

    • Le visualizzazioni di grandi dimensioni o i gruppi di riquadri sovrapposti potrebbero dover essere ridimensionati per adattarsi al PDF.
    • I riquadri che contengono tabelle potrebbero non mostrare tutte le colonne delle tabelle nel PDF.
    • È possibile ridurre la larghezza dei riquadri per adattarli 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 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 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 posizione verticale oppure orizzontale.

  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 di 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 delle righe, i limiti delle colonne e le impostazioni configurate con l'opzione Limita righe visualizzate.

    Se è selezionata l'opzione Espandi le tabelle per mostrare tutte le righe, i riquadri della dashboard che contengono visualizzazioni di tabelle potrebbero avere un aspetto leggermente diverso nei PDF scaricati rispetto a 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 momento del download.
    • L'icona di ordinamento non viene visualizzata nelle tabelle pivot che non sono state ordinate manualmente.
    • Le tabelle in cui è attivata l'opzione Ridimensiona le colonne per adattarle si estendono 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, chiedi all'amministratore di Looker di installare la versione appropriata del renderer di Chromium per la tua istanza di Looker.

  5. Seleziona o lascia deselezionato 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 al suo interno.

  6. Seleziona 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. Seleziona Annulla se non vuoi più scaricare la dashboard.

  8. Seleziona Scarica per avviare il download. Nel browser si aprirà una nuova scheda che mostra lo stato del download.

Se l'amministratore di Looker ha abilitato la funzionalità di Labs Rendering di tabelle lunghe e l'opzione Espandi le tabelle per mostrare tutte le righe è selezionata, i riquadri contenenti le visualizzazioni delle tabelle potrebbero avere un aspetto leggermente diverso nei PDF scaricati rispetto a Looker. Per scoprire di più sulle differenze, consulta la pagina della documentazione di Labs.

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, 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 nei riquadri corrispondenti.

Looker genera file compressi utilizzando la codifica UTF-8. Se i caratteri nei nomi dei file CSV appaiono con caratteri incomprensibili, potrebbe esserci un conflitto tra la codifica UTF-8 di Looker e la codifica predefinita del sistema operativo del computer in uso o di un'applicazione di terze parti. Looker consiglia di utilizzare un estrattore di file che riconosca la codifica UTF-8, come 7-Zip, e di assicurarti che eventuali applicazioni di terze parti siano configurate per il supporto della codifica UTF-8.

Download dei dati dai riquadri della dashboard in corso...

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

Per scaricare i dati dal riquadro di una dashboard, seleziona l'icona con tre puntini sul riquadro e scegli 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 dei dati per vedere 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 del menu Opzioni avanzate per i dati potrebbero non essere disponibili.

Se le opzioni HTML o PNG (immagine di visualizzazione) non sono disponibili, 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 vengono mostrate solo nei download in formato PDF e PNG.

I download in formato PNG restituiscono sempre i dati dal modello così com'è in modalità di produzione, anche se ti trovi in modalità di sviluppo.

Risultati

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

Se scegli Come mostrato nella tabella dei dati, le opzioni di visualizzazione non verranno applicate e il download apparirà come la tabella dei dati nella sezione Dati del Look o dell'esplorazione.

Valori dei dati

Nella sezione Valori dei dati, scegli in che modo devono essere 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 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 riquadro contiene dimensioni sottoposte a pivot, questa sezione è denominata 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 del dialetto del database consentono il download dell'intera query. Se disponi delle autorizzazioni per scaricare i risultati oltre un limite impostato e se Looker determina che è possibile scaricare l'intera query, l'opzione Tutti i risultati sarà disponibile nella finestra Scarica.

In genere, l'opzione Tutti i risultati è disabilitata per le query che:

Anche quando l'opzione Tutti i risultati è disponibile, devi comunque prestare 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 persino la tua istanza 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 una serie di righe di risultati da scaricare. Se la query contiene dimensioni sottoposte a pivot, puoi anche specificare un numero di colonne da scaricare.

Per gli amministratori: abilitare il download dei dati per l'istanza 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 l'istanza è ospitata da Looker, Chromium è già installato.

La pagina della documentazione Gestione delle funzionalità per gli utenti aziendali contiene importanti informazioni amministrative sulla procedura di download:

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

Per ridurre il tempo di rendering dei download di PDF per le dashboard che contengono visualizzazioni di tabelle con molte righe, gli amministratori di Looker possono attivare la funzionalità di Labs Esegui il rendering di tabelle lunghe.