Como gerar um modelo

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

Há outras opções para criar arquivos de projeto. Você pode criar um projeto em branco e gerar manualmente o modelo dele ou clonar um repositório público do Git, consulte a página de documentação Como criar um novo projeto do LookML.

Como gerar automaticamente um modelo do seu 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 Projetos do LookML, selecione Novo projeto do LookML:

    • Na página Projetos do LookML, é possível visualizar 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:

    • Nome do projeto: dê um nome ao projeto. Escolha o nome do projeto com cuidado e o considere um ID permanente, já que o Looker usa o nome do projeto das seguintes maneiras:

      • Identificar o projeto para chamadas de API que têm o parâmetro project_id.
      • Identificar o projeto no banco de dados interno da instância do Looker.
      • Identificar o projeto para importação de projeto local.
      • Para exibir o projeto na página Projetos do LookML.
      • Para exibir o projeto na seção Desenvolver do painel de navegação do Looker.
      • Como parte do URL de arquivos de projeto. Por exemplo, em uma instância do Looker com um URL example.looker.com, o arquivo de manifesto do projeto chamado ecommerce pode ser encontrado neste URL: https://example.looker.com/projects/ecommerce/files/manifest.lkml.
    • Ponto de partida: escolha Gerar modelo do esquema de banco de dados.

    • Conexão: no menu suspenso, selecione o nome da sua conexão de banco de dados.

    • Build Views From: selecione uma das seguintes opções:

      • Todas as tabelas: o gerador do LookML cria um arquivo de visualização para cada tabela no banco de dados.
      • Tabela única: o gerador do LookML cria uma visualização para uma tabela no banco de dados. Se você escolher essa opção, insira o nome da tabela do banco de dados.
    • Esquemas: para gerar arquivos de apenas um esquema no seu banco de dados, digite o nome do esquema no campo de texto Esquemas. É possível listar vários esquemas separados por vírgulas.

    • Ignorar prefixos: para deixar os prefixos de tabela fora dos nomes dos arquivos da visualização, insira os prefixos do seu banco de dados no campo Ignorar prefixos. Este campo diferencia maiúsculas de minúsculas. Você pode listar vários prefixos separados por vírgulas. Por exemplo, suas tabelas são chamadas de dwh_orders e DBS_users. Se você inserir dwh, DBS no campo de texto Ignorar prefixos, o Looker vai criar arquivos de visualização com os nomes orders e users.

  5. Clique em Criar projeto.

    • O gerador do 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 especificado de outra forma). Depois, o Looker abre o novo projeto no ambiente de desenvolvimento integrado do Looker.
    • O gerador do LookML cria pastas do ambiente de desenvolvimento integrado para os arquivos de visualização e modelo. Se o banco de dados tiver mais de um esquema, o gerador do LookML vai criar uma pasta para os esquemas.

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

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

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

É possível criar manualmente novos modelos para seu projeto, conforme descrito na página de documentação Noções básicas sobre arquivos de modelo e visualização, configurá-los para uso na produção conforme discutido na seção Quando você precisa configurar modelos nesta 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 do Git para saber 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 Labs Melhoria do LookML Generation, o Looker vai adicionar outros elementos ao projeto quando ele for gerado no banco de dados:

  • O Looker adiciona um arquivo README ao novo projeto. O arquivo README contém uma introdução ao LookML, além de links e recursos para ajudar novos desenvolvedores do LookML.
  • O Looker adiciona várias explicações de comentários inline 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 com base na primeira dimensão em ordem alfabética de type: number que não contém a string id no nome.

Quando você precisa configurar modelos

Configurar um modelo é útil pelos seguintes motivos:

  • Ele especifica que um determinado nome de modelo se refere a um modelo específico em um determinado projeto.
  • Ele define as conexões que o modelo tem permissão para usar.

A configuração de um modelo não é necessária para administradores (ou desenvolvedores com a permissão manage_models ou manage_project_models) enquanto eles estão no Modo de Desenvolvimento. Isso permite que os desenvolvedores do LookML trabalhem no Modo de Desenvolvimento. No entanto, se existir uma configuração de modelo, todas as consultas serão limitadas por essa configuração, mesmo no Modo de Desenvolvimento.

Ainda que um desenvolvedor do LookML especifique a conexão pretendida no arquivo de modelo, um administrador controla quais conexões são permitidas na página Projetos do LookML. Se um modelo especificar o uso de uma conexão que não é permitida na configuração dele, 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, todas as consultas nele vão falhar quando ele 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 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 configurar automaticamente.
  • Durante o desenvolvimento. Se você tiver desenvolvedores que não receberam a permissão manage_models (incluída no papel admin) ou a permissão manage_project_models, o modelo precisa ser configurado antes que esses desenvolvedores possam executar consultas nele. É possível configurar o modelo antes dele existir ou do projeto. Depois, 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 os desenvolvedores com as permissões manage_models ou manage_project_models executem consultas em um modelo não configurado no Modo de Desenvolvimento. Para isso, o Looker procura um modelo com esse nome em projetos. O primeiro modelo encontrado com esse nome é usado para executar a consulta.