Como trabalhar com o navegador de arquivos do ambiente de desenvolvimento integrado

A maneira mais fácil de acessar o Looker IDE é pelo menu Desenvolver. Consulte Como acessar arquivos do projeto para ver detalhes e outras opções.

O Looker IDE oferece suporte a pastas para os arquivos do projeto. As pastas são mostradas no painel de navegação esquerdo do ambiente de desenvolvimento integrado. Se os desenvolvedores do Looker não organizarem os arquivos do projeto em pastas, o projeto terá uma estrutura de arquivos simples, com os arquivos listados em ordem alfabética no painel Navegador de arquivos.

Confira um exemplo de projeto em que um desenvolvedor adicionou pastas para diferentes tipos de arquivos de projeto, como "Análises", "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 esquerdo tem um menu que exibe as ações disponíveis para esse item. Selecione o menu de três pontos Ações da pasta (para pastas) ou Ações de arquivo (para arquivos) à direita do nome do arquivo para abrir o menu. Para um item com nome longo ou aninhado em várias pastas, você pode acessar o menu rolando pelo painel esquerdo.

Você pode criar pastas e arquivos, fazer upload de arquivos, além de 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, é necessário confirmar as mudanças e implantá-las na produção antes que outros desenvolvedores do Looker possam vê-las. Isso é como qualquer alteração que você fizer no projeto do LookML.

Pasta de projetos importados

Se você importar um projeto, o Looker IDE criará automaticamente uma pasta imported_projects. Os arquivos de projetos locais e projetos remotos são listados na pasta imported_projects. Selecione um arquivo de projeto importado na lista de arquivos em imported_projects para conferir o conteúdo dele.

Como eles não podem ser editados, os arquivos de projeto importados não ficam visíveis quando você edita arquivos em massa no ambiente de desenvolvimento integrado para mover ou excluir esses arquivos.

Organizar um projeto atual com pastas do ambiente de desenvolvimento integrado

Se seu projeto já tinha a estrutura de arquivos simples legada ou se você quer reorganizar os arquivos em uma pasta, é possível optar por manter essa estrutura. Porém, se optar por organizar os arquivos do projeto em pastas, recomendamos que você faça as seguintes preparações:

• Planeje a estrutura do arquivo 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 vão refletir a estrutura de arquivos que existia quando ele foi extraído da produção pela última vez. Se o projeto já tinha uma estrutura de arquivos simples, a versão do desenvolvedor do arquivo será enviada para produção no local original, e você terá duas cópias do arquivo. Além disso, se um desenvolvedor tiver cancelado alterações durante a migração para pastas, esse desenvolvedor enfrentará um conflito de mesclagem ao extrair da produção após a migração.
• Implementar um congelamento temporário de código com todos os desenvolvedores até que o projeto tenha sido totalmente migrado para a nova estrutura de diretórios.
• Atribua um único desenvolvedor para mover os arquivos. O procedimento a seguir pressupõe que um único desenvolvedor 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 você encontrar conflitos de mesclagem, consulte a página de documentação Como usar o controle de versões e a implantação para saber como resolvê-los.

Observação: ao mover um arquivo no Git, você o exclui e cria um novo com um novo caminho. Isso significa que o histórico do Git do arquivo estará vazio, porque o Git o considerará um novo arquivo. Para ver o histórico do Git do arquivo antes de ele ser movido, use sua interface do Git para navegar até o arquivo no local original e ver o histórico dele.

Depois que todos os desenvolvedores enviarem e confirmarem as alterações e pausarem todo o trabalho no projeto, você poderá migrá-lo para a nova estrutura de diretórios.

Atribua um único desenvolvedor para seguir estas etapas:

1. Verifique se todas as atualizações em todas as ramificações 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.
2. Verifique se todos os outros desenvolvedores pararam de fazer alterações no projeto.
3. Extrair da produção.
4. Crie as pastas do projeto.
5. Mova os arquivos do projeto para as pastas um arquivo por vez ou usando a edição em massa.
6. Validar o LookML do projeto. É esperado que você tenha vários erros e avisos do LookML, já que as instruções include e map_layer usam referências a locais de arquivos que provavelmente foram movidos durante esse procedimento.

7. Atualize as instruções include e map_layer no seu projeto para corresponder ao novo caminho do arquivo. Além disso, você pode encontrar erros de validação do LookML para objetos referenciados que não podem mais ser encontrados porque seus caminhos de arquivo foram alterados. Para mais informações, consulte a documentação sobre como usar include com pastas do ambiente de desenvolvimento integrado e sobre como usar map_layer com pastas do ambiente de desenvolvimento integrado.

   Dica:use caracteres curinga para criar uma correção temporária para avisos e erros de validação do LookML resultantes de instruções include. Usando a visualização de arquivos como exemplo, é possível especificar include: "/**/*.view" para incluir todos os arquivos em todas as pastas do projeto. Isso vai evitar problemas de validação do LookML enquanto você continua o desenvolvimento. No entanto, essa não é uma solução recomendada a longo prazo, já que incluir mais arquivos do que o necessário pode afetar o desempenho.

8. Confirme as alterações.

9. Implantar as atualizações na produção.

10. Informe aos outros desenvolvedores do Looker que agora eles podem extrair as atualizações da produção e retomar o desenvolvimento no projeto.