IDE에서 폴더 사용하기

Looker IDE는 프로젝트 파일의 폴더를 지원합니다. 폴더는 IDE의 왼쪽 탐색창에 표시됩니다. Looker 개발자가 프로젝트 파일을 폴더로 구성하지 않은 경우 프로젝트는 파일 브라우저 패널에 알파벳순으로 나열된 플랫 파일 구조를 갖게 됩니다.

프로젝트를 폴더로 구성하려면 이 페이지의 IDE 폴더로 기존 프로젝트 정리하기 섹션을 참고하세요.

다음은 개발자가 explores, models, views와 같은 다양한 유형의 프로젝트 파일을 위한 폴더를 추가한 프로젝트의 예입니다.

단축키 Command-B (Mac) 또는 Ctrl+B (Windows)를 사용하거나 파일 브라우저 아이콘을 클릭하여 IDE 파일 브라우저를 표시하거나 숨길 수 있습니다.

파일 브라우저 패널 상단의 툴바에서 아이콘을 클릭하여 모든 폴더를 접거나, 일괄 수정을 수행하거나, 프로젝트 파일을 검색하거나, 새 폴더 및 새 파일을 만듭니다.

왼쪽 패널의 각 파일 또는 폴더에는 해당 항목에 사용 가능한 작업을 표시하는 메뉴가 있습니다. 파일 이름 오른쪽에 있는 점 3개로 된 메뉴를 클릭하여 메뉴를 엽니다. 이름이 길거나 여러 폴더에 중첩된 항목의 경우 왼쪽 패널에서 스크롤하여 메뉴에 액세스할 수 있습니다.

LookML 파일을 폴더로 구성할 때 다른 변경사항을 확인하기 전에 변경사항을 커밋하고 프로덕션에 배포해야 합니다. 이는 LookML 프로젝트를 변경하는 것과 같습니다.

가져온 프로젝트 폴더

프로젝트를 가져오면 Looker IDE에서 자동으로 imported_projects 폴더를 만듭니다. 로컬 프로젝트 및 원격 프로젝트의 파일이 imported_projects 폴더에 나열됩니다. 가져온 프로젝트 파일을 클릭하여 콘텐츠를 확인합니다.

IDE에서 파일을 일괄 수정할 때는 가져온 프로젝트 파일이 표시되지 않으므로 수정할 수 없습니다.

파일 및 폴더 관리하기

파일 및 폴더 이름 지정 규칙

파일 및 폴더를 만들 때 다음 사항에 유의하세요.

• LookML은 대소문자를 구분합니다. 폴더 이름을 지정할 때는 프로젝트의 규칙을 따라야 합니다. 예를 들어 프로젝트에서 모든 소문자를 사용하는 규칙을 사용하는 경우 Views 대신 views 폴더의 이름을 지정하는 것이 좋습니다. 이는 특히 파일 포함과 같이 파일 경로를 지정해야 하는 경우에 유용합니다. 일반적으로 LookML 객체 및 폴더의 이름을 지정할 때 소문자를 일관되게 사용하는 것이 좋습니다.
• 파일 이름에는 공백 또는 다음 문자를 포함할 수 없습니다. / ? * : | " < > %
• Looker IDE를 사용하여 LookML 파일을 만들 때 확장 프로그램을 수동으로 포함하지 않으면 Looker에서 파일 이름 끝에 .lkml 확장자를 자동으로 추가합니다. 예를 들어 파일 이름 flights_data_tests을 입력하면 Looker에서 파일 이름을 flights_data_tests.lkml로 지정합니다.
• 탐색 파일을 만들려면 파일 이름 끝에 .explore.lkml 확장자가 있어야 합니다. 파일을 업로드하는 경우 전체 .explore.lkml 확장자를 사용해야 합니다. 일반 LookML 파일 옵션을 통해 Looker IDE를 사용하여 파일을 생성하는 경우, Looker에서 파일 이름의 끝에 .lkml를 추가합니다. 단, 확장 프로그램의 .explore 부분이 수동으로 파일 이름에 추가되어야 합니다. 예를 들어 Looker IDE를 사용하여 flights라는 탐색 파일을 만들려면 flights.explore 또는 flights.explore.lkml를 입력하면 파일 이름이 flights.explore.lkml로 지정됩니다.
• Looker IDE에서 파일을 생성하거나 Looker IDE에서 업로드하여 Looker IDE를 사용하여 LookML 프로젝트에 파일을 추가하는 것이 좋습니다. 대신 Looker IDE 외부에 파일을 만든 다음 Looker IDE를 사용하여 Pull from (production branch)을 사용하는 경우 올바른 이름 지정 규칙을 사용하고 파일 이름 (또는 탐색 파일의 경우 explore.lkml)에 .lkml 확장자를 포함해야 합니다. 파일 이름에 지원되지 않는 문자가 포함되어 있으면 Looker IDE 파일 브라우저에서 파일 이름을 빨간색으로 표시하며 지원되는 문자로 이름을 바꾸지 않으면 파일의 콘텐츠를 볼 수 없습니다. 또한 파일에 .lkml 확장자가 없으면 Looker IDE에서 파일을 전혀 표시하지 않습니다.

