A maneira mais fácil de acessar o ambiente de desenvolvimento integrado do Looker é pelo menu Desenvolver. Consulte Como acessar arquivos do projeto para ver mais detalhes e outras opções.
O ambiente de desenvolvimento integrado do Looker é compatível com pastas para os arquivos do projeto. As pastas são mostradas no painel de navegação à esquerda do ambiente de desenvolvimento integrado. Caso os desenvolvedores do Looker não tenham organizado os arquivos do projeto em pastas, o projeto vai ter uma estrutura simples, com os arquivos listados em ordem alfabética no painel File Browser.
Confira um exemplo de projeto em que um desenvolvedor adicionou pastas para diferentes tipos de arquivos de projeto, como Explores, modelos e visualizações:
Selecione os ícones na barra de ferramentas na parte de cima do painel Navegador de arquivos para recolher todas as pastas, mover e excluir arquivos e pastas, pesquisar um arquivo de projeto ou criar novas pastas e novos arquivos.
Recolher a barra lateral do ambiente de desenvolvimento integrado
É possível mostrar ou ocultar o navegador de arquivos do ambiente de desenvolvimento integrado usando o atalho de teclado Command-B (Mac) ou Ctrl+B (Windows) ou selecionando o ícone do navegador de arquivos:
Como gerenciar arquivos e pastas
Cada arquivo ou pasta no painel lateral tem um menu que mostra as ações disponíveis para o item. Selecione o menu de três pontos Ações de pasta (para pastas) ou Ações de arquivo (para arquivos) à direita do nome do arquivo para abrir o menu. Para um item que tem um nome longo ou que está aninhado em várias pastas, você pode acessar o menu rolando no painel esquerdo.
Você pode criar pastas e arquivos, fazer upload de arquivos e excluir e mover arquivos e pastas usando o navegador de arquivos. Para mais informações, consulte a página de documentação Como gerenciar arquivos e pastas do LookML.
Ao organizar os arquivos do LookML com pastas, você precisa confirmar as alterações e implantá-las na produção antes que elas possam ser vistas por outros desenvolvedores do Looker. Isso é como qualquer alteração feita no projeto do LookML.
Pasta de projetos importados
Se você importar um projeto, o ambiente de desenvolvimento integrado do Looker vai criar uma pasta imported_projects automaticamente. Arquivos de projetos locais e projetos remotos são listados na pasta imported_projects. Selecione um arquivo de projeto importado na lista de arquivos no imported_projects para conferir o conteúdo desse arquivo.
Como eles não podem ser editados, os arquivos de projetos importados não ficam visíveis quando você está editando arquivos em massa no ambiente de desenvolvimento integrado para mover ou excluir esses arquivos.
Como organizar um projeto atual com pastas do ambiente de desenvolvimento integrado
Caso seu projeto já tenha a estrutura de arquivos simples legada ou você queira reorganizar os arquivos em uma pasta, é possível manter essa estrutura. No entanto, se você optar por organizar os arquivos do projeto em pastas, recomendamos que faça as seguintes preparações:
- Planeje a estrutura de arquivos com antecedência com todos os desenvolvedores.
- Verifique se todos os desenvolvedores do Looker implantaram todas as atualizações na produção. Se um desenvolvedor tiver alterações não implantadas, as ramificações dele refletirão a estrutura de arquivos que existia quando foi extraída da produção pela última vez. Se o projeto tinha uma estrutura de arquivos simples naquele momento, a versão do desenvolvedor do arquivo será enviada para produção no local original, e você vai ter duas cópias do arquivo. Além disso, se um desenvolvedor tiver mudanças não implantadas durante a migração para as pastas, ele vai encontrar um conflito de mesclagem ao extrair da produção após a migração.
- Ative um congelamento temporário de código com todos os seus desenvolvedores até que o projeto seja totalmente migrado para a nova estrutura de diretórios.
- Atribua um único desenvolvedor para mover os arquivos. O procedimento abaixo pressupõe que um único desenvolvedor vai migrar o projeto para as pastas do ambiente de desenvolvimento integrado. Se você precisar que vários desenvolvedores movam arquivos, divida a tarefa entre os desenvolvedores para evitar conflitos de mesclagem. Se houver conflitos de mesclagem, consulte a página de documentação Como usar o controle de versões e a implantação para mais informações sobre como resolvê-los.
Depois que todos os desenvolvedores tiverem enviado e confirmado as alterações e pausado todo o trabalho no projeto, será possível migrar o projeto para a nova estrutura de diretórios.
Atribua um único desenvolvedor para realizar todas as etapas a seguir:
- Verifique se todas as atualizações em todos os branches de desenvolvimento foram implantadas na produção. Isso inclui as ramificações de desenvolvimento do desenvolvedor que realizam a migração para as pastas do ambiente de desenvolvimento integrado.
- Verifique se todos os outros desenvolvedores pararam de fazer alterações no projeto.
- Extrair da produção.
- Crie as pastas do projeto.
- Mova os arquivos do projeto para as pastas, seja um arquivo por vez ou usando a edição em massa.
- Valide o LookML do projeto. Espera-se que você tenha vários erros e avisos do LookML, já que as instruções
includeemap_layerusam referências a locais de arquivos que provavelmente foram movidos durante este procedimento. Atualize as instruções
includeemap_layerno projeto para corresponder ao novo caminho do arquivo. Além disso, você pode ter erros de validação do LookML para objetos referenciados que não podem mais ser encontrados porque os caminhos dos arquivos foram alterados. Para mais informações, consulte a documentação sobre como usarincludecom pastas do ambiente de desenvolvimento integrado e como usarmap_layercom pastas do ambiente de desenvolvimento integrado.Informe aos outros desenvolvedores do Looker que agora eles podem receber as atualizações da produção e retomar o desenvolvimento no projeto.