Utiliser l'explorateur de fichiers IDE

Le moyen le plus simple d'accéder à l'IDE Looker est de passer par le menu Develop de Looker. Pour en savoir plus et accéder à d'autres options, consultez la section Accéder aux fichiers du projet.

L'IDE Looker accepte les dossiers pour les fichiers de votre projet. Les dossiers sont affichés dans le volet de navigation de gauche de l'IDE. Si vos développeurs Looker n'ont pas organisé les fichiers de votre projet en dossiers, votre projet utilise une structure de fichiers plate, avec une liste des fichiers par ordre alphabétique dans le panneau Explorateur de fichiers.

Voici un exemple de projet dans lequel un développeur a ajouté des dossiers pour différents types de fichiers de projet, tels que des explorations, des modèles et des vues:

Vous pouvez sélectionner les icônes de la barre d'outils située en haut du panneau Explorateur de fichiers pour réduire tous les dossiers, déplacer et supprimer des fichiers et des dossiers, rechercher un fichier de projet, ou créer des dossiers et des fichiers.

Réduire la barre latérale de l'IDE

Vous pouvez afficher ou masquer l'explorateur de fichiers IDE à l'aide du raccourci clavier Commande + B (Mac) ou Ctrl+B (Windows), ou en sélectionnant l'icône de l'explorateur de fichiers:

Gérer les fichiers et les dossiers

Chaque fichier ou dossier du panneau latéral de gauche possède un menu qui affiche les actions disponibles pour cet élément. Pour ouvrir le menu, sélectionnez le menu à trois points Actions sur le dossier (pour les dossiers) ou Actions sur les fichiers (pour les fichiers) à droite du nom du fichier. Si un élément porte un nom long ou est imbriqué dans plusieurs dossiers, vous pouvez accéder au menu en faisant défiler le panneau de gauche.

Vous pouvez créer des dossiers et des fichiers, importer des fichiers, et supprimer et déplacer des fichiers et des dossiers à l'aide de l'explorateur de fichiers. Pour en savoir plus, consultez la page de documentation Gérer les fichiers et les dossiers LookML.

Lorsque vous organisez vos fichiers LookML en dossiers, vous devez valider vos modifications et les déployer en production pour que d'autres développeurs Looker puissent les voir. Cette modification est semblable à celle que vous apportez à votre projet LookML.

Dossier des projets importés

Si vous importez un projet, l'IDE Looker crée automatiquement un dossier imported_projects. Les fichiers des projets locaux et des projets distants sont répertoriés dans le dossier imported_projects. Sélectionnez un fichier de projet importé dans la liste des fichiers du imported_projects pour afficher son contenu.

Étant donné qu'ils ne peuvent pas être modifiés, les fichiers de projet importés ne sont pas visibles lorsque vous modifiez des fichiers de façon groupée dans l'IDE pour les déplacer ou les supprimer.

Organiser un projet existant avec des dossiers IDE

Si votre projet utilisait auparavant l'ancienne structure de fichiers plats ou si vous souhaitez réorganiser les fichiers dans un dossier, vous pouvez choisir de conserver cette structure. Toutefois, si vous choisissez d'organiser les fichiers de votre projet en dossiers, nous vous recommandons vivement de vous préparer comme suit:

• Planifiez la structure des fichiers à l'avance avec tous les développeurs.
• Assurez-vous que tous vos développeurs Looker ont déployé toutes leurs mises à jour en production. Si un développeur a des modifications non déployées, ses branches reflètent la structure de fichiers qui existait au moment de la dernière extraction depuis la production. Si le projet comportait une structure de fichier plat à ce moment-là, la version développeur du fichier sera mise en production à son emplacement d'origine. Vous obtiendrez donc deux copies du fichier. En outre, si un développeur a annulé le déploiement des modifications pendant la migration vers des dossiers, il sera confronté à un conflit de fusion lorsqu'il effectuera l'extraction de production après la migration.
• Geler temporairement le code avec tous vos développeurs jusqu'à ce que le projet ait été entièrement migré vers la nouvelle structure de répertoires.
• Désignez un seul développeur pour déplacer les fichiers. La procédure ci-dessous suppose qu'un seul développeur migrera le projet vers des dossiers IDE. Si plusieurs développeurs doivent déplacer des fichiers, répartissez les tâches entre les développeurs pour éviter les conflits de fusion. En cas de conflits de fusion, consultez la page de documentation Utiliser le contrôle des versions et le déploiement pour savoir comment les résoudre.

Remarque :Lorsque vous déplacez un fichier dans Git, vous le supprimez et en créez un autre avec un nouveau chemin d'accès. Cela signifie que l'historique Git du fichier sera vide, car Git le considérera comme un nouveau fichier. Pour consulter l'historique Git du fichier avant son déplacement, accédez au fichier à son emplacement d'origine dans l'interface Git et consultez l'historique Git à partir de là.

Une fois que tous vos développeurs ont déployé et validé leurs modifications, et mis en pause toutes les tâches sur le projet, vous pouvez migrer le projet vers sa nouvelle structure de répertoires.

Désignez un seul développeur pour effectuer toutes les étapes suivantes:

1. Vérifiez que toutes les mises à jour de toutes les branches de développement ont été déployées en production. Cela inclut les branches de développement du développeur effectuant la migration vers les dossiers IDE.
2. Vérifiez que tous les autres développeurs ont cessé d'apporter des modifications au projet.
3. Extraire de la production :
4. Créez les dossiers du projet.
5. Déplacez les fichiers du projet dans des dossiers, en sélectionnant un fichier à la fois ou en effectuant une modification groupée.
6. Validez le code LookML du projet. Vous risquez de rencontrer plusieurs erreurs et avertissements LookML, car les instructions include et map_layer utilisent des références à des emplacements de fichiers susceptibles d'avoir été déplacés au cours de cette procédure.

7. Mettez à jour toutes les instructions include et map_layer de votre projet pour qu'elles correspondent au nouveau chemin d'accès du fichier. En outre, vous verrez peut-être des erreurs de validation LookML pour des objets référencés qui sont introuvables en raison d'un changement de chemin d'accès à leurs fichiers. Pour en savoir plus, consultez la documentation sur l'utilisation de include avec des dossiers IDE et sur l'utilisation de map_layer avec des dossiers IDE.

   Conseil:Vous pouvez utiliser des caractères génériques pour créer un correctif temporaire pour les avertissements et les erreurs de validation LookML résultant des instructions include. En prenant les fichiers de vue comme exemple, vous pouvez spécifier include: "/**/*.view" pour inclure tous les fichiers de tous les dossiers de votre projet. Cela évitera les problèmes de validation LookML pendant que vous poursuivez le développement. Cette solution n'est toutefois pas recommandée à long terme, car inclure plus de fichiers que nécessaire peut affecter les performances.

8. Validez les modifications.

9. Déployez les mises à jour en production.

10. Informez les autres développeurs Looker qu'ils peuvent désormais extraire les mises à jour de la production et reprendre le développement dans le projet.