Esta página foi traduzida pela API Cloud Translation.

Transferir conteúdo

Esta página descreve como transferir conteúdo (visualizações ou dados) do Looker.

Para transferir conteúdo, um administrador do Looker tem de lhe conceder a autorização download_with_limit ou download_without_limit.

O processo e as opções de transferência de conteúdo e formatação do conteúdo transferido variam consoante a transferência seja feita a partir de um Look ou de uma exploração, a partir de um painel de controlo ou a partir de uma consulta de resultados unidos.

Transferir dados de um Look ou de uma exploração

Para transferir dados de uma página de análise detalhada ou de exploração, selecione o menu de roda dentada na parte superior direita e selecione Transferir.

O Looker apresenta a janela Transferir, onde pode atribuir um nome e formatar a transferência.

As secções seguintes explicam cada campo na janela Transferir:

Formato
Nome do ficheiro
Resultados
Valores de dados
Número de linhas e colunas a incluir

Formato

As transferências para formatos que usam o renderizador (PNG e PDF) usam os resultados do modo de produção. Se a transferência estiver noutro formato, são apresentados os resultados do modo em que se encontra: desenvolvimento ou produção.

Pode transferir dados de Looks e Explores nos seguintes formatos de ficheiros:

TXT (valores separados por tabulações)
Folha de cálculo do Excel (Excel 2007 ou posterior)
CSV
JSON
HTML
Markdown
PNG (imagem da visualização)

Ao escolher o formato de dados para transferência, se não vir as opções HTML ou PNG (imagem de visualização) (para Looks), fale com o administrador do Looker sobre a instalação da versão adequada do renderizador Chromium para a sua instância do Looker.

Para o formato JSON, o Looker usa etiquetas de campo como o respetivo valor renderizado na saída JSON. Consulte a publicação da comunidade Alteração na formatação JSON para mais informações sobre como o Looker renderiza campos no formato JSON.

As tabelas transpostas só são renderizadas em transferências de PNG.

Para os programadores do Looker, se estiver no modo de desenvolvimento, as transferências de dados na maioria dos formatos de ficheiros consultam o seu modelo tal como está no modo de desenvolvimento. Os formatos de ficheiro PDF e PNG são a exceção. As transferências de dados nesses formatos de ficheiro consultam sempre o seu modelo como se estivesse no modo de produção.

Nome do ficheiro

Pode introduzir um nome de ficheiro para a transferência ou usar o nome de ficheiro predefinido que é pré-preenchido no campo. O Looker anexa automaticamente a extensão de ficheiro adequada com base na sua seleção no campo Formato.

Resultados

Na secção Resultados, escolha se quer que as definições de visualização sejam aplicadas à transferência de dados TXT, Excel, CSV, JSON, HTML ou Markdown.

Se escolher Com opções de visualização aplicadas, o Looker aplica algumas das definições de visualização à sua transferência. Qualquer uma das seguintes definições nos menus Gráfico, Série e Formatação que estejam configuradas para a visualização é aplicada à transferência de dados:

Mostrar números das linhas
Mostrar totais
Mostrar totais das linhas
Limitar linhas apresentadas a um máximo de 500 linhas apresentadas ou ocultadas
Mostrar nome completo do campo
Etiquetas personalizadas para cada coluna (o Looker usa etiquetas de campo como o valor renderizado na respetiva saída JSON. Consulte a publicação da comunidade do Looker Alteração na formatação JSON para mais informações sobre como o Looker renderiza campos no formato JSON).
Formatação condicional para transferências de visualizações de gráficos de tabelas no formato Excel

A formatação condicional é apresentada em entregas do Excel de análises detalhadas e explorações com visualizações de gráficos de tabelas apenas se a regra ao longo de uma escala for aplicada.

Algumas definições de visualização não são aplicadas aos resultados transferidos. Por exemplo:

A cor do texto do cabeçalho e a cor de fundo personalizadas não são aplicadas aos resultados transferidos, exceto nos ficheiros PNG.
Para tabelas de resultados com tabelas dinâmicas e várias medidas, cada valor da tabela dinâmica é repetido nas colunas em vez de ser representado como uma coluna unida. As transferências de HTML e PNG são uma exceção, pelo que a coluna unida é preservada.
Quando transfere dados de um painel de controlo, o título do cartão do painel de controlo não é incluído nos resultados transferidos.
Os valores Totais e Totais das linhas estão incluídos nos resultados transferidos, mas a linha e as colunas respetivas não estão etiquetadas.
Os subtotais não são transferidos para consultas que não podem ser transmitidas.

As colunas nos gráficos de tabelas que foram reorganizadas manualmente aparecem na ordem original na transferência se a consulta incluir qualquer um dos seguintes elementos:

campos que são deliberadamente ocultados da visualização
Campos presentes no SQL subjacente, mas que não estão presentes na visualização, como os seguintes:
- 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á presente 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ões ativado
Três ou mais campos dinâmicos
Totais das linhas ativados
Um ou mais campos que incluem o parâmetro LookML order_by_field na definição do campo

Se escolher Conforme apresentado na tabela de dados, as opções de visualização não são aplicadas e a transferência aparece como a tabela de dados na secção Dados do Look ou Explorar.

Valores de dados

Na secção Valores dos dados, escolha como quer que os resultados da consulta transferidos sejam apresentados:

Se escolher Sem formatação, o Looker não aplica nenhuma formatação especial aos resultados da consulta, como arredondar números compridos ou adicionar carateres especiais que os programadores do Looker possam ter implementado. Normalmente, é preferível que os dados sejam enviados para outra ferramenta para processamento.
Se escolher Formatado, o aspeto dos dados é semelhante à experiência Explorar no Looker, embora algumas funcionalidades (como a associação) não sejam suportadas por todos os tipos de ficheiros. Por exemplo, qualquer formatação aplicada com o parâmetro html não é aplicada a transferências de TXT, CSV, Excel ou JSON.

Número de linhas e colunas a incluir

Pode escolher a quantidade de dados que quer transferir 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 devolvidos pela consulta. Antes de selecionar esta opção, consulte a secção Todos os resultados nesta página.
Personalizado: um número personalizado de linhas. Os utilizadores que têm autorizações de download_with_limit estão limitados a 5000 linhas. Normalmente,o limite para outros utilizadores é de 100 000.

Todos os resultados

Quando seleciona Executar num Look ou numa exploração, o Looker verifica as suas autorizações e determina se a complexidade da consulta e o dialeto da base de dados permitem transferir a consulta completa. Se tiver as autorizações (para resultados acima de um limite definido) e o Looker determinar que é possível transferir toda a consulta, a opção Todos os resultados fica disponível na janela Transferir.

A opção Todos os resultados está normalmente desativada para consultas que realizam qualquer uma das seguintes ações:

Envolvem totais das linhas ou cálculos de tabelas
Use os tipos de medidas percentagem do total, percentagem do anterior ou totais em execução
Obtenha dados de um dialeto de base de dados que não pode transmitir resultados
Incluir colunas dinâmicas que o Looker calcula porque os dados provêm de um dialeto de base de dados que não consegue calcular as tabelas dinâmicas

Mesmo quando a opção Todos os resultados está disponível, deve ter cuidado ao transferir 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 folhas de cálculo ou até mesmo a sua instância do Looker.

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

Streaming de resultados de consultas

O streaming refere-se à capacidade do Looker de processar dados em blocos, em vez de todos de uma vez. Se o Looker puder transmitir um conjunto de resultados, são possíveis transferências ilimitadas. A opção Todos os resultados baseia-se na capacidade do Looker de transmitir resultados e Todos os resultados não está disponível se não for possível transmitir resultados.

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

Cálculos da tabela: não é possível fazer streaming de cálculos da tabela. Por conseguinte, para transferir resultados ilimitados para uma consulta, tem de remover os cálculos de tabelas da consulta.
Limitações da base de dados: algumas bases de dados não podem fazer streaming se forem incluídas tabelas dinâmicas na consulta. Para estas bases de dados, tem de remover as tabelas dinâmicas para transferir resultados ilimitados. Algumas bases de dados não podem transmitir resultados, o que significa que as transferências ilimitadas não são possíveis.

Estas bases de dados suportam o 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 & 9	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

Estas são as bases de dados que suportam o streaming com tabelas dinâmicas aplicadas:

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 & 9	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 ordenações da consulta

Quando seleciona Todos os resultados, também pode ver a opção Remover todas as ordenações da consulta. Esta opção impede a ordenação na sua consulta antes de transferir os resultados. A seleção desta opção pode acelerar a transferência, uma vez que a ordenação de uma consulta pode ser dispendiosa para o desempenho de determinados tipos de bases de dados.

A opção Remover todas as ordenações da consulta não é suportada para resultados com tabelas dinâmicas.

Permitir resultados grandes

Quando transfere um grande conjunto de resultados no Looker através do Google BigQuery como dialeto da base de dados e seleciona Todos os resultados, pode ver a opção Permitir resultados grandes. Isto deve-se ao facto de o Google BigQuery ter um tamanho máximo de resposta para resultados de consultas, conforme descrito no tópico da documentação do Google Cloud Escreva resultados de consultas. Para transferir resultados que excedam o tamanho máximo de resposta do BigQuery, o Looker tem de executar um processo diferente.

Se selecionar Permitir resultados grandes, o processo de transferência é afetado da seguinte forma:

A allowLargeResultsopção do BigQuery está definida como true para a consulta.
As cláusulas ORDER BY na consulta são removidas.
A consulta escreve num esquema temporário de PDT e requer autorização para escrever num.
Os resultados da consulta são armazenados neste esquema temporário de rascunho com um nome de tabela aleatório durante uma hora.

Transferir ou abrir no navegador

Depois de selecionar as opções, pode selecionar o botão Transferir para transferir um ficheiro para o computador ou selecionar Abrir no navegador para ver o ficheiro no navegador.

Transferir dados de uma consulta de resultados unidos

Para transferir consultas de resultados unidos, pode guardar a consulta num painel de controlo e, em seguida, transferir o painel de controlo como um PDF ou uma coleção de ficheiros CSV. No entanto, tem de transferir o painel de controlo completo. Não pode transferir os dados de apenas um mosaico baseado numa consulta de resultados unidos.

Transferir dados de um painel de controlo

Para transferir o painel de controlo completo, selecione Transferir no menu de três pontos do painel de controlo.

Esta ação abre uma caixa de diálogo que lhe permite selecionar PDF ou CSV como formato de transferência.

Transferir um painel de controlo como PDF

Pode transferir todo o painel de controlo como um PDF, o que significa que recebe um PDF que apresenta o título do painel de controlo, todos os filtros do painel de controlo, alguns ou todos os mosaicos do painel de controlo e o fuso horário em que o painel de controlo foi executado. O PDF também inclui uma indicação de tempo que mostra quando o painel de controlo foi transferido.

As transferências em formato PDF devolvem sempre dados do modelo como se estivesse no modo de produção, mesmo que esteja no modo de desenvolvimento.

Para transferir um painel de controlo como PDF, siga estes passos:

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

A opção Ajustar página ao painel de controlo é a predefinição e dimensiona o PDF à largura predefinida para painéis de controlo (1260 px). Outras opções de tamanho do papel redimensionam o PDF para corresponder a um tamanho de papel padrão e ajustar todo ou parte do painel de controlo ao mesmo. Consoante o esquema do painel de controlo e o tamanho do papel selecionado, algumas saídas de PDF podem diferir do esquema do painel de controlo quando visualizadas no Looker. Por exemplo, quando o tamanho do papel selecionado é mais estreito do que o painel de controlo, pode ter problemas com o espaçamento ou outra formatação e ter de fazer alguns ajustes:
- Pode ser necessário redimensionar visualizações grandes ou grupos de mosaicos sobrepostos para caberem no PDF.
- Os mosaicos que contêm tabelas podem não mostrar todas as colunas da tabela no PDF.
- A largura dos mosaicos pode ser reduzida para se ajustar ao PDF. Da mesma forma, os mosaicos que requerem o deslocamento na app Looker podem não ser expandidos para apresentar todo o conteúdo.
Se não vir a opção Tamanho do papel, contacte o administrador do Looker para instalar a versão mais recente do renderizador Chromium para a sua instância do Looker.
Se selecionar uma opção diferente de Ajustar página ao painel de controlo no menu pendente Tamanho do papel, é apresentada uma opção Orientação. Pode optar por orientar o painel de controlo na posição vertical ou horizontal.
Selecione ou deixe desmarcada a opção Expandir tabelas para mostrar todas as linhas. Se selecionar esta opção, para mosaicos do painel de controlo que usam visualizações de tabelas, o PDF mostra todas as linhas disponíveis na visualização de tabela e não apenas as linhas visíveis na miniatura do mosaico do painel de controlo. Se não selecionar esta opção, apenas as linhas visíveis na miniatura sem deslocar a página aparecem no PDF. Os filtros de painel de controlo e de consulta continuam a ser aplicados, tal como as definições de visualização, como os limites de linhas, os limites de colunas e as definições feitas com a opção Limitar linhas apresentadas.

Se a opção Expandir tabelas para mostrar todas as linhas estiver selecionada, os mosaicos do painel de controlo que contêm visualizações de tabelas podem ter um aspeto ligeiramente diferente nos PDFs transferidos do que no Looker. As seguintes diferenças podem ser percetíveis no PDF:
- As personalizações das cores de fundo e dos tamanhos dos tipos de letra são removidas dos cabeçalhos das colunas e das linhas de subtotais.
- Se não estiver definido nenhum tema personalizado, o Tables é apresentado no tema branco. Caso contrário, o tema personalizado é aplicado quando é transferido.
- O ícone de ordenação não aparece em tabelas dinâmicas que não foram ordenadas manualmente.
- As tabelas com a opção Dimensionar colunas para ajustar ativada estendem-se à largura total do mosaico.
Além disso, para tabelas com mais de 20 000 células, podem ser percetíveis as seguintes diferenças no PDF:
- As opções de formatação condicional que não sejam Cor de fundo já não são apresentadas.
- As visualizações de células em colunas numéricas já não são apresentadas.
Se não vir a opção Expandir tabelas para mostrar todas as linhas, fale com o administrador do Looker acerca da instalação da versão adequada do renderizador do Chromium para a sua instância do Looker.

Aviso: se a opção Expandir tabelas para mostrar todas as linhas estiver selecionada, os mosaicos que contêm visualizações de tabelas podem ter um aspeto ligeiramente diferente nos PDFs transferidos do que no Looker.
Selecione ou desmarque a opção Organizar mosaicos do painel de controlo numa única coluna. Se selecionar esta opção, o PDF apresenta os mosaicos do painel de controlo numa única coluna vertical. Se não selecionar esta opção, os mosaicos do painel de controlo aparecem conforme estão organizados no painel de controlo.
Selecione Abrir no navegador para ver uma imagem do PDF num novo separador do navegador. A partir daí, pode optar por transferir o PDF através dos controlos do navegador.
Selecione Cancelar se já não quiser transferir o painel de controlo.
Selecione Transferir para iniciar a transferência. É aberto um novo separador no navegador, que mostra o estado da transferência.

Transferir um painel de controlo como CSVs

Pode transferir todos os mosaicos de consultas do painel de controlo como uma coleção comprimida de ficheiros CSV. Os mosaicos de texto não estão incluídos no ficheiro ZIP. Para transferir o seu painel de controlo como uma coleção de ficheiros CSV, siga estes passos:

Selecione CSV no menu pendente Formato.
Selecione Cancelar se já não quiser transferir o painel de controlo.
Selecione Transferir para iniciar a transferência da sua coleção CSV comprimida.

Quando transfere um painel de controlo como ficheiros CSV, as opções de formatação de transferências, como a definição de limites de linhas personalizados ou a escolha de todos os resultados, não estão disponíveis. Os limites de linhas nos ficheiros transferidos estão correlacionados com os limites de linhas nos mosaicos correspondentes.

O Looker gera ficheiros comprimidos com a codificação UTF-8. Se os carateres nos nomes dos ficheiros CSV aparecerem distorcidos, pode haver um conflito entre a codificação UTF-8 do Looker e a codificação predefinida do sistema operativo da sua máquina ou de uma aplicação de terceiros. O Looker sugere que use um extrator de ficheiros que reconheça UTF-8, como o 7-Zip, e certifique-se de que todas as aplicações de terceiros estão configuradas para suportar UTF-8.

Transferir dados de mosaicos do painel de controlo

Não pode transferir os dados dos mosaicos do painel de controlo com base em consultas de resultados unidos, mas os dados dos mosaicos de resultados unidos são incluídos se transferir um painel de controlo como PDF ou como uma coleção de ficheiros CSV.

Para transferir os dados de um mosaico do painel de controlo, selecione o ícone de três pontos no mosaico e selecione Transferir dados:

Esta ação abre uma caixa de diálogo com várias opções semelhantes às de uma análise detalhada ou de uma exploração. Expanda o menu Opções de dados avançadas para ver todas as opções disponíveis para a sua transferência:

Formato
Resultados
Valores de dados
Número de linhas e colunas a incluir