Como gerar um modelo

Nesta página, você verá as etapas para criar um novo projeto e gerar automaticamente um modelo básico do seu banco de dados.

Há outras opções para criar arquivos de projeto: é possível criar um projeto em branco e criar manualmente o modelo dele ou para clonar um repositório Git público, consulte a página de documentação Como criar um novo projeto LookML.

Como gerar um modelo automaticamente a partir do banco de dados

  1. Clique em Desenvolver na barra de menus e verifique se você está no Modo de desenvolvimento.

  2. Selecione Projetos na seção Desenvolver no painel de navegação.

  3. Na página LookML Projects, selecione New LookML Project:

    • A página LookML Projects permite que você visualize todos os projetos com os respectivos modelos. Use esta página para criar, visualizar e configurar seus projetos.

  4. Na caixa de diálogo New Project, especifique as opções para seu projeto:

    • Dê um nome ao projeto.
    • Em Ponto de partida, escolha Generate Model from Database Schema.
    • No menu suspenso Conexão, selecione o nome da sua conexão de banco de dados.
    • Em Criar visualizações a partir de, selecione uma opção:
      • Todas as tabelas: o gerador LookML cria um arquivo de visualização para cada tabela no seu banco de dados.
      • Tabela única: o gerador LookML cria uma visualização para uma tabela no seu banco de dados. Se você escolher essa opção, insira o nome da tabela do banco de dados.
    • Para gerar arquivos de apenas um esquema no banco de dados, insira o nome do esquema no campo de texto Schemas. É possível listar vários esquemas separados por vírgulas.
    • Para deixar os prefixos da tabela fora dos nomes dos arquivos de visualização, insira os prefixos do banco de dados no campo de texto Ignorar prefixos. Este campo diferencia maiúsculas de minúsculas. Você pode listar vários prefixos separados por vírgulas. Por exemplo, o nome das tabelas é dwh_orders e DBS_users. Se você digitar dwh, DBS no campo de texto Ignore Prefixes, o Looker criará arquivos de visualização chamados orders e users.
  5. Clique em Criar projeto.

    • O gerador LookML cria um arquivo de modelo para o projeto e um arquivo de visualização para cada tabela no banco de dados (a menos que seja especificado de outra forma). Em seguida, o Looker abre o novo projeto no ambiente de desenvolvimento integrado do Looker.
    • O gerador LookML cria pastas IDE para seus arquivos de visualização e modelo. Se o banco de dados tiver mais de um esquema, o gerador LookML criará uma pasta para os esquemas.

Para conexões do BigQuery, se você gerar um projeto LookML do seu banco de dados, o Looker preencherá automaticamente as descrições dos campos com as dos metadados da coluna do BigQuery, se houver.

O gerador também cria uma exploração para cada tabela de banco de dados. Para começar a consultar seus dados, use o painel Explorar para selecionar o nome de uma exploração.

Para renomear seu projeto depois de criá-lo, consulte a seção Como renomear um projeto da página de documentação Como acessar e editar informações do projeto.

É possível criar manualmente novos modelos para o projeto, conforme descrito na página de documentação Como entender os modelos e os arquivos de visualização, configurá-los para uso em produção, conforme discutido na seção Quando você precisa configurar modelos desta página e encontrar mais instruções na página de documentação Como criar um novo projeto do LookML.

Depois que os arquivos de modelo forem gerados ou criados manualmente, consulte a página de documentação Como configurar e testar uma conexão Git para mais informações sobre como conectar seu projeto do Looker ao Git. É possível registrar alterações nos seus arquivos LookML e gerenciar versões deles.

Geração de LookML aprimorada

Se o administrador do Looker tiver ativado o recurso Melhorias na geração de LookML, o Looker adicionará outros elementos ao projeto quando ele for gerado pelo banco de dados:

  • O Looker adiciona um arquivo README ao novo projeto. O arquivo README contém uma introdução ao LookML, com links e recursos para ajudar novos desenvolvedores.
  • O Looker adiciona várias explicações in-line ao arquivo de modelo e a cada arquivo de visualização.
  • Se uma visualização tiver pelo menos uma dimensão de type: number que não contenha a string id no nome, o Looker criará uma medida de type: sum e uma medida de type: average, ambas baseadas na primeira dimensão alfabética de type: number, que não contém a string id no nome.

Quando você precisa configurar modelos

A configuração de um modelo é útil pelos seguintes motivos:

  • Ele especifica que o nome de um determinado modelo se refere a um determinado modelo em um determinado projeto.
  • Ele define as conexões que o modelo pode usar.

Uma configuração de modelo não é necessária para administradores (ou desenvolvedores com a permissão manage_models) enquanto eles estão no modo de desenvolvimento. Isso permite que os desenvolvedores do LookML funcionem facilmente no modo de desenvolvimento. No entanto, se existir uma configuração de modelo, quaisquer consultas serão restringidas por ela mesmo no modo de desenvolvimento.

Embora um desenvolvedor do LookML especifique a conexão desejada no arquivo de modelo, um administrador controla quais conexões são permitidas na página LookML Projects. Se um modelo especificar usando uma conexão não permitida na configuração do modelo, a conexão não será permitida.

Um modelo precisa ter uma configuração nos seguintes cenários:

  • Quando um modelo é enviado para produção pela primeira vez. Se o modelo não estiver configurado, qualquer consulta nele falhará quando estiver no modo de produção. Quando um modelo é enviado do modo de desenvolvimento para a produção pela primeira vez, o Looker o configura automaticamente se o nome dele for exclusivo para a instância do Looker. No entanto, se você tiver um modelo configurado com o mesmo nome em outro projeto, o Looker não vai configurá-lo automaticamente.
  • Durante o desenvolvimento. Se você tiver desenvolvedores que não receberam a permissão manage_models (incluída no papel admin), o modelo precisará ser configurado para que eles possam executar consultas nesse modelo. É possível configurar o modelo antes ou depois de o projeto existir. Em seguida, quando um desenvolvedor do LookML cria o projeto e o modelo, as conexões permitidas do modelo já estão configuradas e o desenvolvedor pode executar as consultas.

O Looker permite que desenvolvedores com a permissão manage_models executem consultas em um modelo não configurado no modo de desenvolvimento. Para fazer isso, o Looker procura um modelo com esse nome nos projetos. O primeiro modelo encontrado com esse nome é usado para executar a consulta.