Download de conteúdo

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

Para fazer o download de conteúdo, um administrador do Looker precisa da permissão do download_with_limit ou download_without_limit.

O processo e as opções de download e formatação de conteúdo variam de acordo com o conteúdo a ser transferido: de um visual ou de um Explorar, de um painel ou de uma consulta de resultados combinados.

Como fazer o download de dados de um acesso de visualização ou exploração

Para fazer o download dos dados de uma página "Olhar" ou "Explorar", clique no menu de engrenagem no canto superior direito e selecione Fazer o 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 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 mostrará os resultados de qualquer modo (desenvolvimento ou produção).

É possível fazer o download dos dados das Aparências e Explorars nos seguintes formatos:

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

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

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

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

Para desenvolvedores do Looker, se você estiver no modo de desenvolvimento, os downloads de dados na maioria dos formatos de arquivo consultarão 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 Com as opções de visualização aplicadas, o Looker aplicará algumas das configurações de visualização ao seu download. Qualquer uma das configurações a seguir nos menus Traçar, Série e Formatação definidas para a visualização será aplicada ao download de dados:

    A formatação condicional só será exibida em exibições do Excel com visualizações e gráficos com visualizações de gráficos de tabela se a regra "Em uma escala" for aplicada.

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

    • A cor do texto do cabeçalho personalizado e a cor do plano de fundo não são aplicadas aos resultados baixados, exceto para arquivos PNG.
    • Para tabelas de resultados com tabelas dinâmicas e várias medidas, cada valor dinâmico é repetido entre colunas em vez de representado como uma coluna mesclada. Os downloads de HTML e PNG são uma exceção. Portanto, a coluna mesclada é preservada.
    • Quando você faz o download a partir de um painel, o título do bloco do painel não é incluído nos resultados.
    • Os valores Totais e Total da linha são incluídos nos resultados transferidos, mas as respectivas linhas e colunas não são rotuladas.

    As colunas em gráficos de tabela que foram reorganizadas manualmente aparecerão na ordem original no download se a consulta incluir um 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 será exibido como a tabela de dados na seção Dados da interface ou da ferramenta Explorar.

Valores

Na seção Valores, escolha como você quer que os resultados de consulta transferidos por download sejam exibidos:

  • Se você escolher Não formatado, o Looker não aplicará nenhuma formatação especial aos resultados da consulta, como arredondamento de números longos ou adição de caracteres especiais aos desenvolvedores do Looker. Isso geralmente é preferível quando os dados são enviados para processamento em outra ferramenta.
  • Se você escolher Formatada, os dados serão mais parecidos com a experiência Explorar 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 não será aplicada a downloads em TXT, CSV, Excel ou JSON.

Limites

Você pode escolher a quantidade de dados da qual deseja fazer o 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 download_with_limit são limitados a 5.000 linhas. O limite para outros usuários normalmente é de 100.000,a menos que o administrador do Looker tenha aumentado esse limite. Consulte a postagem da comunidade Recurso legado: como permitir downloads ilimitados (Looker 4.14+).

Todos os resultados

Quando você clica em Executar em uma verificação ou uma exploração, 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 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 normalmente é desativada para consultas que:

Mesmo quando a opção Todos os resultados está disponível, você deve ter 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, 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

O streaming se refere à capacidade do Looker de processar dados em partes, e não todas de uma vez. Se o Looker conseguir transmitir um conjunto de resultados, será possível fazer downloads ilimitados.

O Looker faz o streaming dos resultados transferidos por download para todos os formatos, exceto os renderizados (HTML, PNG).

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

  1. Cálculos de tabelas: os cálculos de tabelas não podem ser transmitidos. Portanto, para fazer o download de resultados ilimitados para uma consulta, é necessário remover os cálculos da tabela dela.
  2. Limitações do banco de dados: alguns bancos de dados não poderão transmitir se as tabelas dinâmicas forem incluídas na consulta. Para esses bancos de dados, remova as tabelas dinâmicas para fazer o download de resultados ilimitados. Alguns bancos de dados não podem transmitir nenhum resultado, o que significa que downloads ilimitados não são possíveis. Veja a seguir uma lista de bancos de dados compatíveis com streaming e uma lista de bancos de dados compatíveis com streaming com tabelas dinâmicas aplicadas:

Remover todas as classificações da consulta

Quando você seleciona Todos os resultados, também pode ver a opção para Remover todas as classificações da consulta. Essa opção impede a classificação na consulta antes do download dos resultados. Selecionar essa opção pode acelerar o download, pois a classificação de uma consulta pode ter um alto desempenho para determinados tipos de banco de dados.

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

Permitir resultados extensos

Quando você faz o download de um conjunto de resultados extensos no Looker usando o Google BigQuery como dialeto do seu 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 os resultados da consulta, conforme descrito no tópico de 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 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 está definida como true para a consulta.
  • As cláusulas ORDER BY na consulta são removidas.
  • A consulta gravará em um esquema temporário do PDT e requer permissão para gravar em um.
  • Os resultados da consulta são armazenados neste esquema temporário de rascunho em um nome de tabela aleatório por uma hora.

Nome do arquivo

Você pode inserir um nome de arquivo para o download ou usar o nome de arquivo padrão pré-preenchido no campo. O Looker anexará automaticamente a extensão de arquivo adequada com base na sua seleção no campo Formato do 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 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 combinados, salve a consulta em um painel e depois faça o download dele 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 um único bloco com base em uma consulta de resultados mesclados.

