Fazendo o download de conteúdo

Nesta página, descrevemos o download de conteúdo (visualizações ou dados) do Looker.

Para fazer o download de conteúdo, você precisa da 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 do conteúdo transferido variam de acordo com o tipo de download (de um visual ou de exploração), de um painel, de um painel legado ou de uma consulta de resultados mesclados.

Fazer o download de dados de um recurso "Olhar" ou "Explorar"

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

Isso abre uma janela Download, em que você pode nomear e formatar o download:

As seções a seguir mostram cada campo da janela Download:

Formatos de arquivo

Os downloads de 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 de qualquer modo (desenvolvimento ou produção).

É possível fazer o download de dados das aparências e dos explorações nos seguintes formatos:

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

Ao escolher o formato de dados para download, se você não vir as opções HTML ou PNG (imagem de visualização) (para visuais), fale 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 o campo labels como o valor renderizado na saída JSON. Consulte o tópico Alteração na formatação JSON da comunidade para mais informações sobre como o Looker renderiza campos no formato JSON.

As tabelas transpostas serão renderizadas somente 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 como ele 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.

Resultados

Na seção Resultados, escolha se você quer aplicar as configurações de visualização ao download dos seus 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 da guia "Olhar" ou "Explorar".

Valores

Na seção Valores, escolha como você quer que os resultados da consulta salvos sejam exibidos:

  • Se você escolher Não formatado, o Looker não aplicará nenhuma formatação especial dos resultados da sua consulta, como arredondar números longos ou adicionar caracteres especiais definidos pelos desenvolvedores do Looker. Isso geralmente é melhor quando os dados estão sendo enviados para outra ferramenta de processamento.
  • Se você escolher Formatar, os dados serão exibidos mais semelhantes à experiência de Explorar do Looker, embora alguns recursos (como vinculação) não sejam compatíveis com todos os tipos de arquivo.

Limites

Você pode escolher a quantidade de dados para download:

  • Resultados na tabela: 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 é 100.000,a menos que o administrador do Looker tenha aumentado esse limite. Consulte o tópico da comunidade Recurso legado: permissão de downloads ilimitados (Looker 4.14+).

Todos os resultados

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

A opção Todos os resultados geralmente é desativada para consultas que:

Mesmo quando a opção Todos os resultados estiver disponível, ainda 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 a instância do Looker.

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

Resultados da consulta de streaming

Streaming refere-se à capacidade do Looker de processar dados em blocos, em vez de todos de uma só vez. Se o Looker puder transmitir um conjunto de resultados, será possível fazer downloads ilimitados.

O Looker faz streaming dos resultados transferidos por download para todos os formatos, exceto os formatos 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, é necessário remover os cálculos de tabela dela.
  2. Limitações do banco de dados: alguns bancos de dados não poderão ser transmitidos se a tabela dinâmica for incluída na consulta. Para esses bancos de dados, é necessário remover 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. Veja a seguir uma lista de bancos de dados compatíveis com o streaming e outra de bancos de dados compatíveis com streaming com tabelas dinâmicas aplicadas:

Remover todos os tipos de consulta

Quando você selecionar Todos os resultados, também verá a opção Remover todas as classificações da consulta. Essa opção impede que a consulta seja classificada antes de você fazer o download dos resultados. Selecionar essa opção pode acelerar o download, já que a classificação de uma consulta pode ser cara do desempenho de determinados 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

Ao fazer o download de um grande conjunto de resultados no Looker usando o Google BigQuery como seu dialeto de banco de dados e selecione Todos os resultados, você poderá ver a opção Permitir resultados grandes. Isso ocorre porque o Google BigQuery tem um tamanho máximo de resposta para os resultados da consulta, conforme descrito no tópico de documentação Gravar resultados da consulta do Google Cloud. Para fazer o download dos resultados que excedem o tamanho máximo da resposta do BigQuery, o Looker precisa realizar 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 gravará em um esquema temporário de PDT e precisará de permissão para gravar em um.
  • Os resultados da consulta são armazenados nesse esquema de raspadinha temporário com um nome de tabela aleatório por uma hora.

Nome do arquivo

Insira um nome para o download ou use o nome padrão pré-preenchido no campo. O Looker anexa automaticamente a extensão de arquivo apropriada com base na sua seleção no campo Formato de arquivo.

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 clique em 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 das consultas de resultados mesclados, você pode salvar a consulta em um painel e fazer o download do painel como um PDF ou como um conjunto 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 único bloco com base em uma consulta de resultados mescladas.

Como fazer o download de dados de um painel

Esta seção descreve o download de painéis que usam a nova experiência do painel. Para ver informações sobre como fazer o download de painéis legados, consulte a seção Como fazer o download de dados de um painel legado.

Para fazer o download de todo o painel, 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.

Fazendo o download de um painel como PDF

