Como fazer o download de 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 de uma Análise, selecione o menu de engrenagem no canto superior direito e clique em Fazer o download.

O Looker mostra a janela Download, onde você pode nomear e formatar o download.

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

Formato

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 os resultados do modo em que você está: desenvolvimento ou produção.

É possível fazer o download de dados de Análises e Análises detalhadas nos seguintes formatos de arquivo:

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

Ao escolher o formato de dados para download, se você não encontrar as opções HTML ou PNG (imagem de visualização) (para o Looker), converse com o administrador do Looker sobre a instalação da versão adequada 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. downloads de dados nesses formatos sempre consultam o 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 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 Results, escolha se você quer aplicar as configurações de visualização ao download de dados em 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 Plot, Series e Formatting que forem configuradas para a visualização será aplicada ao download de dados:

A formatação condicional vai aparecer nos envios do Excel de Análises e Visualizações de gráficos de tabelas somente se a regra Along a scale for aplicada.

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

  • A cor do texto e do plano de fundo do cabeçalho personalizado não são aplicadas aos resultados transferidos por download, 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.
  • Os valores de Totals e Row Totals são incluídos nos resultados do download, mas as respectivas linhas e colunas não são identificadas.
  • Os subtotais não serão transferidos para consultas que não podem ser transmitidas em fluxo.

As colunas em tabelas que foram reorganizadas manualmente vão aparecer na ordem original no download se a consulta incluir qualquer um dos seguintes elementos:

Se você escolher Como mostrado na tabela de dados, as opções de visualização não serão aplicadas e o download vai aparecer como a tabela de dados na seção Dados de "Look" ou "Explore".

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

Você pode escolher quantos dados quer fazer o download da seguinte forma:

  • 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 permissões download_with_limit são limitados a 5.000 linhas. O limite para outros usuários normalmente é 100.000.

Todos os resultados

Quando você seleciona Executar em uma Análise ou uma Análise detalhada, o Looker verifica suas permissões e determina se a complexidade da consulta e o dialeto do banco de dados permitem que a consulta inteira seja transferida por download. Se você tiver as permissões (para resultados acima de um limite definido) e o Looker determinar que a consulta inteira pode ser salva, 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:

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

O 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, será possível fazer downloads ilimitados. A opção Todos os resultados depende da capacidade do Looker de transmitir resultados. Ela não estará disponível se não for possível transmitir resultados.

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

  1. Cálculos de tabela: não é possível fazer streaming deles. 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, é necessário remover os pivots 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?
Actian Avalanche
Sim
Amazon Athena
Sim
MySQL do Amazon Aurora
Sim
Amazon Redshift
Sim
Apache Druid
Não
Apache Druid 0.13 ou mais recente
Não
Apache Druid 0.18 ou superior
Não
Apache Hive 2.3 ou mais recente
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
Dremio
Sim
Dremio 11 ou mais recente
Sim
Exasol
Sim
Firebolt
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
Não
Greenplum
Sim
HyperSQL
Não
IBM Netezza
Não
MariaDB
Sim
PostgreSQL do Microsoft Azure
Sim
Banco de Dados SQL do Microsoft Azure
Sim
Microsoft Azure Synapse Analytics
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 posterior
Sim
MongoBI
Sim
MySQL
Sim
MySQL 8.0.12 ou mais recente
Sim
Oracle
Sim
Oracle ADWC
Sim
PostgreSQL 9.5 ou mais recente
Sim
PostgreSQL anterior à 9.5
Sim
PrestoDB
Sim
PrestoSQL
Sim
SAP HANA 2+
Não
SingleStore
Sim
SingleStore 7+
Sim
Snowflake
Sim
Teradata
Sim
Trino
Sim
Vetor
Sim
Vertica
Sim

Estes são os bancos de dados compatíveis com o streaming com pivots aplicados:

Dialeto Compatível?
Actian Avalanche
Sim
Amazon Athena
Sim
MySQL do Amazon Aurora
Não
Amazon Redshift
Sim
Apache Druid
Não
Apache Druid 0.13 ou mais recente
Não
Apache Druid 0.18 ou superior
Não
Apache Hive 2.3 ou superior
Não
Apache Hive 3.1.2 ou posterior
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
Firebolt
Sim
SQL legado do Google BigQuery
Sim
SQL padrão do Google BigQuery
Sim
PostgreSQL do Google Cloud
Sim
Google Cloud SQL
Não
Google Spanner (em inglês)
Não
Greenplum
Sim
HyperSQL
Não
IBM Netezza
Sim
MariaDB
Não
Microsoft Azure PostgreSQL
Sim
Banco de Dados SQL do Microsoft Azure
Sim
Microsoft Azure Synapse Analytics
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 posterior
Sim
MongoBI
Não
MySQL
Não
MySQL 8.0.12 ou mais recente
Não
Oracle
Sim
Oracle ADWC
Sim
PostgreSQL 9.5 ou mais recente
Sim
PostgreSQL anterior à 9.5
Sim
PrestoDB
Sim
PrestoSQL
Sim
SAP HANA 2+
Não
SingleStore
Sim
SingleStore 7+
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 na consulta antes de fazer o download dos 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 é compatível com resultados pivotados.

Permitir resultados extensos

Ao fazer o download de um conjunto de resultados grande no Looker usando o Google BigQuery como seu dialeto de banco de dados e selecionar Todos os resultados, a opção Permitir resultados grandes pode aparecer. Isso ocorre porque o Google BigQuery tem um tamanho máximo de resposta para resultados de consulta, conforme descrito no tópico de documentação do Google Cloud Gravar resultados de consulta. Para fazer o download de resultados que excedam o tamanho máximo de 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 será gravada em um esquema temporário de TDP e requer permissão para isso.
  • Os resultados da consulta são armazenados nesse esquema inicial temporário com 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 computador ou em Abrir no navegador para acessar 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 do painel inteiro. Não é possível fazer o download dos dados de apenas um bloco baseado em uma consulta de resultados mesclados.

Como fazer o download de dados de um painel

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

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 inclui um carimbo de data/hora que mostra quando o painel foi baixado.

Os downloads em 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. ele dimensiona o PDF com a largura padrão dos painéis (1260 px). As outras opções de tamanho de papel ajustam o PDF para corresponder a um tamanho de papel padrão e encaixar todo ou parte do painel. Dependendo do layout do painel e do tamanho de papel selecionado, algumas saídas em PDF podem ser diferentes do layout do painel quando visualizadas no Looker. Por exemplo, quando o tamanho de papel selecionado é mais estreito que o painel, você pode encontrar problemas com o espaçamento ou outra formatação e precisar 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 a instalação da 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. Você pode orientar o painel na posição retrato ou paisagem.

  4. Selecione ou desmarque a opção Abrir tabelas para mostrar todas as linhas. Se você selecionar essa opção, o PDF vai mostrar todas as linhas disponíveis na visualização de tabela, e não apenas as linhas que estão visíveis na miniatura do bloco do painel. Se você não selecionar essa opção, apenas as linhas que estão visíveis na miniatura sem rolar vão aparecer no PDF. Os filtros do dashboard e de 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 notadas 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 quando for feito o download.
    • O ícone de classificação não aparece em tabelas pivotadas que não foram classificadas manualmente.
    • As tabelas com a opção Tamanho das colunas para ajustar ativada se estendem por toda a largura 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 painel vão aparecer como estã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 Fazer o download para iniciar o processo. Uma nova guia será aberta no navegador, mostrando o status do download.

Fazer o download de um painel como CSVs

É possível fazer o download de todos os blocos de consulta do seu painel como uma coleção compactada de arquivos CSV. Os blocos de texto não são incluídos no arquivo ZIP. Para fazer o download do painel como uma coleção 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 coleção de CSV compactada.

Ao fazer o download de um painel como arquivos CSV, as opções de formatação de downloads, como definir limites de linha personalizados ou escolher todos os resultados, não estão disponíveis. Os limites de linha nos arquivos transferidos por download são correlacionados aos limites de linha nos blocos correspondentes.

O Looker gera arquivos compactados usando a codificação UTF-8. Se os caracteres nos nomes dos arquivos CSV estiverem distorcidos, pode haver um conflito entre a codificação UTF-8 do Looker e a codificação padrão do sistema operacional da máquina ou de um aplicativo de terceiros. O Looker sugere que você use um extrator de arquivos que reconheça UTF-8, como o 7-Zip, e verifique se todos os aplicativos de terceiros estão configurados para oferecer 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 painel com base em consultas de resultados mesclados, mas os dados dos blocos de resultados mesclados sã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 clique em Fazer o download dos dados:

Isso abre uma caixa de diálogo com várias opções semelhantes às de um Look ou um Explore. Expanda o menu Opções de dados avançadas para ver todas as opções disponíveis para download:

Formato

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
  • Markdown
  • PNG (imagem da visualização)

Dependendo do formato selecionado, algumas opções no menu Opções avançadas de dados 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. Consulte a postagem da Comunidade Mudança no formatação JSON para mais informações sobre como o Looker renderiza campos no formato JSON.

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

Os downloads no formato PNG sempre retornam dados do modelo, já que 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 os resultados salvos vão aparecer:

  • Se você escolher Formatado, os dados vão ser 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 é denominada Número de linhas a incluir. se a consulta de bloco contiver dimensões dinâmicas, esta seção será denominada Número de linhas e colunas a incluir. 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 que a consulta inteira seja transferida por download. 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, você pode especificar um número de linhas de resultado para fazer o download. Se a consulta tiver dimensões dinâmicas, você também poderá especificar o número de colunas para fazer o 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 apropriada 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 que eles possam fazer o download, especificamente as permissões download_with_limit e download_without_limit, acesse a página de documentação Papéis.