Como trabalhar com o navegador de arquivos do ambiente de desenvolvimento integrado
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Você pode acessar o Looker IDE pelo menu Develop do Looker. Consulte Como acessar arquivos de projeto para saber mais e conferir outras opções.
O ambiente de desenvolvimento integrado do Looker oferece suporte a pastas para arquivos de projeto. As pastas são mostradas no painel de navegação à esquerda do ambiente de desenvolvimento integrado.
Se o projeto do Looker não estiver organizado em pastas, ele terá uma estrutura de arquivos simples, com arquivos listados em ordem alfabética no painel File Browser. Consulte Organizar um projeto com pastas do ambiente de desenvolvimento integrado para saber como atualizar seu projeto para usar pastas do ambiente de desenvolvimento integrado.
O ambiente de desenvolvimento integrado do Looker mantém o arquivo aberto e o status aberto ou fechado do painel File Browser. É possível redefinir a persistência nas configurações do ambiente de desenvolvimento integrado.
Se você importar um projeto, o ambiente de desenvolvimento integrado do Looker vai 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 no imported_projects para conferir o conteúdo dele.
Como 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.
Como organizar um projeto com pastas do ambiente de desenvolvimento integrado
Se o projeto já tinha a estrutura de arquivo simples legada ou se você quiser 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 fazer o seguinte:
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 mudanças não implantadas, as ramificações vão refletir a estrutura de arquivos que existia na última vez que elas foram extraidas da produção. Se o projeto tiver uma estrutura de arquivo 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 desfeito a implantação de mudanças durante a migração para pastas, ele vai enfrentar um conflito de mesclagem ao extrair da produção após a migração.
Ative um congelamento temporário do código com todos os 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 a seguir pressupõe que um único desenvolvedor vai migrar o projeto para pastas do ambiente de desenvolvimento integrado. Se você precisar que vários desenvolvedores movam arquivos, divida a tarefa entre eles para evitar conflitos de mesclagem. Se você encontrar conflitos de mesclagem, consulte a página de documentação Usar o controle de versão e a implantação para saber como resolvê-los.
Depois que todos os desenvolvedores enviarem e confirmarem as mudanças e pausarem todo o trabalho no projeto, você poderá migrar o projeto para a nova estrutura de diretórios.
Atribua a um único desenvolvedor a realização das seguintes etapas:
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 está realizando a migração para pastas do ambiente de desenvolvimento integrado.
Verifique se todos os outros desenvolvedores pararam de fazer mudanças no projeto.
Valide 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 arquivo que provavelmente foram movidos durante essa etapa.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-25 UTC."],[],[],null,["# Working with the IDE file browser\n\nYou can access the Looker IDE through the Looker **Develop** menu. See [Accessing project files](/looker/docs/accessing-project-files) for details and other options.\n\nThe Looker IDE supports folders for your project files. Folders are shown in the left navigation pane of the IDE.\n\nIf your Looker project isn't organized into folders, your project will have a flat file structure, with files listed alphabetically in the **File Browser** panel. See [Organizing an existing project with IDE folders](#organizing_an_existing_project_with_ide_folders) for information on updating your project to use IDE folders.\n\nThe Looker IDE persists your currently open file and the expanded or collapsed status of the **File Browser** panel. You can reset the persistence in the [**IDE Settings**](/looker/docs/looker-ide#reset-layout).\n\nYou can select the icons in the toolbar at the top of the **File Browser** panel to collapse all folders, [move](/looker/docs/creating-project-files#moving_files_and_folders_in_bulk) and [delete](/looker/docs/creating-project-files#deleting_files_and_folders_in_bulk) files and folders, [search for a project file](/looker/docs/accessing-project-files#searching_for_and_jumping_to_lookml_objects_or_project_files), or create [new folders](/looker/docs/creating-project-files#creating_folders) and [new files](/looker/docs/creating-project-files#creating_files).\n\nImported projects folder\n------------------------\n\nIf you [import a project](/looker/docs/importing-projects), the Looker IDE automatically creates an `imported_projects` folder. Files from both [local projects](/looker/docs/importing-projects#specifying_local_projects) and [remote projects](/looker/docs/importing-projects#specifying_remote_projects) are listed in the `imported_projects` folder. Select an imported project file from the list of files in the `imported_projects` to view that file's contents.\n\nBecause they cannot be edited, imported project files are not visible when you are bulk-editing files in the IDE to [move](/looker/docs/creating-project-files#moving_files_and_folders_in_bulk) or [delete](/looker/docs/creating-project-files#moving_files_and_folders_in_bulk) those files.\n\n\nOrganizing an existing project with IDE folders\n-----------------------------------------------\n\nIf your project previously had the legacy flat file structure or if you want to reorganize the files in a folder, you can choose to keep this structure; but if you choose to organize your project files into folders, we strongly recommend that you make the following preparations:\n\n- Plan the file structure ahead of time with all developers.\n- Ensure that all your Looker developers have [deployed all their updates to production](/looker/docs/version-control-and-deploying-changes#deploying_to_production). If a developer has undeployed changes, their branch(es) will reflect the file structure that existed when they last [pulled from production](/looker/docs/git-command-reference#pull_prod). If the project had a flat file structure at that time, the developer's version of the file will be pushed to production in its original location, so you will end up with two copies of the file. In addition, if a developer has undeployed changes during the migration to folders, that developer will face a merge conflict when they pull from production after the migration.\n- Enact a temporary code freeze with all your developers until the project has been fully migrated to the new directory structure.\n- Assign a single developer to move the files. The following procedure assumes a single developer will be migrating the project to IDE folders. If you need to have multiple developers move files, divide the task among the developers to avoid merge conflicts. If you do encounter merge conflicts, see the [Using version control and deploying](/looker/docs/version-control-and-deploying-changes#resolving_merge_conflicts) documentation page for information on resolving them.\n\n| **Note:** Be aware that when you move a file in Git, you are effectively deleting the file and creating a new file with a new path. This means that the Git history for the file will be empty, because Git will consider it a new file. To see the file's Git history before it was moved, use your Git interface to navigate to the file in its original location and view the Git history from there.\n\nOnce all your developers have pushed and committed their changes and paused all work on the project, you can then migrate the project to its new directory structure.\n\nAssign a single developer to do all the following steps:\n\n1. Verify that all updates on all development branches have been [deployed to production](/looker/docs/version-control-and-deploying-changes#deploying_to_production). This includes the development branches of the developer performing the migration to IDE folders.\n2. Verify that all other developers have stopped making changes to the project.\n3. [Pull from production](/looker/docs/git-command-reference#pull_prod).\n4. [Create the project's folders](/looker/docs/creating-project-files#creating_folders).\n5. Move the project files into the folders, either [one file at a time](/looker/docs/creating-project-files#moving_items_in_a_foldered_project) or [using bulk edit](/looker/docs/creating-project-files#moving_files_and_folders_in_bulk).\n6. [Validate the project's LookML](/looker/docs/lookml-validation#validating_your_lookml). It is expected that you will have multiple LookML errors and warnings, since the `include` and `map_layer` statements use references to file locations that likely will have been moved during this procedure.\n7. Update any `include` and `map_layer` statements in your project to match the file's new path. In addition, you may see LookML validation errors for referenced objects that can no longer be found because their file paths have changed. For more information, see the documentation on [using `include` with IDE folders](/looker/docs/reference/param-model-include#using_include_with_ide_folders) and on [using `map_layer` with IDE folders](/looker/docs/reference/param-model-map-layer#using_map_layer_with_ide_folders).\n\n | **Tip:** You can use [wildcards](/looker/docs/reference/param-model-include#wildcard_examples) to create a temporary fix for LookML validation warnings and errors resulting from `include` statements. Using view files as an example, you can specify `include: \"/**/*.view\"` to include all files in all your project folders. This will prevent LookML validation problems while you continue developing. However, this is not a recommended solution for the long term, since including more files than are needed can [affect performance](/looker/docs/reference/param-model-include#including_all_view_files_can_affect_performance).\n\n \u003cbr /\u003e\n\n8. [Commit the changes](/looker/docs/version-control-and-deploying-changes#committing_changes).\n\n9. [Deploy the updates to production](/looker/docs/version-control-and-deploying-changes#deploying_to_production).\n\n10. Inform the other Looker developers that they can now [pull the updates from production](/looker/docs/git-command-reference#pull_prod) and resume developing in the project."]]
