Esta página foi traduzida pela API Cloud Translation.

Como fazer o download de conteúdo

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

Para baixar 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 baixar e formatar conteúdo baixado 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 combinados.

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

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

Formato
Nome do arquivo
Resultados
Valores de dados
Número de linhas e colunas a serem incluídas

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

É possível fazer o download de dados de Looks 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 Looks), converse com o administrador do Looker sobre a instalação da 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 valor renderizado na saída JSON. Consulte a postagem na comunidade Mudança na formatação JSON para mais informações sobre como o Looker renderiza campos no formato JSON.

As tabelas transpostas serão renderizadas apenas 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 vão consultar 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 sempre consultam seu 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 padrão pré-preenchido no campo. O Looker vai anexar automaticamente a extensão de arquivo apropriada 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 em 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. Qualquer uma das seguintes configurações nos menus Gráfico, Série e Formatação configurados para a visualização será aplicada ao download de dados:

Mostrar números de linha
Mostrar totais
Mostrar totais da linha
Limitar linhas mostradas a um máximo de 500 linhas mostradas ou ocultas
Mostrar nome completo do campo
Rótulos personalizados para cada coluna. O Looker usa o campo labels como valor renderizado na saída JSON. Consulte a postagem da comunidade do Looker Mudança na formatação JSON para mais informações sobre como o Looker renderiza campos no formato JSON.
Formatação condicional para downloads de visualizações de gráficos de tabela no formato Excel

A formatação condicional será exibida nas entregas do Excel de Looks e análises detalhadas com visualizações de gráficos de tabela somente se a Regra ao longo de uma escala for aplicada.

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

A cor do texto e do plano de fundo do cabeçalho personalizado não são aplicadas aos resultados baixados, exceto em arquivos PNG.
Para tabelas de resultados com pivôs e várias métricas, cada valor de pivô é repetido em todas as colunas, em vez de ser representado como uma coluna mesclada. Os downloads em HTML e PNG são uma exceção, então a coluna mesclada é preservada.
Ao fazer o download de um painel, o título do bloco não é incluído nos resultados baixados.
Os valores Totais e Totais da linha são incluídos nos resultados baixados, mas a linha e as colunas respectivas não são rotuladas.
Os subtotais não serão baixados 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:

campos que são ocultados da visualização de propósito
campos presentes no SQL subjacente, mas não na visualização, como:
- uma dimensão presente na visualização que contém um parâmetro link que faz referência a outro campo que não está na visualização.
- um campo que usa o parâmetro case.
- uma dimensão presente na visualização que faz referência a outro campo com {{ field_name._value }} Liquid variable syntax, que não está presente na visualização.
Um ou mais campos com o preenchimento de dimensão ativado
Três ou mais campos de rotação
Totais da linha ativados
Um ou mais campos que incluem o parâmetro order_by_field do LookML na definição do campo

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 do Look ou da análise detalhada.

Valores de dados

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

Se você escolher Sem formatação, 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 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 em TXT, CSV, Excel ou JSON.

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

Você pode escolher a quantidade de dados que quer baixar da seguinte forma:

Tabela de resultados atual: 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 têm um limite de 5.000 linhas. O limite para outros usuários geralmente é de 100.000.

Todos os resultados

Quando você seleciona Executar em um Look 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 o download de toda a consulta. Se você tiver as permissões (para resultados acima de um limite definido) e o Looker determinar que toda a consulta pode ser baixada, 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:

Envolvem totais de linha ou cálculos de tabela
Use medidas de porcentagem do total, porcentagem do anterior ou totais contínuos.
Recuperar dados de um dialeto de banco de dados que não pode transmitir resultados
Incluir colunas dinâmicas que o Looker calcula porque os dados vêm de um dialeto de banco de dados que não pode calcular as dinâmicas

Mesmo quando a opção Todos os resultados está disponível, tenha cuidado ao baixar 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 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.

Streaming de 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 isso não for possível.

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

Cálculos de tabela: não é possível transmitir cálculos de tabela. Portanto, para baixar resultados ilimitados de uma consulta, remova os cálculos de tabela dela.
Limitações do banco de dados: alguns bancos de dados não podem fazer streaming se há indicadores na consulta. Para esses bancos de dados, é necessário remover os pivôs 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
Amazon Aurora MySQL	Sim
Amazon Redshift	Sim
Amazon Redshift 2.1+	Sim
Amazon Redshift Serverless 2.1+	Sim
Apache Druid	Não
Apache Druid 0.13+	Não
Apache Druid 0.18+	Não
Apache Hive 2.3+	Sim
Apache Hive 3.1.2+	Sim
Apache Spark 3+	Sim
ClickHouse	Sim
Cloudera Impala 3.1+	Sim
Cloudera Impala 3.1+ with Native Driver	Sim
Cloudera Impala with Native Driver	Sim
DataVirtuality	Sim
Databricks	Sim
Denodo 7	Sim
Denodo 8	Sim
Dremio	Sim
Dremio 11+	Sim
Exasol	Sim
Firebolt	Sim
Google BigQuery Legacy SQL	Sim
Google BigQuery Standard SQL	Sim
Google Cloud PostgreSQL	Sim
Google Cloud SQL	Sim
Google Spanner	Não
Greenplum	Sim
HyperSQL	Não
IBM Netezza	Não
MariaDB	Sim
Microsoft Azure PostgreSQL	Sim
Microsoft Azure SQL Database	Sim
Microsoft Azure Synapse Analytics	Sim
Microsoft SQL Server 2008+	Sim
Microsoft SQL Server 2012+	Sim
Microsoft SQL Server 2016	Sim
Microsoft SQL Server 2017+	Sim
MongoBI	Sim
MySQL	Sim
MySQL 8.0.12+	Sim
Oracle	Sim
Oracle ADWC	Sim
PostgreSQL 9.5+	Sim
PostgreSQL pre-9.5	Sim
PrestoDB	Sim
PrestoSQL	Sim
SAP HANA	Não
SAP HANA 2+	Não
SingleStore	Sim
SingleStore 7+	Sim
Snowflake	Sim
Teradata	Sim
Trino	Sim
Vector	Sim
Vertica	Sim

Estes são os bancos de dados que oferecem suporte ao streaming com pivôs aplicados:

Dialeto	Compatível?
Actian Avalanche	Sim
Amazon Athena	Sim
Amazon Aurora MySQL	Não
Amazon Redshift	Sim
Amazon Redshift 2.1+	Sim
Amazon Redshift Serverless 2.1+	Sim
Apache Druid	Não
Apache Druid 0.13+	Não
Apache Druid 0.18+	Não
Apache Hive 2.3+	Não
Apache Hive 3.1.2+	Não
Apache Spark 3+	Sim
ClickHouse	Não
Cloudera Impala 3.1+	Sim
Cloudera Impala 3.1+ with Native Driver	Sim
Cloudera Impala with Native Driver	Sim
DataVirtuality	Não
Databricks	Sim
Denodo 7	Não
Denodo 8	Não
Dremio	Não
Dremio 11+	Não
Exasol	Sim
Firebolt	Sim
Google BigQuery Legacy SQL	Sim
Google BigQuery Standard SQL	Sim
Google Cloud PostgreSQL	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
Microsoft Azure SQL Database	Sim
Microsoft Azure Synapse Analytics	Sim
Microsoft SQL Server 2008+	Sim
Microsoft SQL Server 2012+	Sim
Microsoft SQL Server 2016	Sim
Microsoft SQL Server 2017+	Sim
MongoBI	Não
MySQL	Não
MySQL 8.0.12+	Não
Oracle	Sim
Oracle ADWC	Sim
PostgreSQL 9.5+	Sim
PostgreSQL pre-9.5	Sim
PrestoDB	Sim
PrestoSQL	Sim
SAP HANA	Não
SAP HANA 2+	Não
SingleStore	Sim
SingleStore 7+	Sim
Snowflake	Sim
Teradata	Sim
Trino	Sim
Vector	Sim
Vertica	Sim

Remover todas as classificações da consulta

Ao selecionar Todos os resultados, você 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 baixar os resultados. Selecionar essa opção pode acelerar o download, já que a classificação de uma consulta pode ser cara para o desempenho de determinados tipos de banco de dados.

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

Permitir resultados extensos

Ao baixar um grande conjunto de resultados no Looker usando o Google BigQuery como dialeto de banco de dados e selecionar Todos os resultados, a opção Permitir resultados grandes pode aparecer. Isso acontece porque o Google BigQuery tem um tamanho máximo de resposta para resultados de consultas, conforme descrito no tópico da documentação do Google Cloud Gravar resultados de consultas. Para fazer o download de resultados que excedem o tamanho máximo de resposta do BigQuery, o Looker precisa realizar um processo diferente.