폴더 만들기

다양한 파일 형식 (예: 보기 파일 또는 모델 파일)을 위한 폴더를 만들 수 있습니다. 하위 폴더를 생성할 수도 있습니다. 이는 뷰의 하위 집합을 include 처리하려는 경우에 매우 유용합니다.

폴더를 만들 때 LookML은 대소문자를 구분합니다. 폴더 이름을 지정할 때는 프로젝트의 규칙을 따라야 합니다. 예를 들어 프로젝트에서 모든 소문자를 사용하는 규칙을 사용하는 경우 Views 대신 views 폴더의 이름을 지정하는 것이 좋습니다. 이는 특히 파일 포함과 같이 파일 경로를 지정해야 하는 경우에 유용합니다. 일반적으로 LookML 객체 및 폴더의 이름을 지정할 때 소문자를 일관되게 사용하는 것이 좋습니다. 파일 및 폴더 이름 지정에 대한 제한사항 및 가이드라인은 이름 지정 규칙을 참고하세요.

폴더를 만드는 방법은 다음과 같습니다.

1. 적절한 메뉴에서 폴더 만들기 옵션을 선택합니다.
   • 디렉터리 구조의 최상위 수준에서 새 폴더를 만들려면 파일 브라우저 패널 상단의 + 메뉴를 사용합니다.
   • 기존 폴더 아래에 새 하위 폴더를 만들려면 기존 폴더에 점 3개로 된 메뉴를 사용합니다.
2. 새 폴더의 이름을 입력합니다.
3. 만들기를 클릭합니다.

새 폴더가 탐색창에 추가됩니다.

파일 만들기

Looker 관리자가 LookML세대 개선 실험실 기능을 사용 설정한 경우 파일 브라우저 패널 상단의 + 메뉴에 여기에 표시된 옵션 외에도 데이터베이스에서 LookML 생성 옵션이 표시됩니다.

LookML 프로젝트에서 새 파일을 만들려면 다음 단계를 따르세요.

1. 적절한 메뉴를 선택합니다.

   • 디렉터리 구조의 최상위 수준에서 새 파일을 만들려면 파일 브라우저 패널 상단의 + 메뉴를 사용합니다.
   • 기존 폴더 아래에 새 파일을 만들려면 기존 폴더에 점 3개로 된 메뉴를 사용합니다.

2. 만들려는 LookML 파일 유형을 선택합니다. 만들 수 있는 파일 형식은 다음과 같습니다.

   • 모델 파일
   • 데이터베이스 테이블을 기반으로 파일 보기
   • 파일 보기
   • 프로젝트 매니페스트 파일^*
   • 대시보드 파일
   • 문서 파일
   • 언어 문자열 파일^**
   • 다음 파일 유형에 사용되는 일반 LookML 파일:
     • 파일 탐색하기
     • 데이터 테스트 파일
     • 세분화 파일
     • LookML 요소를 보관하는 데 사용 중인 기타 모든 파일

   ^* 프로젝트 매니페스트 파일은 프로젝트에 매니페스트 파일이 아직 없는 경우에만 Looker IDE의 파일 브라우저 상단에 있는 + 아이콘에서 만들 수 있습니다. 한 프로젝트에는 하나의 매니페스트 파일만 있을 수 있으며, 매니페스트 파일은 프로젝트의 디렉터리 구조에서 루트 수준에 있어야 하기 때문입니다.
   ^** 언어 문자열 파일 만들기 옵션은 Looker IDE의 파일 브라우저 상단에 있는 + 아이콘에서만 사용할 수 있지만 언어 문자열 파일이 만들어졌거나 업로드되면 파일을 폴더로 이동할 수 있습니다.

