Fazendo o download do conteúdo

Esta página descreve o download de conteúdo (visualizações ou dados) do Looker.

Para fazer o download de conteúdo, você precisa receber a permissão download_with_limit ou download_without_limit de um administrador do Looker.

O processo e as opções para download e formatação do conteúdo transferido por download variam dependendo se você está fazendo o download de um Look ou Explore, de um painel ou de uma consulta de resultados mesclados.

Como fazer o download de dados de um Look ou Explore

Para fazer o download dos dados de uma página "Look" ou "Explore", selecione o menu de engrenagem no canto superior direito e clique em Fazer o download.

O Looker exibe a janela Download, onde é possível nomear e formatar o download.

As seções a seguir explicam cada campo na janela Download:

Formato

Os downloads em formatos que usam o renderizador (PNG e PDF) usarão os resultados do Modo de produção. Se o download estiver em outro formato, ele mostrará os resultados do modo (desenvolvimento ou produção) em que você estiver.

É possível fazer o download de dados de Looks e Explores nos seguintes formatos de arquivo:

  • TXT (valores separados por tabulação)
  • Planilha do Excel (Excel 2007 ou posterior)
  • CSV
  • JSON
  • HTML
  • Marcação
  • PNG (imagem da visualização)

Ao escolher o formato dos dados para download, se você não encontrar as opções HTML ou PNG (imagem de visualização) (para Looks), fale com seu administrador do Looker sobre como instalar a versão adequada do renderizador Chromium para sua instância do Looker.

Para o formato JSON, o Looker usa labels de campo como o valor renderizado na saída JSON. Consulte a postagem na Comunidade Alteração na formatação JSON para mais informações sobre como o Looker renderiza campos no formato JSON.

As tabelas transpostas serão renderizadas apenas em downloads de PNG.

Para desenvolvedores do Looker, se você estiver no Modo de Desenvolvimento, os downloads de dados na maioria dos formatos de arquivo vão consultar seu modelo como está no Modo de Desenvolvimento. Os formatos de arquivo PDF e PNG são a exceção; os downloads de dados nesses formatos de arquivo sempre consultam seu modelo como se ele estivesse no Modo de Produção.

Nome do arquivo

Você pode inserir um nome de arquivo para o download ou usar o nome de arquivo padrão previamente preenchido no campo. O Looker anexa automaticamente a extensão de arquivo adequada com base na sua seleção no campo Formato.

Resultados

Na seção Resultados, escolha se você quer aplicar configurações de visualização ao download de dados TXT, Excel, CSV, JSON, HTML ou Markdown.

Se você escolher Com as opções de visualização aplicadas, o Looker vai aplicar algumas das configurações de visualização ao download. Todas as configurações a seguir nos menus Gráfico, Série e Formatação definidas para a visualização serão aplicadas ao download dos dados:

A formatação condicional vai aparecer nos envios do Excel de Looks e Explores com visualizações de gráfico de tabela somente se a Along a scale Rule for aplicada.

Algumas configurações de visualização não são aplicadas aos resultados transferidos por download. Exemplo:

  • As cores de texto e de fundo personalizadas do cabeçalho não são aplicadas aos resultados baixados, exceto para arquivos PNG.
  • Para tabelas de resultados com tabelas dinâmicas e várias medidas, cada valor dinâmico é repetido em colunas em vez de representado como uma coluna mesclada. Os downloads de HTML e PNG são uma exceção. Portanto, a coluna mesclada é preservada.
  • Ao fazer o download a partir de um painel de controle, o título do bloco do dashboard não é incluído nos resultados baixados.
  • Os valores Totais e Totais de linhas estão incluídos nos resultados baixados, mas a linha e as colunas respectivas não são rotuladas.

As colunas nos gráficos de tabela que foram reorganizadas manualmente vão aparecer na ordem original no download se a consulta incluir qualquer um dos seguintes elementos:

Se você escolher Conforme exibido na tabela de dados, as opções de visualização não serão aplicadas, e o download aparecerá como a tabela de dados na seção Dados do Look ou da Análise.

Valores de dados

