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 projetos nas páginas de documentação Projetos e modelo de desenvolvimento 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 se aplique no nível do modelo, algumas se aplicam ao 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 e não a outro, é uma boa ideia criar um projeto separado contendo o modelo ao qual você 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 necessárias dependem da opção Ponto de partida escolhida na página Novo projeto. As seções a seguir descrevem como esses pontos de partida funcionam:

Como 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 para seu projeto:

    • Nome do projeto: dê um nome ao projeto. Escolha o nome do projeto com cuidado e considere-o um ID permanente, já que o Looker usa esse nome 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.
      • 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.

    • Git Repository URL (URL do repositório Git): digite o URL do repositório Git público. Verifique 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://" por "git://" e adicionando ".git" ao 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 para seu projeto:

    • Nome do projeto: dê um nome ao projeto. Escolha o nome do projeto com cuidado e considere-o um ID permanente, já que o Looker usa esse nome 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.
      • 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 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.

Também é possível especificar quais conexões de banco de dados podem ser usadas pelo modelo ou se o modelo tem permissão para usar 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.