3. 파일 만들기 팝업에 새 파일의 이름을 입력합니다. 파일 이름 지정에 대한 제한사항 및 가이드라인은 파일 이름 지정 규칙을 참고하세요.

4. 만들기를 클릭합니다. 새 파일이 생성된 위치에 표시됩니다. 필요한 경우 간편하게 다른 폴더로 이동할 수 있습니다.

파일을 만든 후 프로젝트의 다른 LookML 파일에서 파일의 요소를 참조하려면 include 매개변수를 사용해야 합니다. 자세한 내용은 include 매개변수 문서 페이지를 참고하세요.

파일 업로드

컴퓨터에서 프로젝트에 파일을 업로드할 수도 있습니다. 이 방법은 컴퓨터에서 로컬로 JSON 데이터 파일 또는 LookML 파일을 만든 경우에 유용합니다.

파일 이름 지정에 대한 제한사항 및 가이드라인은 이름 지정 규칙을 참고하세요.

프로젝트에 파일을 업로드하려면 Looker IDE에서 드래그 앤 드롭 기능을 사용합니다.

1. 프로젝트 파일로 이동합니다.
2. 컴퓨터에서 Looker IDE로 파일을 드래그합니다. 디렉터리 구조의 루트에 파일이 표시됩니다.
3. 파일이 업로드되면 항목을 다른 폴더로 이동합니다.

파일을 업로드한 후 프로젝트의 다른 LookML 파일에서 파일의 요소를 참조하려면 include 매개변수를 사용해야 합니다. 자세한 내용은 include 매개변수 문서 페이지를 참고하세요.

파일 및 폴더 삭제

IDE의 왼쪽 패널에 있는 항목의 점 3개 메뉴에서 폴더 또는 파일을 삭제하려면 삭제를 선택합니다.

폴더를 삭제하면 폴더 내용도 삭제되므로 폴더를 삭제할 때 주의하세요. 폴더를 삭제하기 전에 다음을 수행하세요.
• 폴더를 삭제할지 아니면 폴더를 삭제할 것인지 확인합니다.
• 폴더에 프로젝트의 include 문에서 참조하는 파일이 포함되어 있지 않은지 확인합니다. 이 페이지에 있는 IDE 폴더에서 include 사용 섹션을 참고하여 IDE 폴더에서 include을 사용하는 방법을 알아보세요.

폴더를 삭제하면 IDE에서 확인 팝업을 표시합니다. 팝업에는 폴더 및 폴더 내 모든 파일을 포함하여 삭제에 포함된 항목 수가 지정됩니다.

폴더가 있는 프로젝트의 항목 이동

단일 파일 또는 모든 콘텐츠가 포함된 전체 폴더를 새 위치로 드래그 앤 드롭할 수 있습니다.

파일이나 폴더를 다른 폴더로 드래그 앤 드롭합니다. 다른 폴더 또는 파일을 받기 위해 대상 폴더를 펼칠 필요는 없습니다. 항목 위로 마우스를 가져가면 폴더가 자동으로 확장됩니다.

파일 경로를 변경할 때는 프로젝트의 include 문이 새 파일 경로와 일치하도록 업데이트해야 합니다. 이 페이지에 있는 IDE 폴더에서 include 사용 섹션을 참고하여 IDE 폴더에서 include를 사용하는 방법을 알아보세요.

또한 파일의 경로를 변경하면 Git은 파일을 효과적으로 삭제하고 새 파일 경로를 사용하여 새 파일을 만듭니다. 즉, Git이 새 파일로 간주하기 때문에 파일의 Git 기록이 비어 있습니다. 파일이 이동되기 전에 Git 기록을 보려면 Git 인터페이스를 사용하여 원래 위치의 파일로 이동하고 여기서 Git 기록을 확인하세요. Git이 파일을 효과적으로 삭제하고 다른 이름으로 새 파일을 만들기 때문에 이름이 변경된 파일에도 동일한 로직이 적용됩니다.

