Gerar um modelo do LookML

Esta página de documentação descreve as etapas para gerar automaticamente um modelo básico do LookML na conexão do banco de dados 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 o 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.

  • Você pode usar o método legado para criar projetos e gerar modelos clicando em uma das opções a seguir, que levam à página legada Novo projeto:

    • 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 Novo projeto, siga as etapas em Como 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 Desenvolver

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 do painel de navegação.

  3. Essa seleção abre a página Projetos do LookML. A página Projetos do LookML permite visualizar todos os projetos a que você tem acesso, além dos 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 no 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. Isso abre a página Criar um modelo.

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. Após cada seção, clique em Próxima para salvar a 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. Também é possível escolher a opção Criar nova conexão no menu suspenso. Isso leva à página Conectar seu banco de dados ao Looker , em que você pode 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. É possível 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 dos projetos diferenciam maiúsculas de minúsculas e só permitem caracteres alfanuméricos, _, ., e -. Escolha o nome do projeto com cuidado e considere-o um ID permanente para o projeto. Os novos projetos são configurados usando um repositório Git simples.

    • Marque a caixa de seleção Gerar um arquivo Readme com mais informações sobre o uso do 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 do LookML.

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

  2. Selecionar tabelas:

    • Se você estiver usando uma conexão do BigQuery, selecione o Google Cloud projeto em que o conjunto de dados reside no menu suspenso Selecionar projeto do GCP ou pesquise o projeto no campo Pesquisar nome do projeto. Por padrão, o Google Cloud projeto de armazenamento é mostrado no menu suspenso, se existir. Caso contrário, o Google Cloud projeto de faturamento será 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 de conjunto de dados ou esquema para abrir a guia Tabelas e selecione cada tabela que você quer incluir. As visualizações serão criadas nas tabelas.
    • Depois que as tabelas forem selecionadas, use a seta à direita de cada nome de tabela para abrir a guia Campos e selecione 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 são intituladas dwh_orders e DBS_users. Se você inserir dwh, DBS no campo Ignorar prefixos, o Looker vai criar arquivos de visualização chamados orders e users.
    • Importar descrições de campos: marque essa caixa de seleção para usar as descrições de campos disponíveis no banco de dados como descrições do LookML para 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. Selecionar Análises para criar:

    • Selecione a 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.
    • Esta 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. Inserir nome do modelo:

  6. Clique em um dos botões a seguir para gerar os arquivos de 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 explorar 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 novo projeto e quer conectá-lo a um repositório diferente do repositório Git simples que o Looker usou para a criação do projeto, clique no botão Redefinir conexão Git na guia Configuração da página Configurações do projeto para concluir esse processo.

Quando você precisa configurar modelos

Configurar um modelo é útil pelos seguintes motivos:

  • Especifica que um determinado nome de modelo se refere a um modelo específico em um projeto específico.
  • 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 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 uma configuração de modelo existir, todas as consultas serão restritas por essa configuração, 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 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 nesse modelo 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 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 (que está incluída no papel admin) ou a permissão manage_project_models, o modelo precisará ser configurado antes que esses desenvolvedores possam executar consultas nele. É possível configurar o modelo antes que ele ou o projeto exista. Em seguida, quando um desenvolvedor do LookML cria o modelo, as conexões permitidas do modelo já estão configuradas, e o desenvolvedor pode executar consultas com sucesso.

O Looker permite que 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

O botão Configurar novo modelo na parte de cima da página Projetos do LookML pode ser usado por administradores do Looker para adicionar uma configuração a um modelo atual ou a um modelo planejado que ainda não existe.

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

Os administradores também podem especificar quais conexões de banco de dados podem ser usadas pelo modelo ou especificar que o modelo pode usar conexões atuais ou futuras. 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 novo 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 do 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 concluindo apenas as seções a seguir na página Criar um modelo:

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

Deixe as seções restantes não concluídas.

Clique no botão Concluir e visualizar modelo, que leva você ao projeto no ambiente de desenvolvimento integrado do Looker. Depois de entrar 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, você pode realizar as seguintes ações: