A página Projetos LookML apresenta uma lista de todos os projetos LookML na instância do Looker e mostra todos os modelos em cada projeto.
Para acessar a página Projetos LookML, execute as seguintes etapas:
- Abra o painel Desenvolver selecionando a opção Desenvolver no painel de navegação.
- No painel Desenvolver, selecione Projetos.
Como visualizar projetos existentes e os modelos deles
Para conferir uma lista dos projetos, acesse a página Projetos LookML.
No Modo de Produção, a página Projetos LookML lista os projetos que foram gerados e enviados para produção. No Modo de Desenvolvimento, a página lista os projetos que você extraiu da produção ou que gerou no Modo de Desenvolvimento. A página Projetos do LookML inclui as seguintes categorias básicas:
- Seção superior: os projetos listados na seção superior foram criados e podem incluir arquivos gerados de modelo e de visualização. Se você for um administrador do Looker ou tiver a permissão
developpara pelo menos um modelo em um projeto, o projeto vai aparecer no painel Desenvolver e na parte de cima da página. - Seção Projetos pendentes: os projetos listados na seção Projetos pendentes são aqueles em que o administrador do Looker configurou as conexões permitidas para um modelo, mas os desenvolvedores ainda não geraram o projeto e a modelagem. Se você tiver a permissão
develop, vai encontrar esses projetos. - Seção Projetos do Marketplace: os projetos listados na seção Projetos do Marketplace foram criados quando um aplicativo, um bloco ou um plug-in foi instalado usando o Looker Marketplace.
Para informações sobre como especificar um novo projeto ou um novo modelo para um projeto atual, consulte a página de documentação Como criar um novo projeto do LookML.
Como visualizar a listagem de um projeto
A página Projetos do LookML mostra os seguintes elementos de cada projeto:
- Coluna Project: o nome do projeto. Cada projeto pode ter um ou mais modelos listados ao lado. Selecione o nome do projeto para navegar até o LookML dele.
- Coluna Models: o conjunto de arquivos de modelo do LookML do projeto em questão. Se o ambiente do Modo de Desenvolvimento for diferente da produção, essa lista poderá alternar entre o Modo de Desenvolvimento e o Modo de Produção. Por exemplo, você pode ter criado um novo modelo no Modo de Desenvolvimento que ainda não enviou para produção.
- Coluna Problemas de configuração: se houver um problema com um modelo, o modelo vai mostrar um status que indica esse problema.
- Botão Configurar: se o botão Configurar estiver disponível ao lado da listagem do projeto, é possível adicionar ou editar a configuração do modelo do projeto.
Se houver um problema com um modelo, o modelo mostrará um status que indica o problema com a configuração.
| Problema | Explicação |
|---|---|
| O arquivo modelo do LookML ainda não existe | Esse problema ocorre se alguém configurou um modelo nesta página, mas ainda não criou um arquivo LookML correspondente para ele. |
| Configuração necessária para usar | Esse problema ocorre quando alguém cria um novo arquivo de modelo do LookML em um projeto, mas ainda não o configurou nesta página. |
| A conexão "x" não existe | O connection declarado no arquivo de modelo não existe (por exemplo, se alguém digitou errado ou ainda não o criou). |
| O modelo "x" não tem permissão para usar a conexão "y" | O connection declarado no arquivo de modelo não é permitido de acordo com a configuração nesta página. |
| Um modelo chamado "x" já está configurado no projeto "y" | Os nomes dos modelos precisam ser exclusivos na instância do Looker, mesmo que estejam em projetos diferentes. |
Como visualizar a página de detalhes de um projeto do Marketplace
A seção Projetos do Marketplace da página Projetos LookML mostra os projetos criados durante a instalação de um aplicativo, bloco ou plug-in do Marketplace. A listagem de cada projeto do Marketplace inclui os seguintes elementos:
- Listagem: um link para a ficha da empresa, bloco ou plug-in no Marketplace do Looker.
- Projeto: o nome do projeto. É possível clicar no nome do projeto para visualizar ou editar o LookML.
- Botão Visualizar LookML ou Editar LookML: é possível navegar até um projeto do Marketplace selecionando o botão Visualizar LookML do projeto principal somente leitura de um bloco do Marketplace ou Editar LookML do projeto de configuração, que pode ser personalizado. Para mais informações sobre como personalizar blocos do Marketplace, consulte a página de documentação Personalizar blocos do Marketplace do Looker.
- Modelos: o conjunto de arquivos de modelo do LookML do projeto em questão.
- Botão Configurar: se o botão Configurar estiver disponível ao lado da página de detalhes do projeto, adicione ou edite a configuração do modelo.
Como visualizar a listagem de um projeto pendente
A seção Projetos pendentes contém modelos que são configurados com um nome de projeto, mas que ainda não foram gerados. Portanto, a seção Pending Projects contém projetos e modelos que estão configurados apenas e que ainda não têm um LookML.
Configurar modelos antes que o projeto exista é útil se você tiver desenvolvedores que não receberam as permissões manage_models ou manage_project_models. Como o modelo já foi configurado, esses desenvolvedores podem executar consultas assim que criarem o projeto e o modelo. Quando o projeto é gerado, a listagem dele passa para a seção superior da página Projetos LookML.
A seção Projetos pendentes inclui os seguintes elementos:
- Coluna Projeto: esta seção lista os projetos que estão configurados, mas ainda não foram gerados. O nome do projeto neste campo é o nome pretendido. Selecione o nome do projeto para exibir a página Novo projeto, onde ele pode ser gerado. Você precisa estar no Modo de Desenvolvimento para acessar a página Novo projeto.
- Coluna Modelos: o nome do modelo que foi especificado ao criar a configuração do modelo.
- Coluna Conexões permitidas: a coluna à direita do nome do modelo mostra as conexões que foram permitidas para esse modelo quando a configuração dele foi criada.
- Botão Configurar: o botão Configuração permite mudar o nome do projeto e as conexões permitidas para esse modelo.
- Botão Add LookML: o botão Add LookML abre a página New Project do projeto, permitindo que você use o gerador do LookML para gerar automaticamente LookML baseado em um conjunto de tabelas do banco de dados.
Como adicionar e editar configurações
Se o botão Configurar estiver disponível ao lado da listagem do projeto, você poderá adicionar ou editar a configuração do modelo dele.
Se o modelo não tiver uma configuração, quando você selecionar Configurar, o Looker vai mostrar a janela Configurar um modelo. Na janela Configure a Model, especifique os nomes do modelo e do projeto, além das conexões disponíveis para o modelo.
A lista de conexões inclui apenas as conexões com um escopo de conexão que inclui o projeto do modelo. Se o Escopo da conexão estiver definido como Todos os projetos, o Looker vai mostrar o (Instance wide) ao lado dessa conexão.
Se o modelo tiver uma configuração, quando você selecionar Configurar, o Looker vai mostrar a janela Editar configuração do modelo. Na janela Editar configuração do modelo, é possível alterar as conexões que estão disponíveis para o modelo.
Ao editar a configuração de um modelo, é possível ver o nome do modelo, mas não renomeá-lo. Os modelos são nomeados de acordo com os nomes de arquivo usados ao editar os arquivos de modelo no ambiente de desenvolvimento integrado do Looker.
No campo Projeto, é possível especificar que o modelo deve estar associado a um projeto diferente. Por exemplo, se você criou um novo projeto que inclui um modelo com o mesmo nome, é possível fazer a transição da configuração do modelo a ser associada ao modelo do novo projeto.
No campo Conexões permitidas, é possível limitar o modelo para usar uma lista de conexões específicas ou permitir que o modelo use qualquer conexão (todas as conexões atuais e futuras).
Renomear um projeto
Se você é um administrador do Looker, pode mudar o nome do projeto na página Configurações do projeto. Para ver a página Configurações do projeto, abra seu projeto e selecione o ícone Configurações no menu à esquerda.
Para renomear um projeto, execute as seguintes etapas:
- Verifique se o modo de desenvolvimento está ativado.
- Navegue até seu projeto no ambiente de desenvolvimento integrado do Looker.
- No projeto, selecione o ícone de configurações na barra de navegação do ambiente de desenvolvimento integrado para abrir o painel.
- Selecione Configuração no painel de configurações do projeto.
- Use o campo Nome em Configuração do projeto para editar o nome dele.
- Role para baixo na página Project Configuration e clique em Save Project Configuration para salvar o novo nome.
Como excluir um projeto
Se você é administrador do Looker, exclua um projeto na página Configurações do projeto. Para ver a página Configurações do projeto, abra seu projeto e selecione o ícone Configurações no menu à esquerda.
Um projeto excluído não aparece mais na seção Projetos da página Projetos LookML, mas ainda aparece na seção Projetos configurados.
Para remover a configuração do projeto, o que remove completamente o projeto do ambiente de desenvolvimento:
- Navegue até seu projeto no ambiente de desenvolvimento integrado do Looker.
- No seu projeto, selecione o ícone de configurações na barra de navegação do ambiente de desenvolvimento integrado para abrir o painel Configurações do projeto.
- No painel de configurações do projeto, escolha Configuração.
- Em Configuração do projeto, selecione Excluir projeto.
- Na janela Delete Project, verifique os avisos e as mudanças não sincronizadas que serão perdidas se o projeto for excluído.
- Se você tem certeza de que o projeto precisa ser excluído, digite o nome dele na caixa de texto. Para cancelar a operação e voltar ao projeto, use o botão Voltar do navegador.
- Clique no botão Excluir permanentemente <nome do projeto>.