É possível fazer o download de todo o painel como PDF, o que significa que você receberá uma imagem em PDF do título do painel, de todos os filtros do painel, todos os blocos do painel e o fuso horário em que o painel foi executado. O PDF também incluirá um carimbo de data/hora, que mostrará quando o painel foi transferido por download.

Quando você está fazendo o download de um painel como PDF, o PDF exibe a nova experiência do painel ou um painel legado, dependendo do formato permanente do painel. Em outras palavras, se você ver temporariamente o painel em um formato diferente porque alterou o URL, os downloads vão refletir o formato permanente.

Os downloads em formato PDF sempre retornam os dados do modelo, assim como no Modo de produção, mesmo se você estiver 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 a página ao painel é o padrão. Ela dimensiona o PDF para corresponder ao layout do painel na tela. Outras opções de tamanho do papel garantem que o PDF corresponda a um tamanho de papel padrão e se ajuste ao painel dentro dele. Dependendo do layout do painel, visualizações grandes ou grupos de blocos sobrepostos podem precisar ser redimensionados para caber em um determinado tamanho de página.



    Se a opção Tamanho do papel não for exibida, fale com seu 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 a página ao painel no menu suspenso Tamanho do papel, uma opção de Orientação será exibida. É possível orientar o painel na orientação retrato ou paisagem.
  4. Marque ou desmarque a opção Expandir tabelas para mostrar todas as linhas. Se você selecionar essa opção, para os blocos do painel que usam visualizações de tabela, o PDF mostrará todas as linhas disponíveis na visualização da tabela, não apenas as linhas visíveis na miniatura do bloco do painel. Se você não selecionar essa opção, somente as linhas visíveis na miniatura sem rolagem aparecerão no PDF. Os filtros de consulta e do painel de controle 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 não for exibida, fale com seu administrador do Looker sobre como instalar a versão apropriada do renderizador do Chromium da instância do Looker.
  5. Marque ou desmarque a opção Organizar blocos do painel em uma única coluna. Se você selecionar esta opção, o PDF exibirá os blocos do painel em uma única coluna vertical. Se você não escolher esta opção, os blocos do painel de controle vão aparecer conforme são organizados no painel.
  6. Clique em Abrir no navegador para ver uma imagem do PDF em uma nova guia do navegador. A partir daí, é possível optar por fazer o download do PDF usando os controles do seu navegador.
  7. Clique em Cancelar se você não quiser mais fazer o download do painel.
  8. Clique em 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 Renderizar tabelas longas e a opção Expandir tabelas para mostrar todas as linhas estiver selecionada, os blocos com visualizações de tabela podem parecer um pouco diferentes em PDFs transferidos por download do que no Looker. Para saber mais sobre as diferenças, acesse a página de documentação dos Labs.

Fazer o download de um painel como CSVs

É possível fazer o download de todos os blocos de consulta do seu painel como um conjunto compactado de arquivos CSV. Blocos de texto não sã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. Clique em Cancelar se você não quiser mais fazer o download do painel.
  3. Clique em Fazer download para iniciar o download da coleção CSV compactada.

Quando você faz o download de um painel como arquivos CSV, as opções de formatação dos 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 linhas nos blocos correspondentes.

O Looker gera arquivos compactados usando a codificação UTF-8. Se os caracteres nos nomes dos arquivos CSV parecem distorcidos, pode haver um conflito entre a codificação UTF-8 do Looker e a codificação padrão do sistema operacional do computador ou um app de terceiros. O Looker sugere que você use um extrator de arquivos que reconhece UTF-8, como 7-Zip, e garanta que todos os aplicativos de terceiros sejam configurados para oferecer suporte a UTF-8.

Download de dados de blocos do painel de controle

Não é possível fazer o download de 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ê fizer o download de um painel como PDF ou como um conjunto de arquivos CSV.

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

Isso abre uma caixa de diálogo com várias opções semelhantes às para um recurso "Olhar" ou "Explorar" e para um download de blocos de painel legado. Expanda o menu Opções de dados avançados para ver todas as opções disponíveis para o download:

Formatação

É possível fazer o download dos 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)

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

Se as opções HTML ou PNG (imagem) não forem exibidas, fale com seu 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 o campo labels como o valor renderizado na saída JSON. Consulte o tópico Alteração na formatação JSON da comunidade 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 de PDF e PNG.

Os downloads em formato PNG sempre retornam dados do modelo, assim como no Modo de produção, mesmo se você estiver no Modo de desenvolvimento.

Resultados

Na seção Resultados, escolha se você quer aplicar as configurações de visualização ao download dos seus 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 da guia "Olhar" ou "Explorar".

