Download dei contenuti

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

Per scaricare contenuti, devi disporre dell'autorizzazione download_with_limit o download_without_limit concessa 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 avvenga da un look o da un'esplorazione, da una dashboard o da una query con risultati uniti.

Download di dati da un Look o da un'esplorazione

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

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

Le sezioni seguenti illustrano i singoli campi della finestra Scarica:

Formato

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

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

  • TXT (valori delimitati da tabulazioni)
  • Foglio di lavoro Excel (Excel 2007 o versioni successive)
  • CSV
  • JSON
  • HTML
  • Markdown
  • PNG (immagine di visualizzazione)

Se quando scegli il formato di dati per il download 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 il campo etichette come valore visualizzato nell'output JSON. Per ulteriori informazioni sul modo in cui Looker visualizza i campi in formato JSON, consulta il post della community Modifica della formattazione JSON.

Le tabelle trasposte vengono visualizzate solo nei download PNG.

Per gli sviluppatori Looker, in modalità di sviluppo i download di dati nella maggior parte dei formati di file interrogano il modello così come appare in modalità di sviluppo. I formati di file PDF e PNG fanno eccezione, perché i download di dati in questi formati 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 selezione nel campo Formato.

Risultati

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

Se scegli Con opzioni di visualizzazione applicate, Looker applica alcune delle impostazioni di visualizzazione al tuo download. Al download di dati vengono applicate tutte le impostazioni dei menu Grafico, Serie e Formattazione che sono configurate per la visualizzazione:

La formattazione condizionale viene visualizzata nelle versioni Excel di Look ed esplorazioni, mentre le visualizzazioni dei grafici tabulari vengono mostrate solo se è applicata la regola Lungo una scala.

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

  • Il colore del testo e il colore di sfondo dell'intestazione personalizzati non vengono applicati ai risultati scaricati, ad eccezione dei file PNG.
  • Per le tabelle dei risultati con pivot e più misure, ogni valore del pivot viene ripetuto nelle colonne anziché essere rappresentato come una colonna unita. I download in HTML e PNG sono un'eccezione, quindi la colonna unita viene conservata.
  • Quando scarichi 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 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 dei grafici tabulari che sono state riorganizzate manualmente vengono visualizzate nella posizione che occupavano originariamente nel download se la query include uno dei seguenti elementi:

Se scegli Come appaiono nella tabella dei 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 dati, 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 Formatted (Con formattazione), l'aspetto dei dati sarà simile all'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 in formato 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 correnti: 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 in questa pagina.
  • Personalizzato: un numero personalizzato di righe. Gli utenti che dispongono delle autorizzazioni download_with_limit sono limitati a 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 consentono di scaricare l'intera query. Se disponi delle autorizzazioni (per i risultati superiori a un limite impostato) e se Looker stabilisce che l'intera query può essere scaricata, l'opzione Tutti i risultati sarà disponibile nella finestra Scarica.

L'opzione Tutti i risultati è in genere disattivata per le query che eseguono una delle seguenti operazioni:

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

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

Streaming dei risultati delle query

Con streaming si fa riferimento alla capacità di Looker di elaborare i dati in blocchi, anziché tutti contemporaneamente. Se Looker può eseguire lo streaming di un insieme di risultati, sono possibili download illimitati. L'opzione Tutti i risultati si basa sulla capacità di Looker di eseguire lo streaming dei risultati e non sarà disponibile se non è possibile eseguire lo streaming dei risultati.

Oltre alle limitazioni relative al formato, lo streaming non è possibile in due casi:

  1. Calcoli tabulari: i calcoli tabulari non possono essere trasmessi in streaming. Pertanto, per scaricare risultati illimitati per una query, devi rimuovere i calcoli della tabella dalla query.
  2. Limitazioni del database: alcuni database non possono essere sottoposti a streaming se nella query sono inclusi i 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 sono possibili download illimitati.

Questi database supportano lo streaming:

