Fazendo o download do conteúdo

Nesta página, descrevemos como fazer o download de conteúdo (visualizações ou dados) no 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 de download e formatação variam de acordo com o download feito: de um Look ou de uma Análise, de um painel ou de uma consulta de resultados combinados.

Como fazer o download de dados de um Look ou uma Análise

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

O Looker mostra a janela Download, em que é possível nomear e formatar o download.

As seções a seguir contêm orientações sobre cada campo na janela Download:

Formatar

Os downloads para 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 vai mostrar resultados do modo de desenvolvimento ou produção em que você estiver.

É possível fazer o download dos dados em 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 de dados para download, se as opções de HTML ou PNG (imagem de visualização) (para Looks) não aparecerem, converse com o administrador do Looker sobre como instalar a versão apropriada do renderizador do Chromium para sua instância do Looker.

Para o formato JSON, o Looker usa rótulos de campo como o valor renderizado na saída JSON. Confira a postagem na Comunidade Mudança na formatação JSON para saber mais sobre como o Looker renderiza campos no formato JSON.

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

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

Nome do arquivo

Insira um nome de arquivo para o download ou use o nome de arquivo padrão que está pré-preenchido no campo. O Looker vai anexar 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 as configurações de visualização ao download de dados TXT, Excel, CSV, JSON, HTML ou Markdown.

Se você escolher Com opções de visualização aplicadas, o Looker aplicará algumas das configurações de visualização ao download. Qualquer uma das seguintes configurações nos menus Enredo, Série e Formatação configurados para a visualização será aplicada ao download dos dados:

A formatação condicional só vai aparecer nos envios de Looks e Explores com gráficos de tabela no Excel se a regra Ao longo de uma escala for aplicada.

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

  • A cor personalizada do texto do cabeçalho e do plano de fundo não são aplicados aos resultados baixados, exceto para arquivos PNG.
  • Nas 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. Downloads de HTML e PNG são uma exceção, portanto, a coluna mesclada é preservada.
  • Quando você faz o download de um painel, o título do bloco do painel não é incluído nos resultados baixados.
  • Os valores Totais e Totais das linhas estão incluídos nos resultados transferidos por download, mas as respectivas linhas e colunas não são rotuladas.
  • Não será feito o download dos subtotais para consultas que não podem ser transmitidas.

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

Se você escolher Como 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 os resultados da consulta salvos vão aparecer:

  • Se você escolher Não formatado, o Looker não vai aplicar nenhuma formatação especial aos resultados da consulta, como arredondar números longos ou adicionar caracteres especiais que os desenvolvedores do Looker possam ter usado. 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 a downloads TXT, CSV, Excel ou JSON.

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

Escolha a quantidade de dados que você quer transferir por download da seguinte maneira:

  • Tabela de resultados atual: número de linhas especificadas 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 as permissões download_with_limit estão limitados a 5.000 linhas. O limite para outros usuários normalmente é 100.000.

Todos os resultados