파일 및 폴더 일괄 수정

폴더와 파일을 여러 개 선택하여 새 위치로 이동하거나 삭제할 수도 있습니다.

파일 및 폴더 일괄 이동하기

폴더 및 파일을 일괄 이동하려면 다음 단계를 따르세요.

1. 파일 브라우저 패널 상단에서 일괄 수정 아이콘을 클릭합니다.
2. 이동할 항목을 선택합니다. 파일 선택 헤더 옆에 선택한 파일 수가 보라색으로 표시됩니다.
   • 개별 파일을 선택 또는 선택 해제하려면 폴더를 펼치고 파일 이름 옆에 있는 체크박스를 클릭합니다.
   • 전체 폴더 및 폴더 콘텐츠를 선택하거나 선택 해제하려면 폴더 이름 옆의 체크박스를 클릭합니다.
   • 디렉터리 목록의 전체 섹션을 선택하려면 Shift 키를 누른 상태에서 클릭합니다. 범위 내 최상위 항목의 체크박스를 클릭한 다음 Shift 키를 누른 상태에서 목록의 마지막 항목에 대한 체크박스를 클릭합니다. 항목과 그 사이의 모든 항목이 모두 선택됩니다. Shift 키를 누른 상태에서 항목을 클릭하면 디렉터리 목록에서 항목을 선택하고 그 위에 있는 모든 항목을 선택할 수도 있습니다.
3. 항목 일괄 이동 폴더 아이콘을 클릭하여 옵션을 선택합니다. 그러면 IDE에 폴더 선택 팝업 메뉴가 표시됩니다.
4. 팝업 메뉴에서 선택한 항목에 대한 폴더를 선택하거나 새 폴더를 클릭하여 새 폴더를 만듭니다. 프로젝트 이름의 다음 메뉴 페이지 상단에 선택한 폴더의 파일 경로가 표시됩니다. 프로젝트의 루트 디렉터리로 항목을 이동하려면 선택한 폴더 없이 Move를 클릭합니다.
5. 이동을 클릭하여 선택한 대상을 확인하거나, 새 폴더를 클릭하여 선택한 폴더 내에 새 폴더를 만들거나, 파일 경로에서 프로젝트 이름 링크를 클릭하여 기본 폴더 옵션 메뉴로 돌아갑니다.
6. 파일 선택 헤더에서 X를 클릭하여 일괄 수정 모드를 종료합니다.

파일 경로를 변경한 후에는 프로젝트의 include 문이 새 파일 경로와 일치하도록 업데이트해야 합니다. 이 페이지에 있는 IDE 폴더에서 include 사용 섹션을 참고하여 IDE 폴더에서 include를 사용하는 방법을 알아보세요.

또한 파일의 경로를 변경하면 Git은 파일을 효과적으로 삭제하고 새 파일 경로를 사용하여 새 파일을 만듭니다. 즉, Git이 새 파일로 간주하기 때문에 파일의 Git 기록이 비어 있습니다. 파일이 이동되기 전에 Git 기록을 보려면 Git 인터페이스를 사용하여 원래 위치의 파일로 이동하고 여기서 Git 기록을 확인하세요. Git이 파일을 효과적으로 삭제하고 다른 이름으로 새 파일을 만들기 때문에 이름이 변경된 파일에도 동일한 로직이 적용됩니다.

파일 및 폴더 일괄 삭제

폴더 및 파일을 일괄 삭제하려면 다음 단계를 따르세요.

폴더를 삭제하면 폴더의 모든 콘텐츠가 삭제됩니다. 폴더를 삭제하기 전에 폴더에 있는 파일을 삭제할지 확인하세요. 파일을 보관하려면 폴더를 삭제하기 전에 파일을 다른 위치로 이동하세요.

