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 saber como acessar e editar projetos, 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 a 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:
Selecione Projetos na seção Desenvolver do painel de navegação.
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, em que você pode especificar as configurações do projeto, incluindo o nome 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 no banco de dados
- Como clonar um repositório Git público
- Como criar um projeto em branco
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 solicita o nome da conexão para gerar automaticamente o LookML 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 a partir dele.
Para clonar um repositório Git público atual 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 para seu 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 com o parâmetro
project_id. - Para identificar o projeto no banco de dados interno da instância do Looker.
- Para identificar o projeto para a importação de projetos locais.
- 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 dos arquivos do projeto. Por exemplo, em uma instância do Looker com um URL de
example.looker.com, o arquivo de manifesto do projeto chamadoecommercepode ser encontrado neste URL:https://example.looker.com/projects/ecommerce/files/manifest.lkml.
- Para identificar o projeto de chamadas de API com o parâmetro
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. Confira se o URL está no formato
Se você tiver um URL comogit://github.com/example/my-repository.git.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 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 do LookML e abri-lo no ambiente de desenvolvimento integrado do Looker.
Como criar um projeto em branco
Se você selecionar Projeto em branco 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 para seu 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 com o parâmetro
project_id. - Para 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.
- Para mostrar o projeto na seção Develop do painel de navegação do Looker.
- Como parte do URL dos arquivos do projeto. Por exemplo, em uma instância do Looker com um URL
example.looker.com, o arquivo de manifesto do projeto chamadoecommercepode ser encontrado neste URL:https://example.looker.com/projects/ecommerce/files/manifest.lkml.
- Para identificar o projeto de chamadas de API com o parâmetro
Ponto de partida: escolha Projeto em branco.
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 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 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 do 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 que você não permitiu na configuração do modelo, nenhuma consulta nesse modelo será executada.