Na seção Valores de dados, escolha como você quer que os resultados da consulta do download apareçam:

  • Se você escolher Não formatado, o Looker não aplicará nenhuma formatação especial dos resultados da consulta, como arredondar números longos ou adicionar caracteres especiais que os desenvolvedores do Looker possam ter aplicado. Isso geralmente é preferível quando os dados são enviados para processamento em outra ferramenta.
  • Se você escolher Formatado, a aparência dos dados será semelhante à experiência de Análise no Looker, embora alguns recursos, como a vinculação, não sejam compatíveis com todos os tipos de arquivo. Por exemplo, nenhuma formatação aplicada com o parâmetro html será aplicada aos downloads TXT, CSV, Excel ou JSON.

Número de linhas e colunas a serem incluídas

É possível escolher a quantidade de dados que você quer transferir por download da seguinte maneira:

  • Tabela de resultados atual: número de linhas especificado pelo limite de linhas do seu conteúdo.
  • Todos os resultados: todos os resultados retornados pela consulta. Antes de selecionar essa opção, consulte a seção Todos os resultados nesta página.
  • Personalizado: é um número personalizado de linhas. Os usuários com permissões do download_with_limit são limitados a 5.000 linhas. O limite para outros usuários é normalmente de 100.000.

Todos os resultados

Quando você seleciona Executar em um Look ou em uma Análise, o Looker verifica suas permissões e determina se a complexidade da consulta e o dialeto do banco de dados vai permitir o download de toda a consulta. Se você tiver as permissões (para resultados acima do limite definido) e o Looker determinar que é possível fazer o download de toda a consulta, a opção Todos os resultados vai estar disponível na janela Download.

A opção Todos os resultados normalmente fica desativada para consultas que realizam alguma das seguintes ações:

Mesmo quando a opção Todos os resultados estiver disponível, tenha cuidado ao fazer o download de todos os resultados. Algumas consultas são muito grandes, contendo milhares ou milhões de linhas, o que pode sobrecarregar a maioria dos programas de planilha ou até mesmo sua instância do Looker.

Se a opção Todos os resultados não estiver disponível, use a opção Personalizado para especificar o número máximo de linhas permitidas com suas permissões.

Resultados da consulta de streaming

Streaming se refere à capacidade do Looker de processar dados em partes, em vez de tudo de uma vez. Se o Looker puder transmitir um conjunto de resultados, downloads ilimitados serão possíveis. A opção Todos os resultados depende da capacidade do Looker de transmitir os resultados. A opção Todos os resultados não vai estar disponível se o streaming de resultados não for possível.

O Looker faz o streaming dos resultados salvos em todos os formatos, exceto os renderizados (HTML, PNG).

Além das limitações de formato, há dois casos em que o streaming não é possível:

  1. Cálculos de tabela: não é possível fazer streaming de cálculos de tabela. Portanto, para fazer o download de resultados ilimitados para uma consulta, remova os cálculos de tabela da consulta.
  2. Limitações do banco de dados: alguns bancos de dados não podem fazer streaming se as tabelas dinâmicas estiverem incluídas na consulta. Para esses bancos de dados, você deve remover tabelas dinâmicas para baixar resultados ilimitados. Alguns bancos de dados não podem transmitir nenhum resultado, o que significa que downloads ilimitados não são possíveis.

Estes bancos de dados dão suporte a streaming:

Dialeto Compatível?
Avalanche
Sim
Amazon Athena
Sim
MySQL do Amazon Aurora
Sim
Amazon Redshift
Sim
Apache Druid
Não
Apache Druid 0.13 ou superior
Não
Apache Druid 0.18 ou superior
Não
Apache Hive 2.3 ou superior
Sim
Apache Hive 3.1.2 ou superior
Sim
Apache Spark 3 ou mais recente
Sim
ClickHouse
Sim
Cloudera Impala 3.1 ou mais recente
Sim
Cloudera Impala 3.1+ com driver nativo
Sim
Cloudera Impala com driver nativo
Sim
DataVirtuality
Sim
Databricks
Sim
Denodo 7
Sim
Denodo 8
Sim
Dremio
Sim
Dremio 11 ou mais recente
Sim
Exasol
Sim
Fio de fogo
Sim
SQL legado do Google BigQuery
Sim
SQL padrão do Google BigQuery
Sim
PostgreSQL no Google Cloud
Sim
Google Cloud SQL
Sim
Google Spanner
Não
Verde ameixa
Sim
HyperSQL
Não
IBM Netezza
Não
MariaDB
Sim
PostgreSQL do Microsoft Azure
Sim
Banco de dados SQL do Microsoft Azure
Sim
Análise do Microsoft Azure Synapse
Sim
Microsoft SQL Server 2008 ou mais recente
Sim
Microsoft SQL Server 2012 ou mais recente
Sim
Microsoft SQL Server 2016
Sim
Microsoft SQL Server 2017 ou mais recente
Sim
MongoBI
Sim
MySQL
Sim
MySQL 8.0.12 ou superior
Sim
Oracle
Sim
ADWC do Oracle
Sim
PostgreSQL 9.5 ou mais recente
Sim
PostgreSQL anterior à versão 9.5
Sim
PrestoDB
Sim
PrestoSQL
Sim
SAP HANA
Não
SAP HANA 2 ou posterior
Não
SingleStore
Sim
SingleStore 7 ou mais recente
Sim
Snowflake
Sim
Teradata
Sim
Trino
Sim
Vetor
Sim
Vertica
Sim

Estes são os bancos de dados que oferecem suporte a streaming com tabelas dinâmicas aplicadas:

Dialeto Compatível?
Avalanche
Sim
Amazon Athena
Sim
MySQL do Amazon Aurora
Não
Amazon Redshift
Sim
Apache Druid
Não
Apache Druid 0.13 ou superior
Não
Apache Druid 0.18 ou superior
Não
Apache Hive 2.3 ou superior
Não
Apache Hive 3.1.2 ou superior
Não
Apache Spark 3 ou mais recente
Sim
ClickHouse
Não
Cloudera Impala 3.1 ou mais recente
Sim
Cloudera Impala 3.1+ com driver nativo
Sim
Cloudera Impala com driver nativo
Sim
DataVirtuality
Não
Databricks
Sim
Denodo 7
Não
Denodo 8
Não
Dremio
Não
Dremio 11 ou mais recente
Não
Exasol
Sim
Fio de fogo
Sim
SQL legado do Google BigQuery
Sim
SQL padrão do Google BigQuery
Sim
PostgreSQL no Google Cloud
Sim
Google Cloud SQL
Não
Google Spanner
Não
Verde ameixa
Sim
HyperSQL
Não
IBM Netezza
Sim
MariaDB
Não
PostgreSQL do Microsoft Azure
Sim
Banco de dados SQL do Microsoft Azure
Sim
Análise do Microsoft Azure Synapse
Sim
Microsoft SQL Server 2008 ou mais recente
Sim
Microsoft SQL Server 2012 ou mais recente
Sim
Microsoft SQL Server 2016
Sim
Microsoft SQL Server 2017 ou mais recente
Sim
MongoBI
Não
MySQL
Não
MySQL 8.0.12 ou superior
Não
Oracle
Sim
ADWC do Oracle
Sim
PostgreSQL 9.5 ou mais recente
Sim
PostgreSQL anterior à versão 9.5
Sim
PrestoDB
Sim
PrestoSQL
Sim
SAP HANA
Não
SAP HANA 2 ou posterior
Não
SingleStore
Sim
SingleStore 7 ou mais recente
Sim
Snowflake
Sim
Teradata
Sim
Trino
Sim
Vetor
Sim
Vertica
Sim

Remover todas as classificações da consulta

Ao selecionar Todos os resultados, também é possível ver a opção Remover todas as classificações da consulta. Essa opção impede que sua consulta seja classificada antes de fazer o download dos resultados. Selecionar essa opção pode acelerar o download, já que classificar uma consulta pode custar caro para o desempenho de certos tipos de banco de dados.

A opção Remover todas as classificações da consulta não é compatível com resultados dinâmicos.

Permitir resultados extensos

