Como gerar um modelo

Nesta página, você encontra 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 os arquivos do projeto: crie um projeto em branco e crie o modelo manualmente ou para clonar um repositório Git público já existente. Consulte a página de documentação Como criar um novo projeto do LookML.

Como gerar automaticamente um modelo do seu banco de dados

É possível gerar automaticamente um modelo do seu banco de dados na seção Develop do Looker ou usando o botão Create no painel de navegação à esquerda.

Como gerar um modelo na seção Desenvolvimento

  1. Clique em Desenvolver no painel de navegação à esquerda 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, você pode conferir todos os seus projetos e os respectivos modelos. Use essa página para criar, visualizar e configurar seus projetos.

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

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

      • Para identificar o projeto de chamadas de API que têm o parâmetro project_id.
      • Para identificar o projeto no banco de dados interno da instância do Looker.
      • Para identificar o projeto para a importação de projeto local.
      • Para mostrar o projeto na página Projetos do LookML.
      • Mostrar o projeto na seção Desenvolver do painel de navegação do Looker.
      • Como parte do URL dos arquivos do 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 com base no esquema do banco de dados.

    • Conexão: no menu suspenso, selecione o nome da conexão do 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 seu 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 dele 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 de arquivos de visualização, insira os prefixos do seu banco de dados no campo Ignorar prefixos. Esse campo diferencia maiúsculas de minúsculas. É possível listar vários prefixos separados por vírgulas. Por exemplo, as tabelas têm os nomes dwh_orders e DBS_users. Se você inserir dwh, DBS no campo de texto Ignore Prefixes, 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 modelo para o projeto, bem como um arquivo de visualização para cada tabela no banco de dados (a menos que especificado de outra forma). Em seguida, o Looker abre o novo projeto no ambiente de desenvolvimento integrado do Looker.
    • O gerador do LookML cria pastas do IDE para seus arquivos de visualização e modelo. Se o banco de dados tiver mais de um esquema, o gerador do LookML criará uma pasta para os esquemas.

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

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

Para renomear um 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 Noções básicas sobre modelos e visualizar arquivos, configurá-los para uso na produção conforme discutido na seção Quando precisar 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 mudanças nos arquivos do LookML e gerenciar as versões deles.

Geração de um modelo usando o botão Criar

Para criar um projeto e gerar um modelo usando o botão Criar, siga estas etapas:

  1. Clique no botão Criar no painel de navegação à esquerda.
  2. Selecione a opção de menu Modelo LookML.
  3. Verifique se você está no modo de desenvolvimento.
  4. Quando você estiver no modo de desenvolvimento, a página Criar um projeto será aberta.
  5. Se você quiser selecionar visualizações básicas para análises detalhadas ou personalizar outras opções avançadas, como ignorar prefixos de tabela em nomes de arquivos de visualização gerados, importar metadados de descrição de campo do banco de dados, determinar a criação de arquivos de modelo e selecionar arquivos readme gerados automaticamente, ative a opção Criação avançada de projetos.
  6. Selecione uma conexão de banco de dados no menu suspenso Selecionar conexão de banco de dados. Se você tiver acesso a qualquer projeto que já use a conexão, eles vão aparecer assim que a conexão for selecionada. Você pode usar um projeto disponível e adicionar um novo modelo a ele ou criar um novo projeto LookML. Se você optar por adicionar o modelo a um projeto, a seção Criar modelo vai aparecer como o primeiro passo na página Criar um projeto, em que é possível nomear o modelo. Depois de fazer as seleções, clique em Próxima.
  7. Na seção Selecionar dados, escolha os esquemas, as tabelas e os campos a serem usados no modelo. As visualizações serão criadas com base nas tabelas. Depois de fazer suas seleções, clique em Próxima.
  8. Selecione uma chave primária para cada tabela. Isso ajuda o Looker na mesclagem das suas tabelas. Depois de fazer suas seleções, clique em Próxima.
  9. Se você ativou a opção Criação de projeto avançada, selecione as visualizações base para Análises. Selecione cada visualização que você quer usar como a base de uma Análise. Para cada visualização selecionada, o sistema mescla automaticamente o maior número possível de visualizações. Somente as visualizações com uma chave primária identificada na etapa anterior podem ser usadas em uma mesclagem. Depois de fazer as seleções, clique em Próxima.
  10. Se você ativou a opção Criação de projeto avançada, faça as seguintes seleções na seção Opções avançadas:
    • Ignorar prefixos: para ignorar os prefixos da tabela nos nomes dos arquivos de visualização gerados, insira os prefixos do banco de dados em uma lista separada por vírgulas nesse campo. Esse campo diferencia maiúsculas de minúsculas. É possível listar vários prefixos, separados por vírgulas. Por exemplo, as tabelas têm os nomes dwh_orders e DBS_users. Se você inserir dwh, DBS no campo de texto Ignore Prefixes, o Looker vai criar arquivos de visualização com os nomes orders e users.
    • Descrições de campo: selecione a caixa de seleção Importar metadados de descrição do campo para usar as descrições de campo disponíveis no banco de dados como descrições do LookML para as dimensões geradas.
    • Processamento de arquivos de modelo: escolha se um arquivo de modelo será criado ou não. Se você optar por criar um arquivo de modelo, insira o nome do arquivo no campo Nome do modelo.
    • Guia de primeiros passos: marque a caixa de seleção Gerar um arquivo Leiame que descreva como usar a saída para gerar um arquivo Leiame que descreva como usar o projeto.
  11. Clique em Generate Model para gerar os arquivos do projeto. O Looker direciona você aos arquivos no ambiente de desenvolvimento integrado do Looker depois que eles são gerados.

Geração aprimorada do LookML

Se o administrador do Looker tiver ativado o recurso de laboratórios Geração aprimorada do LookML, o Looker vai adicionar outros elementos ao projeto quando você o gerar 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.
  • 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 vai 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 é preciso configurar modelos

Configurar um modelo é útil pelos seguintes motivos:

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

Não é necessário uma configuração de modelo para administradores (ou desenvolvedores com a permissão manage_models ou manage_project_models) enquanto eles estiverem no modo de desenvolvimento. Isso permite que os desenvolvedores do LookML trabalhem no modo de desenvolvimento. No entanto, se houver uma configuração de modelo, todas as consultas serão limitadas por ela, mesmo no Modo de Desenvolvimento.

Embora 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 configura o modelo 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 configurar esse modelo 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 precisará ser configurado antes que eles possam executar consultas nele. É possível configurar o modelo antes da criação do modelo ou do projeto. Assim, quando um desenvolvedor do LookML criar o projeto e o modelo, as conexões permitidas do modelo já estarão configuradas e o desenvolvedor poderá executar consultas.

O Looker permite que os desenvolvedores que tenham a permissão 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 nos projetos. O primeiro modelo encontrado com esse nome é usado para executar a consulta.