Como compreender modelos e arquivos de visualização

Nesta página, apresentamos uma visão geral dos modelos e arquivos de visualização, que são os principais componentes da maioria dos projetos do Looker. Os outros tipos de arquivos de projeto estão descritos na página de documentação Como entender outros arquivos de projeto. Para ver informações sobre como acessar arquivos de um projeto, consulte a página de documentação Como acessar e editar informações do projeto.

Arquivos de modelo

Um arquivo de modelo especifica uma conexão de banco de dados e o conjunto de explorações que usam essa conexão. Um arquivo de modelo também define os próprios "explores" e as relações deles com outras visualizações.

O "Explorar" é um ponto de partida para consultar seus dados. Em termos de SQL, uma exploração é a cláusula FROM de uma consulta. As explorações que você define no modelo são vistas pelos usuários quando visualizam o menu "Explorar" do Looker. Consulte a página de documentação Como funciona um projeto no Looker para mais informações sobre o recurso Explorar.

Em outras palavras, é no arquivo de modelo que você define quais tabelas de dados precisam ser usadas (incluindo visualizações) e como elas devem ser mescladas, se necessário.

As explorações geralmente são definidas em um arquivo de modelo. No entanto, às vezes você precisa de um arquivo "Explorar" separado para uma tabela derivada ou para estender ou refinar um recurso Explorar entre modelos.

Estrutura e sintaxe geral

Dentro das chaves, { }, você define os parâmetros da guia Explorar. Você pode usar os parâmetros join para unir outras visualizações a uma exploração em um arquivo de modelo.

Acima, vemos o explore chamado inventory_items no arquivo de modelo, além das visualizações mescladas dele. Essa definição do LookML faz com que os itens de inventário apareçam no menu Explorar e mescla dados de inventory_items com products e distribution_centers.

Para informações mais específicas sobre as estruturas LookML em um arquivo de modelo, consulte a página de documentação de termos e conceitos do LookML.

Como criar arquivos de modelo

A maioria dos desenvolvedores LookML começa com um ou mais arquivos de modelo que são criados automaticamente quando o projeto LookML é gerado de um conjunto de tabelas em um banco de dados.

Como alternativa, um desenvolvedor do Looker no modo de desenvolvimento pode criar um arquivo de modelo em branco das seguintes maneiras:

• Use a opção Criar arquivo de modelo para criar o arquivo usando o ambiente de desenvolvimento integrado do Looker. Consulte o procedimento Como criar arquivos na página de documentação Como trabalhar com pastas no ambiente de desenvolvimento integrado.
• Use o recurso de arrastar e soltar para fazer upload do arquivo do computador. Consulte a seção Como fazer upload de arquivos na página de documentação Como trabalhar com pastas no ambiente de desenvolvimento integrado para ver o procedimento. Use a extensão de arquivo .model.lkml para o arquivo que você está enviando por upload.

É possível modificar qualquer arquivo de modelo adicionando ou removendo "explores", especificando mesclagens e adicionando outras funcionalidades.

Se for necessário renomear um modelo ou qualquer objeto no modelo, não renomeie o arquivo ou o próprio objeto. Em vez disso, use o parâmetro label ou alias para mudar o nome exibido do arquivo ou objeto. Os parâmetros label e alias mudam o nome exibido e preservam o URL subjacente usado para e-mails ou outros sistemas.

Em geral, tome precauções para fazer as alterações no modelo o mais invasivas possível. Se for necessário renomear um modelo ou um objeto, use o validador de conteúdo para atualizar todas as referências ao modelo ou objeto.

Se você excluir um arquivo, o modelo não será removido dos conjuntos de modelos a que ele pertence. Se um novo arquivo de modelo for criado com o mesmo nome de um modelo excluído, o novo modelo será incluído em todos os conjuntos de modelos que incluíram o modelo excluído. Isso pode dar acesso indesejado ao novo arquivo de modelo. Os administradores do Looker podem editar conjuntos de modelos e remover um modelo excluído para evitar esse problema.

Saiba mais sobre parâmetros em arquivos de modelo

Leia as páginas de documentação de Parâmetros de modelo, Explorar parâmetros e Parâmetros de mesclagem para saber mais sobre os parâmetros LookML no arquivo de modelo.

Ver arquivos

Um arquivo de visualização geralmente define uma única "visualização" dentro do Looker. Uma visualização corresponde a uma única tabela no seu banco de dados ou uma única tabela derivada.

O arquivo de visualização especifica uma tabela para consultar e os campos (dimensões e medidas) a serem incluídos dessa tabela.

Estrutura e sintaxe geral

Dentro das chaves, cada uma das visualizações, { }, são definições de campo que geralmente correspondem a uma coluna na tabela subjacente ou a um cálculo no Looker. O Looker categoriza a maioria deles como dimensões ou medidas.

Acima, vemos a dimensão id definida como um campo na visualização Order Items. Essa definição expõe o campo ID para consultas em explorar itens do pedido.

Você também pode criar várias dimensões com base no tempo de uma só vez usando grupos de dimensões ou especificar um filtro para seus usuários com campos de filtro. Confira a página de documentação Ver parâmetros para saber mais sobre os parâmetros LookML em arquivos de visualização.

Para ver informações mais específicas sobre as estruturas LookML em um arquivo de visualização, consulte a página de documentação de termos e conceitos do LookML.

Dimensões

Os campos no Looker são divididos em dimensões e medidas. Uma dimensão pode ser uma das duas opções a seguir:

• Uma coluna na tabela subjacente

dimension: first_name {
  sql: ${TABLE}.first_name ;;
}

• Um valor calculado com base em outros campos

dimension: full_name {
  sql: CONCAT(${first_name}, ' ', ${last_name}) ;;
}

No Looker, as dimensões sempre aparecem na cláusula GROUP BY do SQL que o Looker gera.

No LookML, é possível definir diferentes tipos de dimensão ou tipos de dados diferentes.

Medidas

Uma medida calcula os valores em várias linhas. Isso é equivalente a funções de agregação SQL, como COUNT(), SUM(), AVG(), MIN() e MAX(). As medidas também podem realizar transformações simples em outras medidas. Confira nossa documentação de tipos de medidas para saber mais.

Veja acima dimensões e medidas definidas no arquivo de visualização products.

Como criar arquivos de visualização

A maioria dos desenvolvedores LookML começa com um ou mais arquivos de visualização criados automaticamente quando o projeto LookML é gerado de um conjunto de tabelas em um banco de dados. No entanto, um desenvolvedor do Looker no modo de desenvolvimento pode adicionar arquivos de visualização a um projeto LookML de várias maneiras:

• Como criar arquivos de visualização com base em tabelas de um banco de dados:

  • Gerar arquivos de visualização a partir de tabelas do banco de dados ao se conectar pela primeira vez ao banco de dados, conforme descrito na página de documentação Como gerar um modelo.
  • Gerar arquivos de visualização a partir de tabelas do banco de dados para um projeto que já está conectado a um banco de dados, conforme descrito na seção Como adicionar uma nova visualização de uma tabela de banco de dados existente abaixo nesta página.

• Criação de arquivos de visualização em branco:

  • Usando a opção Criar arquivo de visualização no ambiente de desenvolvimento integrado do Looker, conforme descrito na seção Como criar arquivos da página de documentação Como trabalhar com pastas no ambiente de desenvolvimento integrado.
  • Use o recurso de arrastar e soltar para fazer upload do arquivo do computador, conforme descrito na seção Upload de arquivos da página de documentação Como trabalhar com pastas no ambiente de desenvolvimento integrado. Use a extensão de arquivo .view.lkml para o arquivo que você está enviando por upload.

• Como criar um arquivo de visualização para uma tabela derivada:

  • Começando com um arquivo de visualização em branco usando uma das opções acima e definindo manualmente sua tabela derivada, conforme descrito na seção Como definir uma tabela derivada nativa no LookML da página de documentação Como criar tabelas nativas nativas.
  • Com o Looker para criar a tabela derivada LookML de uma exploração, conforme descrito na seção Como usar uma exploração para começar a definir suas tabelas derivadas nativas da página de documentação Como criar tabelas nativas nativas.
  • Pedir ao Looker para criar a tabela derivada LookML de uma consulta do SQL Runner, conforme descrito na página de documentação Como usar o SQL Runner para criar tabelas derivadas.

Para usar uma nova visualização, adicione-a ao arquivo de modelo usando o parâmetro explore ou use o parâmetro join para mesclá-la a um Explorar existente no arquivo de modelo.

Adicionar uma nova visualização de uma tabela de banco de dados

É possível criar um arquivo de visualização em uma tabela de banco de dados no Modo de desenvolvimento.

1. Em um projeto, clique em + na parte superior da lista de arquivos do projeto no ambiente de desenvolvimento integrado do Looker, ou clique no menu de uma pasta para criar o arquivo dentro da pasta.

2. Clique em Criar tabela de visualização.

3. O Looker exibe uma lista de tabelas associadas a uma das suas conexões. Para isso, use o menu suspenso Conexão no canto superior esquerdo.

4. Marque a caixa à esquerda do nome da tabela para criar tabelas de visualização. Recolha e expanda bancos de dados ou esquemas nessa lista para acessar todas as tabelas disponíveis.

5. Role até a parte inferior da página e clique em Criar visualizações.

6. O Looker gera visualizações contendo LookML para todas as colunas da tabela.

Saiba mais sobre parâmetros em arquivos de visualização

Saiba mais sobre os parâmetros de visualização na página de documentação Parâmetros de visualização.

Saiba mais sobre os parâmetros do LookML para dimensões, medidas, grupos de dimensões e campos de filtro na página de documentação Parâmetros de campo.