Gerar um modelo do LookML

Esta página de documentação descreve as etapas para gerar automaticamente um modelo básico do LookML usando a página Criar um modelo. A página Criar um modelo também pode ser usada para criar um projeto que vai hospedar seu modelo.

Há outras opções para criar arquivos de modelo:

  • É possível criar manualmente arquivos de modelo e outros arquivos de projeto no ambiente de desenvolvimento integrado.

  • Para usar o método legado para criar projetos e gerar modelos, clique em uma das opções a seguir, que vão levar você à página Novo projeto legado:

    • o link no banner na parte de cima da página Criar um modelo
    • o botão Adicionar LookML na seção Projetos pendentes da página Projetos

    Na página New Project, siga as etapas na documentação Criar um novo projeto do LookML.

Como acessar a página Criar um modelo

Acesse a página Criar um modelo das seguintes maneiras:

Para acessar a página Criar um modelo, você precisa estar no Modo de desenvolvimento.

Para acessar a página Criar um modelo, você precisa ser um administrador do Looker ou ter a permissão develop.

Na seção Develop

Para acessar a página Criar um modelo na seção Desenvolver, siga estas etapas.

  1. Clique em Desenvolver no painel de navegação à esquerda.

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

  3. Essa seleção abre a página Projetos do LookML. Na página Projetos do LookML, você pode conferir todos os projetos a que tem acesso e os respectivos modelos. Na página Projetos do LookML, selecione o botão Novo modelo para abrir a página Criar um modelo.

No botão Criar

Para acessar a página Criar um modelo pelo botão Criar, siga estas etapas.

  1. No menu de navegação principal, clique no botão Criar.
  2. Selecione Modelo do LookML no menu suspenso. A página Criar um modelo será aberta.

Gerar um modelo

A página Criar um modelo é dividida em seções. Para gerar um modelo, siga as etapas nas seções a seguir. Depois de cada seção, clique em Próxima para salvar sua entrada e passar para a próxima seção.

  1. Selecionar conexão de banco de dados:

    • Selecionar conexão de banco de dados: selecione uma conexão de banco de dados no menu suspenso. Você também pode escolher a opção Create New Connection no menu suspenso. Isso leva você à página Conectar seu banco de dados ao Looker, onde é possível criar uma nova conexão.

    • Se você tiver acesso a projetos que já usam a conexão, eles vão aparecer quando a conexão for selecionada. Você pode adicionar o novo modelo a um projeto disponível ou criar um novo projeto do LookML para o modelo.

    • Nome do projeto do LookML: se você quiser criar um novo projeto do LookML para o modelo, insira um nome de projeto neste campo. Os nomes de projetos diferenciam maiúsculas de minúsculas e permitem apenas caracteres alfanuméricos, _, . e -. Escolha o nome do projeto com cuidado e considere-o como um ID permanente. Os novos projetos são configurados usando um repositório Git simples.

    • Selecione a caixa de seleção Generate a Readme file that gives more information about using LookML se quiser que o Looker adicione 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.

    • Clique no botão Próxima para salvar as entradas e passar para a próxima seção.

  2. Selecione as tabelas:

    • Se você estiver usando uma conexão do BigQuery, selecione o projeto do Google Cloud em que o conjunto de dados está no menu suspenso Selecionar projeto do GCP ou pesquise o projeto no campo Pesquisar nome do projeto. Por padrão, o projeto de armazenamento do Google Cloud é mostrado no menu suspenso, se existir. Caso contrário, o projeto de faturamento do Google Cloud é mostrado.
    • Na tabela, selecione os conjuntos de dados (BigQuery) ou esquemas (outros dialetos) a serem usados no modelo.
    • Depois que os conjuntos de dados ou esquemas forem selecionados, use a seta à direita de cada nome para abrir a guia Tabelas e selecionar as que você quer incluir. As visualizações serão criadas com base nas tabelas.
    • Depois que as tabelas forem selecionadas, use a seta à direita de cada nome de tabela para abrir a guia Campos e selecionar cada campo que você quer incluir.
    • Ignorar prefixos: se você quiser ignorar os prefixos de tabela nos nomes dos arquivos de visualização gerados, insira os prefixos do banco de dados em uma lista separada por vírgulas neste campo. Esse campo diferencia maiúsculas de minúsculas. É possível listar vários prefixos, separados por vírgulas. Por exemplo, suas tabelas têm os títulos dwh_orders e DBS_users. Se você inserir dwh, DBS no campo Ignore Prefixes, o Looker vai criar arquivos de visualização com os nomes orders e users.
    • Importar descrições de campo: selecione essa caixa de seleção para usar as descrições de campo disponíveis no banco de dados como descrições do LookML para as dimensões geradas.
    • Clique no botão Próxima para salvar as entradas e passar para a próxima seção.

  3. Selecionar chaves primárias:

    • Selecione uma chave primária para cada tabela selecionada. Isso ajuda o Looker na mesclagem das suas tabelas.
    • Esta etapa é opcional. Para pular, não selecione nenhuma chave primária.
    • Clique no botão Próxima para salvar as entradas e passar para a próxima seção.

  4. Selecione as análises para criar:

    • Selecione cada visualização que você quer usar como base para um Explore. 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.
    • Essa etapa é opcional. Para pular, não selecione nenhuma visualização.
    • Clique no botão Próxima para salvar as entradas e passar para a próxima seção.

  5. Insira o nome do modelo:

  6. Clique em um dos botões a seguir para gerar os arquivos do modelo e, se selecionado, o novo projeto:

    • Concluir e visualizar modelo: o Looker leva você aos arquivos no ambiente de desenvolvimento integrado do Looker.
    • Concluir e analisar dados: o Looker leva você à Análise que corresponde ao primeiro arquivo de visualização selecionado na seção Selecionar análises para criar.

  7. Se você criou um projeto e quer conectá-lo a um repositório diferente do repositório do Git que o Looker usou para criar o projeto, clique no botão Reset Git Connection na guia Configuration da página "Project Settings" do projeto para concluir o processo.