1. 파일 브라우저 패널 상단에서 일괄 수정 아이콘을 클릭합니다.
2. 삭제할 항목을 선택합니다. 파일 선택 헤더 옆에 선택한 파일 수가 보라색으로 표시됩니다.
   • 개별 파일을 선택 또는 선택 해제하려면 폴더를 펼치고 파일 이름 옆에 있는 체크박스를 클릭합니다.
   • 전체 폴더 및 폴더 콘텐츠를 선택하거나 선택 해제하려면 폴더 이름 옆의 체크박스를 클릭합니다.
   • 디렉터리 목록의 전체 섹션을 선택하려면 Shift 키를 누른 상태에서 클릭합니다. 범위 내 최상위 항목의 체크박스를 클릭한 다음 Shift 키를 누른 상태에서 목록의 마지막 항목에 대한 체크박스를 클릭합니다. 항목과 그 사이의 모든 항목이 모두 선택됩니다. Shift 키를 누른 상태에서 항목을 클릭하면 디렉터리 목록에서 항목을 선택하고 그 위에 있는 모든 항목을 선택할 수도 있습니다.
3. 항목 삭제 휴지통 아이콘을 클릭합니다. 그러면 IDE에 선택한 항목이 나열된 팝업 메뉴가 표시됩니다.
4. 예, 삭제합니다를 클릭하여 삭제할 항목을 확인하거나 취소를 클릭하여 항목 선택으로 돌아갑니다.
5. 파일 선택 헤더에서 X를 클릭하여 일괄 수정 모드를 종료합니다.

IDE 폴더에 include 사용

프로젝트 파일을 폴더로 구성한 후 include 문을 사용할 때 파일 경로를 제공해야 합니다.

include를 사용할 때 LookML은 대소문자를 구분합니다. 파일 경로를 지정할 때는 파일 및 경로에 있는 폴더의 대소문자가 일치해야 합니다. 예를 들어 파일이 Views 폴더에 있는 경우 include 매개변수에 이 대소문자와 일치해야 합니다. 따라서 include: "/Views/accidents.view"을 지정합니다. 일반적으로 LookML 객체 및 폴더의 이름을 지정할 때는 소문자로 유지하는 것이 좋습니다.

include 문에 절대 경로 또는 상대 경로를 사용할 수 있으며 (예: 이 페이지의 경로 구문 섹션 참조) 와일드 카드 * 및 **를 사용하여 여러 파일을 한 번에 포함할 수 있습니다 (이 페이지의 와일드 카드 예 섹션 참조).

예를 들어 프로젝트에 다음과 같은 디렉터리 구조가 있다고 가정해 보겠습니다.

다음 문에는 products 뷰, order_facts 뷰, /views/users/ 디렉터리의 모든 뷰가 포함됩니다.

include: "/views/products.view"
include: "/views/orders/order_facts.view"
include: "/views/users/*.view"

파일 경로를 변경할 때 프로젝트의 include 문을 업데이트하여 파일의 새 경로와 일치해야 합니다. 기존 include 문이 더 이상 기존 파일 또는 파일 경로를 참조하지 않는 경우 LookML 유효성 검사 경고가 표시될 수 있습니다. 또한 참조된 객체의 파일 경로가 변경되어 더 이상 찾을 수 없는 LookML 유효성 검사 오류가 표시될 수도 있습니다.

도움말: 와일드 카드를 사용할 때 파일의 줄 번호 옆에 있는 정보 아이콘 위로 마우스를 가져가거나 include 문을 클릭하고 빠른 도움말을 살펴보면 포함된 파일을 확인할 수 있습니다.

유용한 도움말: Looker IDE의 파일 점 3개 메뉴에서 Copy File Path(파일 경로 복사)를 선택하여 파일 경로를 복사할 수 있습니다.

경로 구문

다음은 파일을 포함하는 데 사용할 수 있는 구문의 예입니다.

구문	설명
PATH	현재 파일의 위치에서 시작되는 상대 경로입니다.
./PATH	현재 파일의 위치에서 시작되는 상대 경로입니다. 이 예시는 위 예시와 동일한 파일(PATH)을 가리킵니다.
../PATH	현재 파일의 상위 디렉터리부터 시작되는 상대 경로입니다.
/PATH	현재 프로젝트의 루트에서 시작하는 절대 경로입니다.
//PROJECT_NAME/PATH	가져온 프로젝트의 루트에서 시작하는 절대 경로(PROJECT_NAME)입니다.

