Looker IDE에 액세스하는 가장 쉬운 방법은 Looker 개발 메뉴를 사용하는 것입니다. 자세한 내용과 기타 옵션은 프로젝트 파일 액세스를 참조하세요.
Looker IDE는 프로젝트 파일의 폴더를 지원합니다. 폴더가 IDE의 왼쪽 탐색창에 표시됩니다. Looker 개발자가 프로젝트 파일을 폴더로 정리하지 않은 경우 프로젝트는 플랫 파일 구조가 되며 파일은 파일 브라우저 패널에 알파벳순으로 나열됩니다.
다음은 개발자가 Explore, 모델, 뷰와 같은 다양한 유형의 프로젝트 파일을 위한 폴더를 추가한 프로젝트의 예입니다.
파일 브라우저 패널 상단의 툴바에서 아이콘을 선택하여 모든 폴더를 접고, 파일과 폴더를 이동 및 삭제하며, 프로젝트 파일을 검색하거나 새 폴더 및 새 파일을 만들 수 있습니다.
IDE 사이드바 접기
단축키 Command-B(Mac) 또는 Ctrl+B(Windows)를 사용하거나 파일 브라우저 아이콘을 선택하여 IDE 파일 브라우저를 표시하거나 숨길 수 있습니다.
파일 및 폴더 관리
왼쪽 패널의 각 파일이나 폴더에는 해당 항목에 사용 가능한 작업을 표시하는 메뉴가 있습니다. 파일 이름 오른쪽에 있는 점 3개로 된 폴더 작업 메뉴(폴더) 또는 파일 작업 메뉴(파일)를 선택하여 메뉴를 엽니다. 긴 이름이 있거나 여러 폴더에 중첩된 항목의 경우 왼쪽 패널에서 스크롤하여 메뉴에 액세스할 수 있습니다.
파일 브라우저를 사용하여 폴더와 파일을 만들고, 파일을 업로드하며, 파일과 폴더를 삭제하고 이동할 수 있습니다. 자세한 내용은 LookML 파일 및 폴더 관리 문서 페이지를 참조하세요.
폴더로 LookML 파일을 구성할 때 다른 Looker 개발자가 볼 수 있도록 변경사항을 커밋하고 프로덕션에 배포해야 합니다. 이는 LookML 프로젝트를 변경하는 것과 같습니다.
가져온 프로젝트 폴더
프로젝트를 가져오면 Looker IDE에서 자동으로 imported_projects
폴더를 만듭니다. 로컬 프로젝트와 원격 프로젝트의 파일이 모두 imported_projects
폴더에 나열됩니다. 파일 내용을 보려면 imported_projects
의 파일 목록에서 가져온 프로젝트 파일을 선택합니다.
이러한 파일을 수정할 수 없으므로 IDE에서 파일을 이동하거나 삭제하기 위해 파일을 일괄 편집할 때는 가져온 프로젝트 파일이 표시되지 않습니다.
IDE 폴더로 기존 프로젝트 정리
프로젝트에 기존 플랫 파일 구조가 있었거나 폴더에 있는 파일을 재구성하려는 경우 이 구조를 유지할 수 있습니다. 하지만 프로젝트 파일을 폴더로 정리하는 경우에는 다음과 같이 준비하는 것이 좋습니다.
- 모든 개발자와 함께 파일 구조를 미리 계획합니다.
- 모든 Looker 개발자가 모든 업데이트를 프로덕션에 배포했는지 확인합니다. 개발자가 배포 취소된 변경사항이 있는 경우 분기에는 마지막으로 프로덕션에서 가져올 때 존재했던 파일 구조가 반영됩니다. 이때 프로젝트의 플랫 파일 구조가 있는 경우 개발자의 파일 버전이 원래 위치에 있는 프로덕션으로 푸시되므로 결과적으로 파일 사본 두 개가 생성됩니다. 또한 개발자가 폴더로 마이그레이션하는 동안 변경사항을 배포하지 않은 경우 개발자는 마이그레이션 후 프로덕션에서 가져올 때 병합 충돌이 발생합니다.
- 프로젝트가 새 디렉터리 구조로 완전히 마이그레이션될 때까지 모든 개발자와 임시 코드 고정을 적용합니다.
- 파일 개발자를 이동할 단일 개발자를 할당합니다. 다음 절차에서는 단일 개발자가 프로젝트를 IDE 폴더로 마이그레이션한다고 가정합니다. 여러 개발자가 파일을 이동하도록 해야 하는 경우 병합 충돌을 방지하기 위해 개발자 간에 작업을 분할합니다. 병합 충돌이 발생하는 경우 해결 방법에 대한 자세한 내용은 버전 제어 및 배포 사용 문서 페이지를 참조하세요.
모든 개발자가 변경사항을 푸시하고 커밋하여 프로젝트의 모든 작업을 일시중지하면 프로젝트를 새 디렉터리 구조로 마이그레이션할 수 있습니다.
단일 개발자를 할당하여 다음 단계를 모두 수행합니다.
- 모든 개발 브랜치의 모든 업데이트가 프로덕션에 배포되었는지 확인합니다. 여기에는 IDE 폴더로의 마이그레이션을 수행하는 개발자의 개발 분기가 포함됩니다.
- 다른 모든 개발자가 프로젝트 변경을 중지했는지 확인합니다.
- 프로덕션에서 가져옵니다.
- 프로젝트 폴더를 만듭니다.
- 한 번에 하나의 파일 또는 일괄 수정을 사용하여 프로젝트 파일을 폴더로 이동합니다.
- 프로젝트의 LookML을 검사합니다.
include
및map_layer
문은 이 절차 중에 이동되었을 가능성이 있는 파일 위치에 대한 참조를 사용하므로 LookML 오류 및 경고가 여러 개 발생할 수 있습니다. 프로젝트의 모든
include
및map_layer
문을 파일의 새 경로와 일치하도록 업데이트합니다. 또한 파일 경로가 변경되어 더 이상 찾을 수 없는 참조된 객체에 대한 LookML 유효성 검사 오류가 표시될 수 있습니다. 자세한 내용은 IDE 폴더에서include
사용 및 IDE 폴더에서map_layer
사용에 대한 문서를 참조하세요.다른 Looker 개발자에게 이제 프로덕션에서 업데이트를 가져오고 프로젝트에서 개발을 재개할 수 있음을 알립니다.