Um projeto é uma coleção de arquivos LookML que descrevem como as tabelas de 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 de projetos e modelo de desenvolvimento do LookerML 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 usuários sobre como acessar e editar o LookML de um arquivo de modelo específico, crie um novo projeto. Embora a maioria das permissões no Looker seja aplicada 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, mas não a outro, crie um projeto separado que contenha o modelo a que você não quer que eles tenham acesso.
Como criar um projeto
Para criar um projeto, execute as seguintes etapas:
Selecione Projetos na seção Desenvolver do painel de navegação.
Na página Projetos do LookML, selecione Novo projeto do LookML para selecionar as opções do projeto.
Essa ação abre a página New Project, onde é possível especificar as configurações do seu projeto, incluindo o nome e o ponto de partida. O Looker pode criar um projeto de várias maneiras, e as etapas 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 com base no banco de dados
- Como clonar um repositório Git público
- Como criar um projeto em branco
Como gerar automaticamente um modelo do seu banco de dados
Se você selecionar Generate Model from Database Schema como ponto de partida, o gerador do LookML automaticamente vai criar o 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 solicita o nome da conexão para gerar automaticamente o LookML com base no 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 público do Git como o ponto de partida, o Looker vai copiar os arquivos de um repositório Git público para o novo projeto LookML.
Os projetos do Looker que são 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 de repositório clonados como ponto de partida e depois usar o parâmetro extends do Looker ou os refinamentos para criar um projeto a partir dele.
Para clonar um repositório Git público em um projeto do Looker:
- Verifique se você está no Modo de Desenvolvimento.
- Selecione Gerenciar projetos do LookML no menu Desenvolver.
Na página Projetos do LookML, selecione Novo projeto do LookML para abrir a página Novo projeto.
Na página New Project, especifique as opções do seu projeto:
- Nome do projeto: dê um nome ao projeto.
- Ponto de partida: escolha Clonar repositório Git público.
- Git Repository URL: 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 comohttps://github.com/llooker/blocks_redshift_admin, poderá editá-lo para o formato correto substituindo "https://" por "git://" e adicionando ".git" no final. O URL que você inseriria seriagit://github.com/llooker/blocks_redshift_admin.git.
Selecione Criar projeto. O Looker vai extrair todos os arquivos do repositório público para um novo projeto LookML e abrir o projeto no ambiente de desenvolvimento integrado do Looker.
Como criar um projeto em branco
Se você selecionar Blank Project como ponto de partida, o Looker vai criar um projeto vazio para que você possa criar seus arquivos do LookML do zero.
Para criar um projeto em branco:
- Verifique se você está no Modo de Desenvolvimento.
- Selecione Gerenciar projetos do LookML no menu Desenvolver.
Na página Projetos do LookML, selecione Novo projeto do LookML para abrir a página Novo projeto.
Na página New Project, especifique as opções do seu projeto:
- Nome do projeto: dê um nome ao projeto.
- Ponto de partida: escolha Projeto em branco.
Selecione Criar projeto. O Looker cria e abre o projeto no ambiente de desenvolvimento integrado do Looker.
Com um projeto em branco, é possível criar arquivos de model e visualização e depois conectar o projeto ao Git para registrar mudanças nos arquivos LookML e gerenciar versões deles.
Como configurar um modelo
Use o botão Configurar novo modelo na parte de cima da página Projetos do LookML para adicionar uma configuração a um modelo atual ou planejado.
Configurar um modelo para um projeto que ainda não existe é útil se os desenvolvedores não tiverem recebido as permissões 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 mais informações sobre projetos com apenas uma configuração, consulte a página de documentação Como acessar e editar informações do projeto.
Também é possível especificar quais conexões de banco de dados podem ser usadas pelo modelo ou que o modelo tem permissão para usar conexões atuais ou futuras. Os desenvolvedores do Looker usam o parâmetro connection do LookML para especificar no arquivo do modelo qual conexão ele precisa usar. Se um desenvolvedor especificar uma conexão que você não permitiu na configuração do modelo, as consultas nesse modelo não serão executadas.