A página Projetos do LookML (link em inglês) contém uma lista de todos os projetos na instância do Looker e mostra todos os modelos em cada projeto.
Para acessar a página Projetos do LookML, siga estas 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 de projetos atuais, acesse a página Projetos do 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 extraídos da produção ou gerados por você 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 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 seção 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 do Looker ainda não geraram o projeto e a modelagem. Se você tiver a permissão
develop, poderá ver esses projetos. - Seção Projetos do Marketplace: os projetos listados na seção Projetos do Marketplace foram criados quando um aplicativo, bloco ou plug-in foi instalado usando o Marketplace do Looker.
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 Projeto: 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 Modelos: o conjunto de arquivos de modelo do LookML do projeto especificado. 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, ele vai mostrar um status que indica a questão da configuração.
- Botão Configurar: se o botão Configurar estiver disponível em um projeto, será possível adicionar ou editar a configuração do modelo dele.
Se houver um problema com um modelo, ele vai 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 se alguém criou um novo arquivo de modelo LookML em um projeto atual, mas ainda não o configurou nesta página. |
| A conexão "x" não existe | O connection declarado no arquivo 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 sua instância do Looker, mesmo que estejam em projetos diferentes. |
Como visualizar a ficha de um projeto do Marketplace
A seção Projetos do Marketplace da página Projetos do LookML (em inglês) lista 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 listagem do aplicativo, bloco ou plug-in no Marketplace do Looker.
- Projeto: o nome do projeto. Você pode clicar no nome do projeto para visualizar ou editar o LookML dele.
- Botão Visualizar LookML ou Editar LookML: para navegar até um projeto do Marketplace, selecione o botão Visualizar LookML para o projeto principal somente leitura de um bloco do Marketplace, ou Editar LookML para o 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 Como personalizar blocos do Marketplace do Looker.
- Modelos: o conjunto de arquivos de modelo do LookML do projeto especificado.
- Botão Configurar: se o botão Configurar estiver disponível ao lado da página de detalhes do projeto, será possível adicionar ou editar 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. Assim, a seção Projetos pendentes contém projetos e modelos que estão configurados apenas e ainda não têm um LookML.
Configurar modelos antes que o projeto exista é útil se você tiver desenvolvedores que não receberam a permissão manage_models ou manage_project_models. Como o modelo já foi configurado, os desenvolvedores podem executar consultas assim que criam o projeto e o modelo. Quando o projeto é gerado, a listagem dele é movida para a seção superior da página Projetos do 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 gerados. O nome do projeto neste campo é o nome pretendido do projeto. Selecione o nome do projeto para exibir a página Novo projeto, em que você pode gerá-lo. 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 quando a configuração 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 Adicionar LookML: o botão Adicionar LookML abre a página Novo projeto do projeto, permitindo que você use o gerador do LookML para gerar automaticamente LookML com base em um conjunto de tabelas do seu banco de dados.
Como adicionar e editar configurações
Se o botão Configurar estiver disponível ao lado da página de detalhes do projeto, será possível adicionar ou editar a configuração do modelo dele.
Se o modelo não tiver uma configuração, quando você clicar em Configurar, o Looker vai mostrar a janela Configurar um modelo. Na janela Configurar um modelo, especifique o nome do modelo, o nome do projeto e as conexões disponíveis para o modelo.
A lista de conexões inclui apenas aquelas que podem ser usadas com o projeto do modelo. As conexões configuradas para uso em todos os projetos têm o rótulo (Instance wide).
Se o modelo tiver uma configuração, quando você clicar em 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 disponíveis para o modelo.
Ao editar a configuração de um modelo, é possível visualizar 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 ser 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ê é administrador do Looker, é possível mudar o nome do projeto na página Configurações do projeto. Para conferir a página Configurações do projeto, abra seu projeto e clique em Configurações na barra de navegação do ambiente de desenvolvimento integrado.
Para renomear um projeto, siga estas etapas:
- Verifique se o Modo de desenvolvimento está ativado.
- Acesse seu projeto no ambiente de desenvolvimento integrado do Looker.
- No projeto, clique em Settings na barra de navegação do ambiente de desenvolvimento integrado para abrir o painel de configurações.
- Selecione Configuração no painel de configurações do projeto.
- Use o campo Nome em Configuração do projeto para editar o nome.
- Na página Configuração do projeto, clique em Salvar configuração do projeto para salvar o novo nome.
Como excluir um projeto
Se você é administrador do Looker, pode excluir um projeto na página Configurações do projeto. Para conferir a página Configurações do projeto, abra seu projeto e clique em Configurações na barra de navegação do ambiente de desenvolvimento integrado.
Um projeto excluído não aparece mais na seção Projetos da página Projetos do LookML, mas ainda aparece na seção Projetos configurados.
Para remover a configuração, o que remove o projeto do ambiente de desenvolvimento completamente:
- Acesse seu projeto no ambiente de desenvolvimento integrado do Looker.
- No projeto, clique em Settings na barra de navegação do ambiente de desenvolvimento integrado para abrir o painel Project Settings.
- No painel de configurações do projeto, escolha Configuração para conferir.
- Em Configuração do projeto, selecione Excluir projeto.
- Na janela Delete Project, verifique os avisos e as alterações não sincronizadas que serão perdidas se o projeto for excluído.
- Se você tiver certeza de que o projeto deve ser excluído, digite o nome dele no campo. 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>.