Se você selecionar Permitir resultados extensos, o processo de download será afetado da seguinte forma:

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 PDT e requer permissão para gravar em um.
Os resultados da consulta são armazenados nesse esquema 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 em Fazer o download para baixar 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 combinados

Para fazer o download de consultas de resultados combinados, 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, é necessário baixar o painel inteiro. Não é possível baixar os dados de apenas um bloco com base em uma consulta de resultados combinados.

Como fazer o download de dados de um painel

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

Isso abre uma caixa de diálogo em que você pode selecionar PDF ou CSV como formato de download.

Fazer o download de um painel como PDF

É possível baixar todo o painel como um PDF, que vai mostrar 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:

Selecione PDF no menu suspenso Formato.
Selecione uma opção no menu suspenso Tamanho do papel:

A opção Ajustar página ao painel é a padrão. Ela dimensiona o PDF para a largura padrão dos painéis (1260 px). Outras opções de tamanho de papel ajustam o PDF para corresponder a um tamanho padrão e encaixar todo ou parte do painel nele. 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 é menor que o painel, podem ocorrer problemas com o espaçamento ou outra formatação, e é necessário 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 ser expandidos para mostrar todo o conteúdo.
Se a opção Tamanho do papel não aparecer, fale com seu administrador do Looker sobre a instalação da versão mais recente do renderizador do Chromium para sua instância do Looker.
Se você selecionar algo diferente de Ajustar página ao painel no menu suspenso Tamanho do papel, uma opção de Orientação vai aparecer. Você pode orientar o painel na posição retrato ou paisagem.
Marque ou deixe desmarcada a opção Abrir tabelas para mostrar todas as linhas. Se você selecionar essa opção, para blocos do 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 visíveis na miniatura do bloco do painel. Se você não selecionar essa opção, apenas as linhas visíveis na miniatura sem rolagem 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 linhas, limites de colunas 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 tabela poderão ter uma aparência um pouco diferente nos PDFs baixados 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 de coluna e das linhas de subtotais.
- Se nenhum tema personalizado for definido, as tabelas vão aparecer no tema branco. Caso contrário, o tema personalizado será aplicado quando for baixado.
- O ícone de classificação não aparece em tabelas dinâmicas que não foram classificadas manualmente.
- As tabelas com a opção Ajustar colunas ao tamanho ativada se estendem até a largura total do bloco.
Além disso, em tabelas com mais de 20.000 células, as seguintes diferenças podem ser notadas no PDF:
- As opções de formatação condicional diferentes de Cor de plano de fundo não aparecem mais.
- As visualizações de células em colunas numéricas não aparecem mais.
Se a opção Expandir 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.

Atenção: se a opção Expandir tabelas para mostrar todas as linhas estiver selecionada, os blocos que contêm visualizações de tabela poderão ter uma aparência um pouco diferente nos PDFs baixados do que no Looker.
Marque ou desmarque a opção Organizar os blocos do dashboard 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 conforme estão organizados nele.
Selecione Abrir no navegador para ver uma imagem do PDF em uma nova guia do navegador. Depois, você pode baixar o PDF usando os controles do navegador.
Selecione Cancelar se não quiser mais fazer o download do painel.
Selecione Fazer o download para iniciar o processo. Uma nova guia será aberta no navegador, mostrando o status do download.

Baixar um painel como CSV

É 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 uma coleção de arquivos CSV, siga estas etapas:

Selecione CSV no menu suspenso Formato.
Selecione Cancelar se não quiser mais fazer o download do painel.
Selecione Baixar para iniciar o download da sua coleção de CSVs compactada.

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

O Looker gera arquivos compactados usando a codificação UTF-8. Se os caracteres nos nomes de arquivos CSV aparecerem ilegíveis, talvez haja um conflito entre a codificação UTF-8 do Looker e a codificação padrão do sistema operacional da sua 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.

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ê baixar um painel como um 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 uma análise detalhada ou um painel do Looker. Abra o menu Opções avançadas de dados para conferir todas as opções disponíveis para o download:

Formato
Resultados
Valores de dados
Número de linhas e colunas a serem incluídas