Quando você faz o download de um conjunto de resultados grande no Looker usando o Google BigQuery como dialeto do banco de dados e seleciona Todos os resultados, a opção Permitir resultados extensos aparece. Isso ocorre porque o Google BigQuery tem um tamanho máximo de resposta para os resultados da consulta, conforme descrito no tópico Gravar resultados da consulta do Google Cloud. Para fazer o download de resultados que excedem o tamanho máximo da resposta do BigQuery, o Looker precisa executar um processo diferente.

Se você selecionar Permitir resultados extensos, o processo de download será afetado da seguinte maneira:

  • A opção allowLargeResults do BigQuery é definida como true para a consulta.
  • As cláusulas ORDER BY na consulta são removidas.
  • A consulta será gravada em um esquema temporário de TDP e requer permissão para gravar em um.
  • Os resultados da consulta são armazenados neste esquema de rascunho temporário, sob um nome de tabela aleatório, por uma hora.

Fazer o download ou abrir no navegador

Depois de selecionar as opções, clique no botão Fazer o download para salvar um arquivo no seu computador ou selecione Abrir no navegador para abrir o arquivo.

Como fazer o download de dados de uma consulta de resultados mesclados

Para fazer o download de consultas de resultados mesclados, salve a consulta em um painel e faça o download do painel como um PDF ou como uma coleção de arquivos CSV. No entanto, é necessário fazer o download de todo o painel. Não é possível fazer o download dos dados de apenas um bloco baseado em uma consulta de resultados combinados.

Fazer o download de dados de um painel

Para fazer o download do painel inteiro, selecione Fazer o download no menu de três pontos do painel.

Isso abre uma caixa de diálogo que permite selecionar PDF ou CSV como o formato do download.

Como fazer o download de um painel como PDF

Os downloads de PDF podem não corresponder exatamente ao layout ou tamanho do painel que aparece no Looker.

É possível fazer o download de todo o seu painel de controle como PDF, o que significa que você receberá um PDF que exibe o título do painel, todos os filtros do painel, alguns ou todos os blocos do painel e o fuso horário em que o painel foi executado. O PDF também vai incluir um carimbo de data/hora que mostra quando o download do painel foi feito.

Os downloads em formato PDF sempre retornam dados do modelo no Modo de Produção, mesmo que você esteja no Modo de Desenvolvimento.

Para fazer o download de um painel como PDF, siga estas etapas:

  1. Selecione PDF no menu suspenso Formato.

  2. Selecione uma opção no menu suspenso Tamanho do papel:

    A opção Ajustar página ao painel é o padrão. Ela dimensiona o PDF de acordo com a largura padrão dos painéis (1260 px). Outras opções de tamanho de papel dimensionam o PDF para corresponder a um tamanho de papel padrão e ajustar todo o painel ou parte dele. Dependendo do layout do painel e do tamanho do papel selecionado, algumas saídas em PDF podem ser diferentes do layout do painel quando visualizadas no Looker. Por exemplo, quando o tamanho do papel selecionado é mais estreito que o painel, você pode encontrar problemas com o espaçamento ou outra formatação e precisar fazer alguns ajustes:

    • Visualizações grandes ou grupos de blocos sobrepostos podem precisar ser redimensionados para caber no PDF.
    • Os blocos que contêm tabelas podem não mostrar todas as colunas da tabela no PDF.
    • Os blocos podem ter a largura reduzida para se ajustarem ao PDF. Da mesma forma, os blocos que exigem rolagem no app Looker podem não ser expandidos para mostrar todo o conteúdo.

    Se a opção Tamanho do papel não estiver disponível, converse com seu administrador do Looker sobre a instalação da versão mais recente do renderizador do Chromium na instância do Looker.

  3. Se você selecionar algo diferente de Ajustar página ao painel no menu suspenso Tamanho do papel, será exibida uma opção Orientação. Você pode orientar o painel na posição retrato ou paisagem.

  4. Marque ou deixe a opção Expandir tabelas para mostrar todas as linhas desmarcada. Se você selecionar essa opção, o PDF vai mostrar todas as linhas disponíveis na visualização de tabela dos blocos do dashboard que usam visualizações de tabela, não apenas as que aparecem na miniatura do bloco do dashboard. Se você não selecionar essa opção, apenas as linhas visíveis na miniatura sem rolagem serão exibidas no PDF. Os filtros de consulta e painel ainda serão aplicados, assim como as configurações de visualização, como limites de linhas, limites de coluna e configurações feitas com a opção Limitar linhas exibidas.

    Se a opção Expandir tabelas para mostrar todas as linhas estiver selecionada, os blocos do painel que contêm visualizações de tabela podem ter uma aparência um pouco diferente nos PDFs transferidos por download do que no Looker. As seguintes diferenças podem ser perceptíveis no PDF:

    • As personalizações das cores de fundo e tamanhos de fonte foram removidas dos cabeçalhos das colunas e das linhas do subtotal.
    • Se nenhum tema personalizado for definido, as tabelas vão aparecer no tema branco. Caso contrário, o tema personalizado será aplicado após o download.
    • O ícone de classificação não aparece nas tabelas dinâmicas que não foram classificadas manualmente.
    • As tabelas com a opção Dimensionar colunas para caber ativada se estendem até a largura total do bloco.

    Além disso, para tabelas com mais de 20.000 células, as seguintes diferenças podem ser perceptíveis no PDF:

    Se a opção Expandir tabelas para mostrar todas as linhas não aparecer, entre em contato com seu administrador do Looker para saber como instalar a versão adequada do renderizador do Chromium na instância do Looker.

  5. Marque ou deixe a opção Organizar blocos do dashboard em uma única coluna desmarcada. Se você selecionar essa opção, o PDF exibirá blocos do dashboard em uma única coluna vertical. Se você não selecionar essa opção, os blocos do painel de controle aparecerão conforme estiverem organizados no painel de controle.

  6. Selecione Abrir no navegador para abrir uma imagem do PDF em uma nova guia do navegador. Nessa página, é possível fazer o download do PDF usando os controles do navegador.

  7. Selecione Cancelar se você não quiser mais fazer o download do painel.

  8. Selecione Fazer o download para iniciar o download. Uma nova guia será aberta no navegador, mostrando o status do download.

Se o administrador do Looker tiver ativado o recurso de laboratórios Renderizar tabelas longas e a opção Expandir tabelas para mostrar todas as linhas estiver selecionada, os blocos que contêm visualizações de tabela vão ficar um pouco diferentes nos PDFs transferidos por download. Para saber mais sobre as diferenças, acesse a página de documentação do Labs.

Como fazer o download de um painel como CSVs

Você pode baixar todos os blocos de consulta do seu painel de controle como uma coleção compactada de arquivos CSV. Blocos de texto não estão incluídos no arquivo ZIP. Para fazer o download do painel como um conjunto de arquivos CSV, siga estas etapas:

  1. Selecione CSV no menu suspenso Formato.
  2. Selecione Cancelar se você não quiser mais fazer o download do painel.
  3. Selecione Download para iniciar o download da sua coleção de CSV compactado.

Quando você faz o download de um painel como arquivos CSV, as opções de formatação dos downloads, como definir limites de linhas personalizadas ou escolher todos os resultados, ficam indisponíveis. Os limites de linha nos arquivos transferidos por download estão correlacionados aos limites de linhas nos blocos correspondentes.

O Looker gera arquivos compactados usando a codificação UTF-8. Se os caracteres nos nomes dos arquivos CSV aparecerem truncados, pode haver um conflito entre a codificação UTF-8 do Looker e a codificação padrão do sistema operacional da sua máquina ou um aplicativo de terceiros. O Looker sugere que você use um extrator de arquivos que reconheça UTF-8, como 7-Zip, e garanta que todos os aplicativos de terceiros estejam configurados para aceitar UTF-8.

Download de dados dos blocos do dashboard

Não é possível fazer o download dos dados dos blocos do painel com base em consultas de resultados mesclados, mas os dados dos blocos de resultados mesclados serão incluídos se você fazer o download de um painel como PDF ou como uma coleção de arquivos CSV.

Para fazer o download dos dados de um bloco do painel, selecione o ícone de três pontos no bloco e escolha Fazer o download dos dados:

Isso abre uma caixa de diálogo com várias opções parecidas com as de Look ou Explore. Abra o menu Opções de dados avançadas para conferir todas as opções disponíveis para download:

Formato

Os dados podem ser baixados dos blocos do dashboard nos seguintes formatos:

  • TXT (valores separados por tabulação)
  • Planilha do Excel (Excel 2007 ou posterior)
  • CSV
  • JSON
  • HTML
  • Marcação
  • PNG (imagem da visualização)

Dependendo do formato selecionado, algumas opções no menu Opções de dados avançadas podem não estar disponíveis.

Se as opções HTML ou PNG (imagem da visualização) não estiverem disponíveis, entre em contato com seu administrador do Looker para saber como instalar a versão adequada do renderizador do Chromium para sua instância do Looker.

Para o formato JSON, o Looker usa labels de campo como o valor renderizado na saída JSON. Consulte a postagem na Comunidade Alteração na formatação JSON para mais informações sobre como o Looker renderiza campos no formato JSON.

As visualizações de tabelas transpostas serão renderizadas apenas nos downloads em PDF e PNG.

Os downloads no formato PNG sempre retornam dados do modelo no Modo de Produção, mesmo que você esteja no Modo de Desenvolvimento.

Resultados

Na seção Resultados, escolha se você quer que as configurações de visualização sejam aplicadas ao download dos dados:

Se você escolher Conforme exibido na tabela de dados, as opções de visualização não serão aplicadas, e o download aparecerá como a tabela de dados na seção Dados do Look ou da Análise.

Valores de dados

Na seção Valores de dados, escolha como você quer que os resultados salvos apareçam:

  • Se você escolher Formatado, os dados vão aparecer de forma mais parecida com a experiência de Análise no Looker, embora alguns recursos, como a vinculação, não sejam compatíveis com todos os formatos de arquivo.
  • Se você escolher Não formatado, o Looker não aplicará nenhuma formatação especial dos seus resultados, como arredondar números longos ou adicionar caracteres especiais que os desenvolvedores do Looker possam ter aplicado. Isso geralmente é preferível quando os dados são enviados para processamento em outra ferramenta.

Número de linhas e colunas a serem incluídas

Nessa seção, é possível especificar quantos dados serão incluídos no seu download. Na maioria dos blocos, essa seção do pop-up de download é chamada de Número de linhas a serem incluídas. Se a consulta de bloco contiver dimensões dinâmicas, a seção será chamada de Número de linhas e colunas a serem incluídas. As opções incluem:

Considerações ao usar as opções "Todos os resultados" ou "Personalizado"

O Looker verifica suas permissões e determina se a complexidade da consulta e o dialeto do banco de dados vão permitir o download de toda a consulta. Se você tiver permissão para fazer o download dos resultados acima de um limite definido e o Looker determinar que é possível fazer o download de toda a consulta, a opção Todos os resultados vai estar disponível na janela Fazer o download.

A opção Todos os resultados normalmente fica desativada para consultas que:

Mesmo quando a opção Todos os resultados estiver disponível, tenha cuidado ao fazer o download de todos os resultados. Algumas consultas são muito grandes, contendo milhares ou milhões de linhas, o que pode sobrecarregar a maioria dos programas de planilha ou até mesmo sua instância do Looker.

Se a opção Todos os resultados não estiver disponível, use a opção Personalizado para especificar o número máximo de linhas permitidas com suas permissões. Ao selecionar Personalizado, você pode especificar várias linhas de resultados para download. Se sua consulta contém dimensões dinâmicas, você também pode especificar várias colunas para fazer o download.

Para administradores: ativação do download de dados na sua instância do Looker

Algumas opções de download exigem que os administradores de implantações do Looker hospedadas pelo cliente tenham instalado a versão adequada do renderizador do Chromium. Se a instância for hospedada pelo Looker, o Chromium já estará instalado.

A página de documentação Como gerenciar recursos de usuários comerciais tem informações importantes de administrador sobre o processo de download:

Para saber mais sobre as permissões que precisam ser atribuídas aos usuários para permitir o download, especificamente as permissões download_with_limit e download_without_limit, acesse a página de documentação Funções.

Para reduzir o tempo de renderização dos downloads de PDF em painéis que contêm visualizações de tabela com muitas linhas, os administradores do Looker podem ativar o recurso de laboratórios Renderização de tabelas longas.