Valores de dados

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

  • Se você escolher Formatada, os dados serão mais parecidos com a experiência Explorar no Looker, embora alguns recursos (como 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 definidos pelos desenvolvedores do Looker. Isso geralmente é melhor quando os dados estão sendo enviados para outra ferramenta de processamento.

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, esta seção do pop-up de download é chamada de Número de linhas a serem incluídas. Se a consulta de blocos tiver dimensões dinâmicas, essa seção será chamada de 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 permitirão o download de toda a consulta. Se você tiver as permissões para fazer o download de resultados acima de um limite definido e se o Looker determinar que é possível fazer o download de toda a consulta, a opção Todos os resultados estará disponível na janela Download.

A opção Todos os resultados geralmente é desativada para consultas que:

Mesmo quando a opção Todos os resultados estiver disponível, ainda 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 a instância do Looker.

Se a opção Todos os resultados não estiver disponível, você poderá usar 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 fazer o download. Se a consulta tiver dimensões dinâmicas, também é possível especificar várias colunas para download.

Como fazer o download de dados de um painel legado

Nesta seção, falamos sobre os painéis legados. Para ver informações sobre como fazer o download de painéis usando a nova experiência de painel, consulte a seção Como fazer o download de dados de um painel.

O Looker permite fazer o download do painel legado para armazenar ou compartilhar os dados atuais. É possível fazer o download do painel legado como PDF ou coleção compactada de arquivos CSV.

Como fazer o download de um painel legado como PDF

Para fazer o download do painel legado em formato PDF, siga estas etapas:

  1. Clique no ícone de engrenagem no canto superior direito da página.

  2. Selecione Fazer o download como PDF.

    Isso abre uma janela Download em que você pode nomear e formatar o download.

  3. Você também pode usar a caixa Nome do arquivo para alterar o nome do arquivo PDF.

  4. Expanda o menu Opções avançadas para personalizar ainda mais o PDF.

    Marque a caixa Formato de coluna única se quiser que o PDF mostre os blocos do painel legado em uma única coluna vertical. Deixe a caixa desmarcada se quiser que o PDF mostre os blocos como estão organizados no painel legado.

    Se você selecionar a opção Expandir tabelas para mostrar todas as linhas, nos blocos do painel que usam visualizações de tabela, o PDF mostrará todas as linhas disponíveis na visualização da tabela, não apenas as linhas visíveis na miniatura do bloco do painel. Se você não selecionar essa opção, somente as linhas visíveis na miniatura sem rolagem aparecerão no PDF. Os filtros de consulta e do painel de controle 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.

    Também é possível especificar o tamanho e a orientação ideais do PDF selecionando uma opção no menu suspenso Tamanho do papel. Visualizações grandes ou grupos de blocos de painéis sobrepostos talvez precisem ser redimensionados para se ajustarem perfeitamente a uma página PDF.

    Se você não encontrar as opções Tamanho do papel ou Expandir tabelas para mostrar todas as linhas, fale com seu administrador do Looker sobre como instalar a versão apropriada do renderizador do Chromium para sua instância do Looker.

  5. Clique em Fazer download ou Abrir no navegador.

Os downloads em formato PDF sempre retornam os dados do modelo, assim como no Modo de produção, mesmo se você estiver no Modo de desenvolvimento.

Quando você faz o download de um painel como PDF, o PDF exibe a nova experiência do painel ou um painel legado, dependendo do formato permanente do painel. Em outras palavras, se você ver temporariamente o painel em um formato diferente porque alterou o URL, os downloads vão refletir o formato permanente.

Fazer o download de um painel legado como CSV

Para fazer o download de um arquivo CSV em um painel legado, clique no ícone de engrenagem no canto superior direito do painel e selecione Fazer o download como CSV para iniciar o download:

O diretório compactado terá um arquivo CSV separado para cada bloco do painel de controle. Cada arquivo CSV inclui os dados formatados usados para criar o bloco no painel de controle:

Ao fazer 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 estarão disponíveis. Os limites de linha nos arquivos transferidos por download estão relacionados 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 parecem distorcidos, pode haver um conflito entre a codificação UTF-8 do Looker e a codificação padrão do sistema operacional do computador ou um app de terceiros. O Looker sugere que você use um extrator de arquivos que reconhece UTF-8, como 7-Zip, e para garantir que todos os aplicativos de terceiros sejam configurados para oferecer suporte a UTF-8.

Download de dados de blocos do painel legado

Para fazer o download dos dados de um bloco específico, clique no ícone de três pontos e selecione Fazer download de dados:

A janela de download e as opções do bloco são semelhantes às de um recurso "Olhar" ou "Explorar". Consulte a seção Fazer o download de dados de uma aparência ou de um recurso Explorar para mais informações sobre as opções disponíveis para personalizar o download de dados. Se você estiver fazendo o download de Todos os resultados, não verá a opção para remover classificações da consulta, como faria para uma aparência ou um recurso Explorar.

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

Para administradores: como ativar o 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 apropriada do renderizador do Chromium. Caso sua instância seja hospedada pelo Looker, o Chromium já estará instalado.

A página de documentação Gerenciar recursos do usuário comercial tem informações importantes sobre administradores 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 Funções.

Para reduzir o tempo de renderização dos downloads de PDF para painéis que contêm visualizações de tabelas com muitas linhas, os administradores do Looker podem ativar o recurso Render Long Tables (Laboratórios).