Como fazer o download de conteúdo

Esta página descreve como fazer 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 fazer o download e formatar o conteúdo variam de acordo com a origem do download: de um Look ou uma Análise detalhada, de um painel ou de uma consulta de resultados mesclados.

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

Para fazer o download de dados de uma página "Look" ou "Explorar", 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 explicam cada campo na janela Download:

Formato

Os downloads para formatos que usam o renderizador (PNG e PDF) vão usar 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 da 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. Consulte a postagem da Comunidade Mudança na formatação JSON para mais informações sobre como o Looker renderiza campos no formato JSON.

As tabelas transpostas são renderizadas apenas em downloads PNG.

Para desenvolvedores do Looker, se você estiver no Modo de desenvolvimento, os downloads de dados na maioria dos formatos de arquivo consultam seu modelo, que 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 o 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 que já está 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 que as configurações de visualização sejam aplicadas ao download de dados TXT, Excel, CSV, JSON, HTML ou Markdown.

Se você escolher Com opções de visualização aplicadas, o Looker vai aplicar algumas das configurações de visualização ao seu download. As seguintes configurações nos menus Plot, Series e Formatting que são configuradas para a visualização serão aplicadas ao download de dados:

A formatação condicional vai aparecer nos envios do Excel de Análises e Análises detalhadas com visualizações de gráficos de tabela 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 pivots e várias medidas, cada valor de pivot é repetido nas colunas em vez de ser representado como uma coluna mesclada. Os 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 você quer que os resultados da consulta sejam exibidos:

  • Se você escolher Sem formatação, o Looker não vai aplicar nenhuma formatação especial nos 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 vinculação) não sejam compatíveis com todos os tipos de arquivo. Por exemplo, qualquer formatação aplicada com o parâmetro html não 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 de 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 toda a consulta pode ser salva, a opção Todos os resultados vai estar disponível na janela Download.

A opção Todos os resultados geralmente fica desativada para consultas que fazem o seguinte:

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 planilhas ou até mesmo a 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 de consulta de streaming

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 de uma consulta, remova os cálculos de tabela da consulta.
  2. Limitações do banco de dados: alguns bancos de dados não podem ser transmitidos se os pivots forem incluídos 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+
Não
Apache Hive 2.3 ou mais recente
Sim
Apache Hive 3.1.2 ou mais recente
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
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
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 mais recente
Sim
MongoBI
Sim
MySQL
Sim
MySQL 8.0.12+
Sim
Oracle
Sim
Oracle ADWC
Sim
PostgreSQL 9.5 ou mais recente
Sim
PostgreSQL anterior à versão 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+
Não
Apache Hive 2.3 ou mais recente
Não
Apache Hive 3.1.2 ou mais recente
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
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 mais recente
Sim
MongoBI
Não
MySQL
Não
MySQL 8.0.12+
Não
Oracle
Sim
Oracle ADWC
Sim
PostgreSQL 9.5 ou mais recente
Sim
PostgreSQL anterior à versão 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

Ao selecionar Todos os resultados, você também pode encontrar 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. A seleção dessa opção pode acelerar o download, já que a ordenação de uma consulta pode ser custosa para a performance de determinados 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 Gravar resultados de consulta da documentação do Google Cloud. 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 grandes, 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 schema temporário de PDT e requer permissão para gravar em um.
  • 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 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 com base 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

É possível fazer o download do painel inteiro como um PDF, que mostra o título, os filtros, alguns ou todos os blocos 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 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. Ela dimensiona o PDF para a largura padrão dos painéis (1.260 px). Outras opções de tamanho de papel dimensionam o PDF para corresponder a um tamanho de papel padrão e ajustar 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:

    • 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 no PDF.
    • Os blocos podem ser reduzidos em largura para caber no PDF. Da mesma forma, os blocos que exigem rolagem no app Looker podem não 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 outra opção que não seja Ajustar página ao painel no menu suspenso Tamanho do papel, uma opção Orientação vai aparecer. 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 de painel e de consulta ainda serão aplicados, assim como as configurações de visualização, como limites de linha, limites de coluna e configurações feitas com a opção Limitar linhas exibidas.

    Se a opção Abrir tabelas para mostrar todas as linhas estiver selecionada, os blocos do painel que contêm visualizações de tabelas podem parecer um pouco diferentes nos PDFs salvos em relação ao 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 de coluna e das linhas de subtotal.
    • Se nenhum tema personalizado for definido, as tabelas vão aparecer no tema branco. Caso contrário, o tema personalizado será aplicado quando for feito 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 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 notadas no PDF:

    Se a opção Abrir tabelas para mostrar todas as linhas não aparecer, converse com o administrador do Looker sobre a instalação da versão adequada do renderizador do Chromium para sua instância do Looker.

  5. Selecione ou desmarque a opção Organizar os blocos do painel em uma coluna. Se você selecionar essa opção, o PDF vai mostrar os blocos do painel 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 conferir uma imagem do PDF em uma nova guia do navegador. Em seguida, você pode fazer o download do PDF usando os controles do 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.

Como 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 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 que todos os aplicativos de terceiros estejam configurados para oferecer suporte a UTF-8.

Como fazer o download de dados dos blocos do painel

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. Abra o menu Opções avançadas de dados para conferir todas as opções disponíveis para o download:

Formato

É possível fazer o download de dados dos blocos do painel 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 HTML ou PNG (imagem de visualização) estiverem ausentes, 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. Consulte a postagem da Comunidade Mudança na formatação JSON para mais informações sobre como o Looker renderiza campos no formato JSON.

As visualizações de tabelas transpostas sã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 que as configurações de visualização sejam aplicadas ao download de dados:

Se você escolher Conforme exibido 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 do Look ou da Análise.

Valores de dados

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

  • Se você escolher Formatado, os dados vão aparecer de forma mais semelhante à experiência Análise no Looker, embora alguns recursos (como vinculação) não sejam compatíveis com todos os formatos de arquivo.
  • Se você escolher Sem formatação, o Looker não vai aplicar nenhuma formatação especial nos 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

É possível especificar quantos dados são incluídos no download nesta seção. 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 do bloco tiver dimensões articuladas, essa 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 que a consulta inteira seja transferida por download. Se você tiver as permissões para fazer o download de resultados acima de um limite definido e o Looker determinar que toda a consulta pode ser salva, a opção Todos os resultados vai estar disponível na janela Download.

A opção Todos os resultados geralmente 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 planilhas ou até mesmo a instância do Looker.

Se a opção Todos os resultados estiver indisponí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 resultados 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 das 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 Gerenciar recursos do usuário empresarial tem informações importantes sobre o processo de download:

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.