와일드 카드 예

LookML 상세검색을 사용하는 경우 포함에 와일드 카드를 사용하지 마세요. LookML 상세검색은 포함 순서를 활용하며 포함에 와일드 카드를 사용하면 각 파일이 포함된 순서를 제어할 수 없습니다. 상세검색에 대한 자세한 내용은 LookML 상세검색 문서 페이지를 참조하세요.

와일드 카드를 사용한 예는 다음과 같습니다 (참고: PATH를 이전 표의 경로 문법으로 대체 가능).

구문	설명
PATH/*.view	.view(으)로 끝나는 와일드 카드 일치 파일이 PATH에 있습니다.
PATH/*.view.lkml	.view.lkml(으)로 끝나는 와일드 카드 일치 파일이 PATH에 있습니다. 뷰 파일 확장자는 .view.lkml이므로 이 예시에서는 이전 예시인 PATH/*.view과 동일한 파일을 지정합니다. .lkml 부분은 IDE에 표시되지 않으며 include 문에 .lkml 부분도 필요하지 않습니다. 하지만 와일드 카드를 사용하면 파일 확장자에서 이와 같은 일반적인 부분을 활용할 수 있습니다. 프로젝트 파일 확장자 목록은 LookML 프로젝트 파일 문서 페이지를 참고하세요.
PATH/*.lkml	.lkml(으)로 끝나는 와일드 카드 일치 파일이 PATH에 있습니다. .view.lkml, .model.lkml 등 여러 파일 형식은 파일 확장자의 마지막 부분으로 .lkml를 공유합니다. .lkml 부분은 IDE에 표시되지 않으며 include 문에 .lkml 부분도 필요하지 않습니다. 하지만 와일드 카드를 사용하면 파일 확장자에서 이와 같은 일반적인 부분을 활용할 수 있습니다. 프로젝트 파일 확장자 목록은 LookML 프로젝트 파일 문서 페이지를 참고하세요.
PATH/myfile.*	myfile라는 와일드 카드 일치 파일과 PATH에 모든 확장자 유형이 있음
PATH/myfile.*.lkml	myfile이라는 와일드 카드 일치 파일과 PATH에 .lkml 확장자 유형이 있습니다.
PATH/my*file.view	my로 시작하고 file.view에서 PATH로 끝나는 와일드 카드 파일
PATH/my*fi*le.view	my로 시작하는 파일, 일부 문자가 fi, 일부 추가 문자, PATH로 끝나는 le.view 와일드 카드와 일치합니다.
PATH/*/myfile.lkml	폴더 이름 와일드 카드 (중첩 수준 하나만 일치) PATH의 직접 하위 디렉터리에 있는 모든 myfile.lkml 파일과 일치합니다.
PATH/**/my_file.view	PATH에서 my_file.view.lkml라는 모든 파일 및 모든 하위 디렉터리에 대한 재귀 와일드 카드 일치 (중첩 분량과 일치)
PATH/**/*.view	.view.lkml의 마지막 부분이 PATH의 하위 디렉터리에서 일치하는 재귀 와일드 카드
PATH/**/my_folder/myfile.view	하위 경로 /my_folder/myfile.view와 일치하는 PATH 아래의 모든 반복 와일드 카드

IDE 폴더에 map_layer 사용

프로젝트에 IDE 폴더가 사용 설정된 경우 map_layer에 프로젝트 파일을 지정할 때 파일 경로를 사용해야 합니다.

map_layer: neighborhoods {
  file: "/maps/my_neighborhoods.json"
}

IDE 폴더를 사용하여 기존 프로젝트 정리

프로젝트에 기존 플랫 파일 구조가 있는 경우 이 구조를 유지할 수 있지만, 프로젝트 파일을 폴더로 정리하기로 선택하는 경우 다음과 같이 대비하는 것이 좋습니다.

• 모든 개발자와 함께 파일 구조를 미리 계획하세요.
• 모든 Looker 개발자가 모든 업데이트를 프로덕션에 배포했는지 확인합니다. 개발자가 배포되지 않은 변경사항이 있는 경우 분기에 프로덕션에서 마지막으로 가져온 파일 구조가 반영됩니다. 해당 시점에 플랫 파일 구조가 있다면 개발자의 파일 버전이 원래 위치에서 프로덕션으로 푸시되므로 결국 사용자는 파일 사본 2개를 받게 됩니다. 또한 개발자가 폴더로 이전하는 동안 배포되지 않은 변경사항이 있는 경우 이전 후 프로덕션에서 가져올 때 병합 병합 충돌이 발생합니다.
• 프로젝트가 새 디렉터리 구조로 완전히 이전될 때까지 모든 개발자에게 임시 코드 정지를 적용합니다.
• 파일 이동을 위해 단일 개발자를 할당합니다. 아래 절차에서는 단일 개발자가 프로젝트를 IDE 폴더로 이전한다고 가정합니다. 여러 개발자가 파일을 이전해야 하는 경우 병합 작업을 피하기 위해 여러 개발자 간에 작업을 분할합니다. 병합 충돌이 발생하면 문제 해결에 대한 자세한 내용은 버전 제어 및 배포 사용 문서 페이지를 참조하세요.

Git에서 파일을 이동하면 파일을 효과적으로 삭제하고 새 파일 경로를 사용하여 새 파일을 만들 수 있습니다. 즉, Git은 새 기록으로 간주하므로 파일의 Git 기록이 비어 있습니다. 파일이 이동되기 전에 Git 기록을 보려면 Git 인터페이스를 사용하여 원래 위치의 파일로 이동하고 여기서 Git 기록을 확인하세요.

모든 개발자가 변경사항을 푸시하여 커밋하고 프로젝트의 모든 작업을 일시중지한 후 프로젝트를 새 디렉터리 구조로 이전할 수 있습니다.

한 명의 개발자에게 다음 단계를 모두 할당하세요.

1. 모든 개발 브랜치의 모든 업데이트가 프로덕션에 배포되었는지 확인합니다. 여기에는 IDE 폴더로 이전하는 개발자의 개발 브랜치가 포함됩니다.
2. 다른 모든 개발자가 프로젝트 변경을 중지했는지 확인합니다.
3. 프로덕션에서 가져오기
4. 프로젝트의 폴더를 만듭니다.
5. 한 번에 파일 하나씩 또는 일괄 수정을 사용하여 프로젝트 파일을 폴더로 이동합니다.
6. 프로젝트의 LookML을 검사합니다. include 및 map_layer 문은 이 절차 동안 이동되었을 가능성이 있는 파일 위치에 대한 참조를 사용하므로 LookML 오류 및 경고가 여러 개 있을 것으로 예상됩니다.

7. 프로젝트의 include 및 map_layer 문을 파일의 새 경로와 일치하도록 업데이트하세요. 또한 참조된 객체의 파일 경로가 변경되어 더 이상 찾을 수 없는 LookML 유효성 검사 오류가 표시될 수도 있습니다. 이 페이지의 IDE 폴더에서 include 사용 섹션을 참고하여 IDE 폴더에서 include를 사용하는 방법을 알아보고, 이 페이지의 map_layer을 IDE 폴더와 함께 사용 섹션에서 IDE 폴더에서 지도 레이어를 사용하는 방법을 알아보세요.

   유용한 도움말: 와일드 카드를 사용하여 include 문으로 발생하는 LookML 유효성 검사 경고 및 오류에 대한 일시적 수정을 만들 수 있습니다. 예시로 뷰 파일을 사용하면 모든 프로젝트 폴더에 모든 파일을 포함하도록 include: "/**/*.view"를 지정할 수 있습니다. 이렇게 하면 개발을 진행하는 동안 LookML 검증 문제를 방지할 수 있습니다. 그러나 필요한 것보다 많은 파일을 포함하면 성능에 영향을 줄 수 있으므로 장기적으로 권장하지는 않습니다.

8. 변경사항을 커밋합니다.

9. 프로덕션에 업데이트 배포

10. 다른 Looker 개발자에게 이제 프로덕션에서 업데이트를 가져와 프로젝트에서 개발을 계속할 수 있다고 안내합니다.