Como fazer o download de dados em um painel

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 seu formato de download.

Download de um painel como PDF

Os downloads de PDF podem não corresponder exatamente ao layout ou ao dimensionamento do painel, conforme visualizado no Looker.

É possível fazer o download de todo o painel como um PDF, o que significa que você receberá um PDF que exibe o título do painel, 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 incluirá um carimbo de data/hora que mostra quando o painel foi transferido por download.

Os downloads em formato PDF sempre retornam dados do modelo, como 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 a página ao painel é o padrão. Ela dimensiona o PDF para a largura padrão dos painéis (1260 pixels). Outras opções de tamanho de papel dimensionam o PDF para que ele corresponda a um tamanho padrão e se encaixe em todo o painel ou em parte dele. Dependendo do layout do painel e do tamanho do papel selecionado, algumas saídas de PDF podem ser diferentes do layout do painel quando visualizadas no Looker. Por exemplo, quando o tamanho do papel selecionado é mais estreito que o do painel, talvez você encontre problemas com o espaçamento ou outra formatação e precise fazer alguns ajustes:

    • Visualizações grandes ou grupos de blocos sobrepostos talvez precisem 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 largura reduzida para se ajustarem ao PDF. Da mesma forma, os blocos que exigem rolagem no app Looker não podem ser expandidos para mostrar todo o conteúdo.



      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 na lista suspensa Tamanho do papel, uma opção de Orientação será exibida. É possível orientar o painel na posição retrato ou paisagem.

  4. Marque ou desmarque Expandir tabelas para mostrar todas as linhas. Se você selecionar essa opção, para blocos de painel que usam visualizações de tabela, o PDF mostrará todas as linhas disponíveis na visualização de 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 o painel ainda serão aplicados, assim como as configurações de visualização, como limites de linha, limites de coluna e as configurações definidas com a opção Limite de linhas exibidas.

    Se a opção Expandir tabelas para mostrar todas as linhas for selecionada, os blocos do painel que contêm visualizações de tabela poderão parecer um pouco diferentes nos PDFs transferidos por download em relação ao Looker. As seguintes diferenças podem ser notadas no PDF:

    • As personalizações de cores de fundo e tamanhos de fonte são removidas dos cabeçalhos das colunas e das linhas do subtotal.
    • As tabelas aparecem no tema branco.
    • 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 caber se estendem até a largura total do bloco.

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

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

  5. Marque ou deixe a opção Organizar os painéis do painel em uma única coluna desmarcada. Se você selecionar essa opção, o PDF exibirá os blocos do painel em uma única coluna vertical. Se você não selecionar essa opção, os blocos do painel aparecerão da forma como 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í, você pode optar por fazer download do PDF usando os controles de seu navegador.

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

  8. Clique em 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 no Labs e a opção Expandir tabelas para mostrar todas as linhas estiver selecionada, os blocos que contêm 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 do Labs.

Como fazer o download de um painel como CSVs

É possível fazer o download de todos os blocos de consulta do 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. Clique em Cancelar se não quiser mais fazer o download do painel.
  3. Clique em 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 de formatação de downloads, como definir limites de linha personalizados ou escolher todos os resultados, ficam indisponíveis. Os limites de linha nos arquivos baixados correspondem aos limites de linha nos blocos correspondentes.

O Looker gera arquivos compactados usando a codificação UTF-8. Se os caracteres nos seus nomes de arquivos CSV forem 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 um aplicativo de terceiros. O Looker sugere que você use um extrator de arquivos que reconheça o UTF-8, como o 7-Zip, e garanta que todos os aplicativos de terceiros estejam configurados para oferecer suporte ao 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 combinados, mas os dados dos blocos de resultados combinados serão incluídos se você fizer o download de um painel como um PDF ou como uma coleção de arquivos CSV.

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

Isso abre uma caixa de diálogo com várias opções parecidas com as de um visual ou uma exploração. Expanda o menu Opções de dados avançadas para ver todas as opções disponíveis para o download:

Formato

É 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 de visualização)

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

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

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

As visualizações de tabelas transpostas serão processadas somente em PDFs e PNGs.

Os downloads no formato PNG sempre retornam dados do modelo, como 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 seus dados:

Se você escolher Como exibido na tabela de dados, as opções de visualização não serão aplicadas e o download será exibido como a tabela de dados na seção Dados da interface ou da ferramenta Explorar.

Valores de dados

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

  • Se você escolher Formatada, os dados serão exibidos de maneira mais semelhante à experiência Explorar do Looker, embora alguns recursos (como a vinculação) não sejam compatíveis com todos os formatos de arquivo.
  • Se você escolher Não formatado, o Looker não aplicará nenhuma formatação especial aos resultados, como arredondar números longos ou adicionar caracteres especiais aos desenvolvedores do Looker. 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

Você pode 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 contiver dimensões dinâmicas, essa seção será chamada Número de linhas e colunas a serem incluídas. As 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 permissão para fazer o download dos resultados acima de um limite definido e o Looker determinar que é possível fazer o download de toda a consulta, a opção Todos os resultados estará disponível na janela Download.

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

Mesmo quando a opção Todos os resultados está disponível, você deve ter 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, 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 download. Se sua consulta contém dimensões dinâmicas, também é possível especificar várias colunas para download.

Para administradores: 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 sua instância for hospedada pelo Looker, o Chromium já estará instalado.

A página de documentação Gerenciar recursos de usuário comercial tem informações importantes do administrador sobre o processo de download:

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

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