Dialetto Supportato?
Actian Avalanche
Sì
Amazon Athena
Sì
Amazon Aurora MySQL
Sì
Amazon Redshift
Sì
Apache Druid
No
Apache Druid 0.13 e versioni successive
No
Apache Druid 0.18 o versioni successive
No
Apache Hive 2.3 e versioni successive
Sì
Apache Hive 3.1.2 e versioni successive
Sì
Apache Spark 3 e versioni successive
Sì
ClickHouse
Sì
Cloudera Impala 3.1 e versioni successive
Sì
Cloudera Impala 3.1 e 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ì
Fulmine
Sì
SQL precedente di Google BigQuery
Sì
SQL standard di Google BigQuery
Sì
PostgreSQL di Google Cloud
Sì
Google Cloud SQL
Sì
Google Spanner
No
Greenplum
Sì
HyperSQL
No
IBM Netezza
No
MariaDB
Sì
Microsoft Azure PostgreSQL
Sì
Database SQL di Microsoft Azure
Sì
Microsoft Azure Synapse Analytics
Sì
Microsoft SQL Server 2008 e versioni successive
Sì
Microsoft SQL Server 2012 e versioni successive
Sì
Microsoft SQL Server 2016
Sì
Microsoft SQL Server 2017 e versioni successive
Sì
MongoBI
Sì
MySQL
Sì
MySQL 8.0.12 e versioni successive
Sì
Oracle
Sì
Oracle ADWC
Sì
PostgreSQL 9.5 e versioni successive
Sì
PostgreSQL precedente alla versione 9.5
Sì
PrestoDB
Sì
PrestoSQL
Sì
SAP HANA 2 e versioni successive
No
SingleStore
Sì
SingleStore 7 e versioni successive
Sì
Snowflake
Sì
Teradata
Sì
Trino
Sì
Vettoriale
Sì
Vertica
Sì

Questi sono i database che supportano lo streaming con i pivot applicati:

Dialetto Supportato?
Actian Avalanche
Sì
Amazon Athena
Sì
Amazon Aurora MySQL
No
Amazon Redshift
Sì
Apache Druid
No
Apache Druid 0.13 e versioni successive
No
Apache Druid 0.18 o versioni successive
No
Apache Hive 2.3 e versioni successive
No
Apache Hive 3.1.2 e versioni successive
No
Apache Spark 3 e versioni successive
Sì
ClickHouse
No
Cloudera Impala 3.1 e versioni successive
Sì
Cloudera Impala 3.1 e 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ì
Fulmine
Sì
SQL precedente di Google BigQuery
Sì
SQL standard di Google BigQuery
Sì
PostgreSQL di Google Cloud
Sì
Google Cloud SQL
No
Google Spanner
No
Greenplum
Sì
HyperSQL
No
IBM Netezza
Sì
MariaDB
No
Microsoft Azure PostgreSQL
Sì
Database SQL di Microsoft Azure
Sì
Microsoft Azure Synapse Analytics
Sì
Microsoft SQL Server 2008 e versioni successive
Sì
Microsoft SQL Server 2012 e versioni successive
Sì
Microsoft SQL Server 2016
Sì
Microsoft SQL Server 2017 e versioni successive
Sì
MongoBI
No
MySQL
No
MySQL 8.0.12 e versioni successive
No
Oracle
Sì
Oracle ADWC
Sì
PostgreSQL 9.5 e versioni successive
Sì
PostgreSQL precedente alla versione 9.5
Sì
PrestoDB
Sì
PrestoSQL
Sì
SAP HANA 2 e versioni successive
No
SingleStore
Sì
SingleStore 7 e versioni successive
Sì
Snowflake
Sì
Teradata
Sì
Trino
Sì
Vettoriale
Sì
Vertica
Sì

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 della query prima del download dei risultati. La selezione di questa opzione può velocizzare il download, poiché l'ordinamento di una query può avere un costo elevato per le prestazioni per determinati tipi di database.

L'opzione Rimuovi tutti gli ordinamenti 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 visualizzare l'opzione Consenti risultati di grandi dimensioni. Questo perché Google BigQuery ha una dimensione massima della risposta per i risultati delle query, come descritto nell'argomento della documentazione di Google Cloud Scrivere i risultati delle query. Per scaricare risultati che superano le dimensioni massime della risposta di BigQuery, Looker deve eseguire un processo diverso.

Se selezioni Consenti risultati di grandi dimensioni, la procedura di download viene interessata 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 PDT e richiede l'autorizzazione per farlo.
  • I risultati della query vengono memorizzati in questo schema scratch temporaneo con un nome di tabella casuale per un'ora.

Scaricare o aprire nel browser

Dopo aver selezionato le opzioni, puoi selezionare il pulsante Scarica per scaricare un file sul computer o Apri nel browser per visualizzarlo nel browser.

Scaricare i dati da una query sui risultati uniti

Per scaricare le query sui risultati uniti, puoi salvare la query 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 solo riquadro basato su una query sui risultati uniti.

Scaricare i 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 il formato PDF o CSV per il download.

Scaricare una dashboard come PDF