Quando você precisar 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 projeto específico.
  • Ele define as conexões que o modelo pode usar.

Não é necessário configurar um 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 uma configuração de modelo existir, todas as consultas serão limitadas por essa configuração, mesmo no modo de desenvolvimento.

Embora um desenvolvedor do LookML especifique a conexão pretendida 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 que não é permitido 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 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 o modelo automaticamente.
  • Durante o desenvolvimento. Se você tiver desenvolvedores que não receberam a permissão manage_models (incluída no papel admin) ou 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. Em seguida, quando um desenvolvedor do LookML cria o modelo, as conexões permitidas já estão configuradas, e o desenvolvedor pode executar consultas.

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

Como configurar modelos planejados

Os administradores do Looker podem usar o botão Configure New Model na parte de cima da página LookML Projects para adicionar uma configuração a um modelo existente ou a um modelo planejado que ainda não existe.

Configurar um modelo com antecedência é útil se os desenvolvedores não tiverem recebido a permissão manage_models ou manage_project_models. Se um administrador configurar o modelo para os desenvolvedores, eles poderão executar consultas assim que gerarem ou criarem o arquivo do modelo.

Os administradores também podem especificar quais conexões de banco de dados podem ser usadas pelo modelo ou permitir que ele use qualquer conexão atual ou futura. Os desenvolvedores do Looker usam o parâmetro connection do LookML para especificar no arquivo de modelo qual conexão o modelo deve usar. Se um desenvolvedor especificar uma conexão que um administrador não permitiu na configuração do modelo, nenhuma consulta nesse modelo será executada.

Quando um administrador configura um novo modelo com antecedência e cria um projeto como parte dessa configuração, esse projeto é mostrado na seção Projetos pendentes da página Projetos.

Gerar um projeto em branco

Criar um projeto em branco ou vazio pode ser útil quando você quer criar seus arquivos LookML do zero.

A página Criar um modelo gera projetos com arquivos do LookML incluídos. No entanto, é possível minimizar os arquivos do LookML gerados preenchendo apenas as seguintes seções na página Criar um modelo:

  • Selecionar conexão de banco de dados
  • Selecionar tabelas
  • Insira o nome do modelo

Deixe as seções restantes sem conclusão.

Clique no botão Concluir e visualizar modelo, que leva você ao projeto no ambiente de desenvolvimento integrado do Looker. No ambiente de desenvolvimento integrado, você pode excluir os arquivos do LookML que não quiser para criar um projeto em branco.

Próximas etapas

Depois que um modelo ou projeto é criado, é possível realizar as seguintes ações: