Download dei contenuti

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.

Il processo e le opzioni disponibili 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.

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) 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 file:

  • TXT (valori delimitati da tabulazioni)
  • Foglio di lavoro di 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 le etichette dei campi 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 verranno visualizzate solo nei download in formato 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. Fanno eccezione i formati file PDF e PNG; i download di dati in questi formati file eseguono sempre query sul 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 le opzioni di visualizzazione applicate, Looker applica alcune delle impostazioni di visualizzazione al 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 verrà mostrata nei caricamenti Excel di Look ed esplorazioni con visualizzazioni di grafici a tabella solo se viene applicata la regola A 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 del pivot viene ripetuto nelle colonne anziché essere rappresentato come una colonna unita. I download di file HTML e PNG sono un'eccezione, pertanto la colonna unita viene mantenuta.
  • 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 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 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 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 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

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 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.

In genere, l'opzione Tutti i risultati viene disattivata per le query che:

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.

Risultati delle query in modalità flusso

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: non è possibile riprodurre in streaming i calcoli tabulari. 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 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 alcun risultato in streaming, il che significa che non sono possibili download illimitati.

Questi database supportano i flussi di dati:

Dialetto Supportato?
Valanga Actia
Sì
Amazon Athena
Sì
Amazon Aurora MySQL
Sì
Amazon Redshift
Sì
Apache Druid
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 e 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
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 o 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 pre-9.5
Sì
PrestoDB
Sì
PrestoSQL
Sì
SAP HANA 2 o versioni successive
No
SingleStore
Sì
SingleStore 7 e versioni successive
Sì
Snowflake
Sì
Teradata
Sì
Trino
Sì
Vettoriale
Sì
Vertica
Sì

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

Dialetto Supportato?
Valanga Actia
Sì
Amazon Athena
Sì
Amazon Aurora MySQL
No
Amazon Redshift
Sì
Apache Druid
No
Apache Druid 0.13 o versioni successive
No
Apache Druid 0.18 o 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
Sì
ClickHouse
No
Cloudera Impala 3.1 e 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 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 pre-9.5
Sì
PrestoDB
Sì
PrestoSQL
Sì
SAP HANA 2 o 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 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 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 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 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à su uno schema temporaneo PPT e richiede l'autorizzazione per scrivere su uno.
  • 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.

Download dei dati da una query dei risultati unita

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 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 come 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 delle 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). 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 del formato carta selezionato, alcuni output PDF potrebbero differire dal layout della dashboard quando vengono 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:

    • 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 può 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 selezioni un'opzione diversa da Adatta pagina alla dashboard nel menu a discesa Formato carta, viene visualizzata un'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 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 tabelle potrebbero avere un aspetto leggermente diverso nei PDF scaricati rispetto a quelli 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 momento del download.
    • L'icona di ordinamento non viene visualizzata nelle tabelle pivot non 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 Looker.

  5. Seleziona o deseleziona 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 selezioni questa opzione, i riquadri della dashboard vengono visualizzati come sono disposti nella dashboard.

  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, 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 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.

Scaricare i 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 aprirà 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 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 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 dati, scegli come visualizzare 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 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 Personalizzato

Looker controlla le tue autorizzazioni e determina se la complessità della query e il dialetto del database consentono di scaricare l'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 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 Personalizzato per specificare il numero massimo di righe consentite con le tue autorizzazioni. Quando selezioni Personalizzato, puoi specificare un numero di righe di risultati da scaricare. Se la 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 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 consentirne il download, in particolare le autorizzazioni download_with_limit e download_without_limit, visita la pagina della documentazione Ruoli.