Como acessar e editar informações do projeto

A página Projetos do LookML fornece uma lista de todos os projetos do LookML na instância do Looker e mostra todos os modelos em cada projeto.

Para acessar a página Projetos do LookML, execute as seguintes etapas:

  1. Abra o painel Desenvolver selecionando a opção Desenvolver no painel de navegação.
  2. No painel Desenvolver, selecione Projetos.

Como visualizar projetos existentes e seus modelos

Para conferir uma lista de projetos atuais, navegue até a página Projetos do LookML.

No Modo de Produção, a página Projetos do 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 no Modo de Desenvolvimento. A página Projetos do LookML inclui as seguintes categorias básicas:

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 exibe os seguintes elementos para cada projeto:

  • Coluna Projeto: o nome do projeto. Cada projeto pode ter um ou mais modelos listados ao lado dele. Selecione o nome do projeto para navegar até o LookML desse projeto.
  • Coluna Modelos: o conjunto de arquivos de modelo do LookML para o projeto especificado. Caso seu ambiente do Modo de Desenvolvimento seja diferente da produção, essa lista pode ser alterada entre o Modo de Desenvolvimento e o Modo de Produção. Por exemplo, talvez você tenha criado um novo modelo no Modo de Desenvolvimento que ainda não foi enviado para produção.
  • Coluna de problemas de configuração: se houver um problema com um modelo, ele vai mostrar um status que indica o problema de configuração.
  • Botão Configurar: se o botão Configurar estiver disponível para um projeto, será possível adicionar ou editar a configuração do modelo para esse projeto.

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 quando alguém configurou um modelo nessa página, mas ainda não criou um arquivo do LookML correspondente para ele.
Configuração necessária para usar Esse problema aparece quando alguém criou um novo arquivo modelo do 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 de modelo não existe (por exemplo, se alguém tiver digitado incorretamente ou ainda não o tiver criado).
O modelo "x" não pode usar a conexão "y" O connection declarado no arquivo de modelo não é permitido de acordo com a configuração desta 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.

Visualizar a listagem de um projeto do Marketplace

A seção Projetos do Marketplace da página Projetos do LookML lista os projetos criados durante a instalação de um aplicativo, bloqueio ou plug-in do Marketplace. A listagem de cada projeto do Marketplace inclui os seguintes elementos:

  • Listagem: um link para a listagem do aplicativo, bloqueio ou plug-in no Marketplace do Looker.
  • Projeto: o nome do projeto. Clique no nome do projeto para acessar ou editar o LookML.
  • Botão Visualizar LookML ou Editar LookML: você pode navegar para um projeto do Marketplace selecionando o botão Visualizar LookML para o projeto principal somente leitura de um bloco do Marketplace, ou Editar LookML para seu projeto de configuração. Este último pode ser personalizado. Para mais informações sobre como personalizar bloqueios do Marketplace, consulte a página de documentação Personalizar blocos do Marketplace do Looker.
  • Modelos: o conjunto de arquivos de modelo do LookML para o projeto especificado.
  • Botão Configurar: se o botão Configurar estiver disponível ao lado da listagem do projeto, será possível adicionar ou editar a configuração do modelo do projeto.

Visualizar a listagem de um projeto pendente

A seção Projetos pendentes contém modelos 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 que ainda não têm LookML.

Configurar modelos antes da existência do projeto é útil quando você tem desenvolvedores que não receberam a permissão manage_models ou manage_project_models. Como o modelo já foi configurado, esses desenvolvedores podem executar consultas assim que criarem o projeto e esse 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 projetos que estão configurados, mas ainda não foram gerados. O nome do projeto neste campo é o nome pretendido para o projeto. Selecione o nome do projeto para exibir a página Novo projeto em que ele pode ser gerado. Você precisa estar no Modo de Desenvolvimento para acessar a página Novo projeto.
  • Coluna Modelos: o nome do modelo especificado durante a criação da configuração dele.
  • 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 alterar o nome do projeto e as conexões permitidas para este 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 o LookML automaticamente com base em um conjunto de tabelas no banco de dados.

Adicionar e editar configurações

Se o botão Configurar estiver disponível ao lado da listagem do projeto, será possível adicionar ou editar a configuração do modelo do projeto.

Se o modelo não tiver uma configuração, quando você clicar em Configurar, o Looker exibirá a janela Configurar um modelo. Na janela Configurar um modelo, especifique o nome do modelo e do projeto, além das 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 dele, mas não renomeá-lo. Os modelos são nomeados de acordo com os nomes de arquivo que você usa ao editar os arquivos de modelo no ambiente de desenvolvimento integrado do Looker.

No campo Projeto, especifique 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 para 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

Quando um administrador do Looker cria um projeto do LookML, ele dá o nome do projeto. O nome do projeto precisa ser considerado um ID permanente, porque o Looker usa esse nome das seguintes maneiras:

  • Para identificar o projeto de chamadas de API que têm project_id como parâmetro.
  • 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.

Se você tiver a permissão manage_models do Looker, poderá alterar o nome de um projeto do LookML usando a página Configurações do projeto do projeto. Os desenvolvedores do Looker que não são administradores podem visualizar a página Configurações do projeto, mas não podem alterar as opções dela.

Para renomear um projeto, siga estas etapas:

  1. Verifique se você ativou o Modo de Desenvolvimento.
  2. Acesse seu projeto no Looker IDE.
  3. No projeto, clique em Settings na barra de navegação do ambiente de desenvolvimento integrado para abrir o painel de configurações.
  4. Selecione Configuração no painel de configurações do projeto.
  5. Use o campo Name em Project Configuration para editar o nome do seu projeto.
  6. Na página Configuração do projeto, clique em Salvar configuração do projeto para salvar o novo nome do projeto.

Como excluir um projeto

Se você for um administrador do Looker, poderá excluir um projeto na página Configurações do projeto dele. Para ver 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 do projeto, o que remove completamente o projeto do seu ambiente de desenvolvimento:

  1. Acesse seu projeto no Looker IDE.
  2. No projeto, clique em Settings na barra de navegação do ambiente de desenvolvimento integrado para abrir o painel Project Settings.
  3. No painel de configurações do projeto, escolha Configuração para conferir as definições.
  4. Em Configuração do projeto, selecione Excluir projeto.
  5. Na janela Excluir projeto, verifique os avisos e as mudanças não sincronizadas que serão perdidas se o projeto for excluído.
  6. 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.
  7. Clique no botão Excluir permanentemente <nome do projeto>.