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.

Existem outras opções para criar arquivos de projetos: você pode criar um projeto em branco e criar manualmente o modelo, ou para clonar um repositório Git público existente, consulte a página de documentação Como criar um novo projeto LookML.

Como gerar automaticamente um modelo do banco de dados

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

  2. Selecione Projetos no menu Desenvolver:

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

    • A página LookML Projects permite ver todos os seus projetos e 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 inicial, escolha Gerar modelo do esquema do banco de dados.
    • No menu suspenso Conexão, selecione o nome da sua conexão do banco de dados.
    • Em Build Views From, selecione uma opção:
      • Todas as tabelas: o gerador LookML cria um arquivo de visualização para cada tabela do banco de dados.
      • Tabela única: o gerador 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.
    • Para gerar arquivos em um esquema no banco de dados, insira o nome do esquema no campo de texto Esquemas. É possível listar vários esquemas, separados por vírgulas.
    • Para deixar os prefixos da tabela nos 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. É possível 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 Ignorar prefixos, 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 especificado de outra forma). Em seguida, o Looker abre o novo projeto no Looker IDE.
    • O gerador LookML cria pastas ambiente de desenvolvimento integrado 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 esquemas.

Nas conexões do BigQuery, se você gerar um projeto LookML do seu banco de dados, o Looker preenche automaticamente as descrições de campo com as descrições dos metadados de coluna do BigQuery, se houver.

Ele também cria uma exploração para cada tabela de banco de dados. Para começar a consultar seus dados, use o menu Explorar para selecionar o nome de uma exploração. Se o administrador tiver ativado o recurso do Labs Navegação aprimorada, selecione a opção Explorar no novo painel de navegação aprimorado à esquerda. Consulte a página de documentação Como explorar dados no Looker para mais informações.

Para renomear seu 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 o projeto, conforme descrito na página de documentação Noções básicas sobre modelos e visualizações, configurá-los para uso em produção, conforme discutido na seção Quando é preciso configurar modelos nesta página, e encontrar mais instruções na página de documentação Como criar um novo projeto 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 o projeto do Looker ao Git. Você pode gravar mudanças nos seus arquivos LookML e gerenciar as versões deles.

Geração aprimorada de LookML

Se o administrador do Looker tiver ativado o recurso Melhorias na geração de LookML, o Looker vai adicionar outros elementos ao projeto quando você gerar o projeto a partir do 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 inline de comentários ao arquivo do 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

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

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

Os administradores (ou desenvolvedores com a permissão manage_models) não precisam de uma configuração de modelo quando estiverem no modo de desenvolvimento. Isso permite que os desenvolvedores LookML funcionem facilmente no modo de desenvolvimento. No entanto, se existir uma configuração de modelo, qualquer consulta será restrita por essa configuração mesmo no modo de desenvolvimento.

Embora um desenvolvedor do LookML especifique a conexão desejada no arquivo do 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 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, todas as consultas nele vão falhar quando o modelo estiver no Modo de produção. Quando um modelo é enviado do Modo de desenvolvimento para 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 o modelo automaticamente.
  • Durante o desenvolvimento. Se você tiver desenvolvedores que não receberam a permissão manage_models (que está incluída no papel admin), o modelo precisa ser configurado antes que esses desenvolvedores possam executar consultas nesse modelo. É possível configurar o modelo antes da criação do modelo ou antes da existência do projeto. Então, quando um desenvolvedor LookML cria o projeto e o modelo, as conexões permitidas do modelo já estão configuradas e o desenvolvedor pode executar consultas com êxito.

Para desenvolvedores sem a permissão manage_models, os administradores podem limitar o acesso a determinadas conexões limitando os desenvolvedores a determinados conjuntos de modelos e limitando as conexões permitidas para esses modelos.

O Looker permite que os desenvolvedores com a permissão manage_models executem consultas em um modelo não configurado no modo de desenvolvimento. O Looker faz isso pesquisando projetos para encontrar um modelo com esse nome. O primeiro modelo encontrado com esse nome é usado para executar a consulta.