Como criar um novo projeto do LookML

Um projeto é uma coleção de arquivos do LookML que descrevem como as tabelas do banco de dados estão relacionadas entre si e como o Looker deve interpretá-las. Saiba mais sobre os projetos nas páginas de documentação Modelo de desenvolvimento e projetos do LookML e Termos e conceitos do LookML. Para mais informações sobre como acessar e editar projetos existentes, consulte a página de documentação Como acessar e editar informações do projeto.

Um projeto do LookML pode conter mais de um arquivo de modelo. No entanto, se você quiser especificar permissões para os usuários quanto à visualização e edição do LookML para um arquivo de modelo específico, convém criar um novo projeto. Embora a maioria das permissões no Looker seja aplicada no nível do modelo, algumas são aplicadas no nível do projeto, incluindo see_lookml, que permite visualizar o LookML de um projeto, e develop, que permite editar o LookML. Se você quiser dar aos usuários acesso a um modelo, mas não a outro, é recomendável criar um projeto separado com o modelo que não quer que eles tenham acesso.

Os usuários do Looker com a permissão manage_models podem criar modelos do LookML em uma instância do Looker.

Como criar um projeto

Para criar um projeto, siga estas etapas:

  1. Verifique se você está no Modo de Desenvolvimento.

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

  3. Na página Projetos do LookML, selecione Novo projeto do LookML para escolher as opções do projeto.

Essa ação abre a página New Project, na qual é possível especificar as configurações do seu projeto, incluindo o nome dele e o ponto de partida.

O Looker pode criar um projeto de várias maneiras, e as etapas dependem da opção Starting Point escolhida na página New Project. As seções a seguir descrevem como esses pontos de partida funcionam:

Gerar automaticamente um modelo do seu banco de dados

Se você selecionar Gerar modelo do esquema de banco de dados como ponto de partida, o gerador do LookML criará automaticamente seu modelo e visualizará os arquivos do projeto com base nas tabelas do banco de dados. Consulte a página de documentação Como gerar um modelo para mais informações.

Com essa opção, o Looker pede o nome da conexão para gerar o LookML automaticamente com base no seu banco de dados. No entanto, você ainda poderá adicionar outras conexões depois.

Como clonar um repositório Git público

Se você selecionar Clonar repositório Git público como ponto de partida, o Looker vai copiar os arquivos de um repositório Git público para o novo projeto do LookML.

Os projetos do Looker clonados de repositórios Git públicos são somente leitura. No entanto, é possível importar o projeto somente leitura para outro projeto do Looker e editar os arquivos. Além disso, é possível usar os arquivos do repositório clonado como ponto de partida e, em seguida, usar o parâmetro extends ou os refinamentos do Looker para criar um projeto.

Para clonar um repositório Git público atual em um projeto do Looker:

  1. Verifique se você está no Modo de Desenvolvimento.
  2. Selecione Gerenciar projetos do LookML no menu Desenvolver.

  3. Na página Projetos do LookML, selecione Novo projeto do LookML para abrir a página Novo projeto.

  4. Na página New Project, especifique as opções do 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.
      • 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 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 Clonar repositório Git público.

    • URL do repositório Git: insira o URL do repositório Git público. Confira se o URL está no formato git://github.com/example/my-repository.git.

      Se você tiver um URL como https://github.com/llooker/blocks_redshift_admin, poderá editá-lo para o formato correto substituindo "https://" com "git://" e, em seguida, adicionar ".git" no final. O URL que você inseriria seria git://github.com/llooker/blocks_redshift_admin.git.

  5. Selecione Criar projeto. O Looker vai extrair todos os arquivos do repositório público para um novo projeto do LookML e abri-lo no ambiente de desenvolvimento integrado do Looker.

Como criar um projeto em branco

Se você selecionar Blank Project, o Looker vai criar um projeto vazio para que você possa criar seus arquivos do LookML do zero.

Para criar um projeto em branco:

  1. Verifique se você está no Modo de Desenvolvimento.
  2. Selecione Gerenciar projetos do LookML no menu Desenvolver.

  3. Na página Projetos do LookML, selecione Novo projeto do LookML para abrir a página Novo projeto.

  4. Na página New Project, especifique as opções do 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.
      • 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 exibir o projeto na página Projetos do LookML.
      • Para mostrar o projeto na seção Develop 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 Projeto em branco.

  5. Selecione Criar projeto. Ele cria e abre o projeto no ambiente de desenvolvimento integrado do Looker (em inglês).

Quando você tiver um projeto em branco, crie os arquivos model e view e conecte seu projeto ao Git para gravar alterações nos arquivos do LookML e gerenciar versões deles.

Como configurar um modelo

Use o botão Configurar novo modelo na parte superior da página Projetos do LookML para adicionar uma configuração de um modelo existente ou planejado.

Configurar um modelo para um projeto que ainda não existe será útil se os desenvolvedores não tiverem recebido a permissão manage_models ou manage_project_models, conforme descrito na página de documentação Como gerar um modelo. Se você configurar o modelo para os desenvolvedores, eles poderão executar consultas assim que gerarem ou criarem o arquivo de modelo. Para saber mais sobre projetos com apenas uma configuração, consulte a página de documentação Como acessar e editar informações de projetos.

Você também pode 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 não permitida na configuração do modelo, nenhuma consulta nele será executada.