Quando você seleciona Executar em um Look ou uma Análise, o Looker verifica suas permissões e determina se a complexidade da consulta e o dialeto do banco de dados permitem o download de toda a consulta. Se você tiver as permissões (para 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 ficar 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 está disponível, tenha cuidado ao fazer o download de todos os resultados. Algumas consultas são muito grandes, com milhares ou milhões de linhas, o que pode sobrecarregar a maioria dos programas de planilhas 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 que são permitidas com suas permissões.

Como fazer streaming dos resultados da consulta

Streaming refere-se à capacidade do Looker de processar dados em partes, em vez de todos de uma vez. Se o Looker puder transmitir um conjunto de resultados, não há limites para os downloads. A opção Todos os resultados depende da capacidade do Looker de transmitir os resultados. Se não for possível fazer streaming dos resultados, a opção Todos os resultados só estará disponível.

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, você deve remover os cálculos de tabela da consulta.
  2. Limitações do banco de dados: alguns bancos de dados não podem fazer streaming se tabelas dinâmicas estiverem incluídas na consulta. Para esses bancos de dados, você precisa remover as tabelas dinâmicas para fazer o download de resultados ilimitados. Alguns bancos de dados não podem transmitir resultados, o que significa que não é possível fazer downloads ilimitados.

Estes bancos de dados oferecem suporte ao streaming:

Dialeto Compatível?
Avalanche Actian
Sim
Amazon Athena
Sim
MySQL do Amazon Aurora
Sim
Amazon Redshift
Sim
Apache Druid
No
Apache Druid 0.13 ou superior
No
Apache Druid 0.18 ou superior
No
Apache Hive 2.3 ou superior
Sim
Apache Hive 3.1.2 ou posterior
Sim
Apache Spark 3 ou mais recente
Sim
ClickHouse
Sim
Cloudera Impala 3.1 ou superior
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
Drêmio
Sim
Dremio 11 ou superior
Sim
Exasol
Sim
Bola de fogo
Sim
SQL legado do Google BigQuery
Sim
SQL padrão do Google BigQuery
Sim
PostgreSQL do Google Cloud
Sim
Google Cloud SQL
Sim
Google Spanner (em inglês)
No
Greenplum
Sim
HyperSQL
No
IBM Netezza
No
MariaDB
Sim
PostgreSQL do Microsoft Azure
Sim
Banco de dados SQL do Microsoft Azure
Sim
Análises do Microsoft Azure Synapse
Sim
Microsoft SQL Server 2008 ou superior
Sim
Microsoft SQL Server 2012 ou posterior
Sim
Microsoft SQL Server 2016
Sim
Microsoft SQL Server 2017 ou posterior
Sim
MongoBI
Sim
MySQL
Sim
MySQL 8.0.12 ou mais recente
Sim
Oracle
Sim
ADWC da Oracle
Sim
PostgreSQL 9.5 ou mais recente
Sim
PostgreSQL anterior à 9.5
Sim
PrestoDB
Sim
PrestoSQL
Sim
SAP HANA 2 ou posterior
No
SingleStore
Sim
SingleStore 7 ou superior
Sim
Snowflake
Sim
Teradata
Sim
Trino
Sim
Vetor
Sim
Vertica
Sim

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

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

Remover todas as classificações da consulta

Quando você seleciona Todos os resultados, também pode ver a opção Remover todas as classificações da consulta. Essa opção impede a classificação de sua consulta antes de você baixar os resultados. Selecionar essa opção pode acelerar seu download, já que a classificação de 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 oferece suporte a resultados dinâmicos.

Permitir resultados extensos

Quando você faz o download de um conjunto grande de resultados no Looker usando o Google BigQuery como o dialeto do banco de dados e seleciona Todos os resultados, a opção Permitir resultados extensos pode ser exibida. Isso ocorre porque o Google BigQuery tem um tamanho máximo de resposta para resultados de consulta, conforme descrito no tópico da documentação 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 está definida como true para a consulta.
  • As cláusulas ORDER BY na consulta são removidas.
  • A consulta vai gravar em um esquema temporário de TDP e requer permissão para isso.
  • Os resultados da consulta são armazenados nesse 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 suas opções, selecione o botão Fazer o download para salvar um arquivo no seu computador ou selecione Abrir no navegador para ver o arquivo no navegador.

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 uma coleção de arquivos CSV. No entanto, é preciso 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 mesclados.

Download de dados de um painel

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

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

Como fazer o download de um painel como PDF

Você pode fazer o download de todo o painel em PDF, o que significa que você receberá um PDF que mostra 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 painel foi baixado.

Os downloads no formato PDF sempre retornam dados do modelo como se ele estivesse 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 caber em 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 ter problemas com o espaçamento ou outra formatação e precisa fazer alguns ajustes:

    • Grandes visualizações 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 se expandir para mostrar todo o conteúdo.

    Se a opção Tamanho do papel não aparecer, converse com o administrador do Looker sobre como instalar a versão mais recente do renderizador do Chromium para sua instância do Looker.

  3. Se você selecionar algo diferente de Ajustar página ao painel na lista suspensa Tamanho do papel, uma opção Orientação será exibida. É possível orientar o dashboard 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, para blocos de painel que usam visualizações de tabela, o PDF vai mostrar todas as linhas disponíveis na visualização de tabela, não apenas as linhas que estão visíveis na miniatura do bloco do dashboard. Se você não selecionar essa opção, apenas as linhas que estão visíveis na miniatura sem rolagem aparecerão no PDF. Os filtros de painel e consulta ainda serão aplicados, assim como as configurações de visualização, como limites de linhas, limites de colunas 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 tabelas poderão parecer um pouco diferentes nos PDFs transferidos por download do que no Looker. As seguintes diferenças podem ser perceptíveis no PDF:

    • As personalizações de cores de plano de fundo e tamanhos de fonte são removidas dos cabeçalhos das colunas e das linhas de subtotal.
    • Se nenhum tema personalizado for definido, as tabelas vão aparecer no tema em branco. Caso contrário, o tema personalizado será aplicado após o download.
    • O ícone de classificação não aparece em tabelas dinâmicas que não foram classificadas manualmente.
    • As tabelas com a opção Dimensionar colunas para ajustar ativada são esticadas 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, converse com o administrador do Looker sobre como instalar a versão apropriada do renderizador do Chromium para sua 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á os blocos do dashboard em uma única coluna vertical. Se você não selecionar essa opção, os blocos do dashboard aparecem conforme são organizados no painel.

  6. Selecione Abrir no navegador para ver uma imagem do PDF em uma nova guia do navegador. A partir daí, você pode optar por fazer o download do PDF usando os controles do seu navegador.

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

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

Como fazer o download de um painel como CSVs

Você pode fazer download de todos os blocos de consulta do seu painel como uma coleção compactada de arquivos CSV. Os 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 não quiser mais fazer o download do painel.
  3. Selecione Fazer o download para iniciar o download da sua coleção CSV compactada.

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

O Looker gera arquivos compactados usando a codificação UTF-8. Se os caracteres nos nomes de arquivos CSV parecerem truncados, pode haver um conflito entre a codificação UTF-8 do Looker e a codificação padrão do sistema operacional do seu computador ou de um aplicativo de terceiros. O Looker sugere o uso de um extrator de arquivos que reconheça o UTF-8, como o 7-Zip, e confirme se os aplicativos de terceiros têm suporte a UTF-8.

Download de dados de blocos do painel de controle

Não é possível fazer o download dos dados dos blocos do dashboard com base em consultas de resultados mesclados, mas os dados dos blocos de resultados mesclados são incluídos se você faz o download de um dashboard 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 semelhantes às de um Look ou de uma Análise. Expanda o menu Opções de dados avançadas para ver todas as opções disponíveis para download:

Formatar

Os dados podem ser baixados dos blocos do painel de controle 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 de HTML ou PNG (imagem da visualização) não estiverem disponíveis, converse com o administrador do Looker sobre como instalar a versão correta do renderizador do Chromium para sua instância do Looker.

Para o formato JSON, o Looker usa rótulos de campo como o valor renderizado na saída JSON. Confira a postagem na Comunidade Mudança na formatação JSON para saber mais sobre como o Looker renderiza campos no formato JSON.

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

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

Resultados

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

Se você escolher Como 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 do download apareçam:

  • Se você escolher Formatado, os dados serão mais parecidos 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 vai aplicar nenhuma formatação especial aos resultados, como arredondar números longos ou adicionar caracteres especiais que os desenvolvedores do Looker possam ter usado. 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

É possível especificar a quantidade de dados incluídos no download nessa seção. Na maioria dos blocos, essa seção do pop-up de download é chamada de Número de linhas a incluir. Se a consulta de bloco contiver qualquer dimensão dinâmica, esta seção será chamada de Número de linhas e colunas a serem incluídas. Suas opções incluem:

Considerações ao usar a opção "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 permitem fazer o download de toda a consulta. Se você tiver permissão para fazer o download de 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 ficar 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 está disponível, tenha cuidado ao fazer o download de todos os resultados. Algumas consultas são muito grandes, com milhares ou milhões de linhas, o que pode sobrecarregar a maioria dos programas de planilhas 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, especifique o número de linhas de resultados que serão transferidas por download. Se a consulta contiver dimensões dinâmicas, também será possível especificar um número de colunas para download.

Para administradores: como ativar o download de dados para 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 sobre o processo de download para administradores:

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

Para reduzir o tempo de renderização de downloads de PDF nos painéis que contêm visualizações de tabelas com muitas linhas, os administradores do Looker podem ativar o recurso Labs Renderizar tabelas longas.