Puoi scaricare l'intera dashboard come file 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 del modello come se fosse in modalità Production (Produzione), anche se sei in modalità Development (Sviluppo).

Per scaricare una dashboard come file PDF:

  1. Seleziona PDF dal menu a discesa Formato.

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

    L'opzione Adatta pagina alla dashboard è l'opzione predefinita. Imposta le dimensioni del PDF in base alla larghezza predefinita per le dashboard (1260 px). Le altre opzioni di formato della carta adattano il PDF a un formato della carta standard e inseriscono al suo interno tutta o parte della dashboard. A seconda del layout della dashboard e del formato carta selezionato, alcuni output PDF potrebbero differire dal layout della dashboard quando vengono visualizzati in Looker. Ad esempio, se il formato carta selezionato è più stretto della 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 contenenti tabelle potrebbero non mostrare tutte le colonne della tabella nel PDF.
    • La larghezza dei riquadri potrebbe essere ridotta per adattarsi al PDF. Analogamente, i riquadri che richiedono lo scorrimento nell'app Looker potrebbero non espandersi per mostrare tutti i contenuti.

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

  3. Se nel menu a discesa Formato carta selezioni un'opzione diversa da Adatta pagina alla dashboard, viene visualizzata l'opzione Orientamento. Puoi scegliere di orientare la dashboard in posizione verticale o 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 tabellari, il PDF mostrerà tutte le righe disponibili nella visualizzazione tabellare, 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 delle 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 righe visualizzate.

    Se è selezionata l'opzione Espandi le tabelle per mostrare tutte le righe, i riquadri della dashboard contenenti visualizzazioni di tabelle 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 dei sottototali.
    • Se non è impostato alcun tema personalizzato, Tables viene visualizzato 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 con l'opzione Adatta dimensione colonne attivata si estendono per l'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 di Looker.

  5. Seleziona o deseleziona Disponi i riquadri della dashboard in una singola colonna. Se selezioni questa opzione, il PDF mostra i riquadri della dashboard in una singola colonna verticale. Se non selezioni questa opzione, i riquadri della dashboard vengono visualizzati come sono disposti nella dashboard.

  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.

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 dei riquadri corrispondenti.

Looker genera file compressi utilizzando la codifica UTF-8. Se i caratteri nei nomi dei file CSV risultano illeggibili, 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 consiglia di utilizzare un'applicazione di estrazione di file che riconosca l'UTF-8, ad esempio 7-Zip, e di assicurarsi che tutte le applicazioni di terze parti siano configurate per supportare l'UTF-8.

Scaricare i dati dai riquadri della dashboard

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

Per scaricare i dati da un riquadro della dashboard, seleziona l'icona con tre puntini sul 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 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 lavoro Excel (Excel 2007 o versioni successive)
  • CSV
  • JSON
  • HTML
  • Markdown
  • PNG (immagine di visualizzazione)

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

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

Per il formato JSON, Looker utilizza il campo etichette come valore visualizzato nell'output JSON. Per ulteriori informazioni sul modo in cui Looker visualizza i campi in formato JSON, consulta il post della community Modifica della formattazione JSON.

Le visualizzazioni delle tabelle trasposte vengono visualizzate solo nei download PDF e PNG.

I download in formato PNG restituiscono sempre i dati del modello così come sono in modalità Production (Produzione), anche se sei in modalità Development (Sviluppo).

Risultati

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

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

Valori dei dati

Nella sezione Valori dati, scegli come visualizzare i risultati scaricati:

  • Se scegli Formatted (Con formattazione), i dati avranno un aspetto molto più simile all'esperienza Explore (Esplora) di Looker, anche se alcune funzionalità (come il collegamento) non sono supportate da tutti i formati di 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 del riquadro contiene dimensioni pivotate, questa sezione è denominata Numero di righe e colonne da includere. Le opzioni disponibili sono:

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

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

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

Anche quando è disponibile l'opzione Tutti i risultati, devi comunque fare attenzione quando scarichi tutti i risultati. Alcune query sono molto grandi e contengono migliaia o milioni di righe, il che può sopraffare la maggior parte dei programmi di fogli di lavoro o persino la tua istanza di Looker.

Se l'opzione Tutti i risultati non è disponibile, puoi utilizzare l'opzione Personalizzata per specificare il numero massimo di righe consentito dalle tue autorizzazioni. Se selezioni Personalizzato, 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.

Per gli amministratori: abilitare il 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 di documentazione relativa alla gestione delle funzionalità per utenti aziendali contiene informazioni importanti per gli amministratori sulla procedura di download:

Per scoprire 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 Ruoli.