LookML 프로젝트 파일은 Looker IDE의 파일 브라우저 섹션에 있는 폴더로 구성됩니다. 이 페이지에서는 LookML 프로젝트에서 폴더와 파일을 만들고 관리하는 방법을 안내합니다.
LookML 프로젝트의 각 파일 형식 구조와 목적에 관한 자세한 내용은 LookML 프로젝트의 파일 유형 문서 페이지를 참조하세요.
시작하기 전: 중요한 파일 및 폴더 이름 지정 규칙
파일 및 폴더를 만들 때 다음 이름 지정 규칙에 유의하세요.
- 대소문자 구분: LookML은 대소문자를 구분합니다. 폴더 이름을 지정할 때는 프로젝트의 규칙을 준수해야 합니다. 예를 들어 규칙에 프로젝트의 모든 소문자를 사용하는 경우 폴더 이름을
Views
대신views
로 지정하는 것이 좋습니다. 이는 특히 파일 포함과 같이 파일 경로를 지정해야 하는 경우에 영향을 줍니다. 일반적으로 LookML 객체와 폴더의 이름을 지정할 때 소문자를 일관되게 사용하는 것이 좋습니다. - 공백 및 특수문자: 파일 이름에는 공백이나 다음과 같은 문자를 포함할 수 없습니다.
/
?
*
:
|
"
<
>
%
- 파일 확장자: Looker IDE로 LookML 파일을 만들 때 확장자를 직접 포함하지 않으면 Looker에서
.lkml
확장자를 자동으로 파일 이름 끝에 추가합니다. 예를 들어 파일 이름을flights_data_tests
로 입력하면 Looker에서 파일 이름을flights_data_tests.lkml
로 지정합니다. - LookML 객체의 표시 이름 변경: 모델 또는 LookML 객체의 표시 이름을 변경하려면 파일 또는 객체의 이름을 변경하는 대신
label
매개변수 또는alias
매개변수를 사용하는 것이 좋습니다.label
및alias
매개변수는 이메일 또는 다른 시스템에 사용되는 기본 URL을 유지하면서 표시 이름을 변경합니다. 일반적으로 가능한 비침습적으로 모델을 변경해야 합니다. 모델이나 객체의 이름을 바꿔야 하는 경우 콘텐츠 검사기를 사용하여 모델 또는 객체의 모든 참조를 업데이트합니다.
폴더 만들기
다양한 파일 형식(예: 뷰 파일 또는 모델 파일)에 대한 폴더를 만들 수 있습니다. 하위 폴더를 만들 수도 있습니다. 이는 뷰의 하위 집합을 include
처리하려는 경우에 매우 유용합니다.
폴더를 만드는 방법은 다음과 같습니다.
- 적절한 메뉴에서 폴더 만들기 옵션을 선택합니다.
- 디렉터리 구조의 최상위에 새 폴더를 만들려면 파일 브라우저 패널 상단에서 +(더하기) 아이콘을 선택하여 액세스할 수 있는 파일 또는 폴더 추가 메뉴를 사용하세요.
- 기존 폴더에 새 하위 폴더를 만들려면 기존 폴더에 점 3개로 된 폴더 옵션 메뉴를 사용합니다.
- 새 폴더의 이름을 입력합니다.
- 만들기를 선택합니다.
새 폴더가 탐색창에 추가됩니다.
파일 만들기
새 프로젝트를 만들 때 데이터베이스를 기반으로 모델 파일을 자동으로 생성하고 파일을 볼 수 있습니다. 기존 프로젝트의 경우 새 파일을 수동으로 만들 수 있습니다.
LookML 프로젝트에서 새 파일을 만들려면 다음 안내를 따르세요.
적절한 메뉴를 선택합니다.
- 디렉터리 구조의 최상위 수준에서 새 파일을 만들려면 파일 브라우저 패널 상단에서 +(더하기) 아이콘을 선택하여 액세스할 수 있는 파일 또는 폴더 추가 메뉴를 사용하세요.
- 기존 폴더에 새 파일을 만들려면 기존 폴더에 점 3개로 된 폴더 옵션 메뉴를 사용합니다.
만들려는 LookML 파일 유형을 선택합니다. 각 파일 유형에 대한 자세한 설명을 보려면 다음 목록에서 링크를 선택합니다. 만들 수 있는 파일 유형은 다음과 같습니다.
- 파일 확장자가
.model.lkml
인 모델 파일 - 파일 확장자가
.view.lkml
*
인 뷰 파일 - 항상 이름이
manifest.lkml
**
인 프로젝트 매니페스트 파일 - 파일 확장자가
.dashboard.lookml
인 대시보드 파일 - 파일 확장자가
.md
인 문서 파일 - 파일 확장자가
.strings.json
***
인 언어 문자열 파일 - 일반 LookML 파일: 다음 유형의 파일에 사용됩니다.
- 파일 확장자가
.explore.lkml
****
인 Explore 파일 - 파일 확장자가
.lkml
인 데이터 테스트 파일 - 파일 확장자가
.lkml
인 상세검색 파일 - LookML 요소를 보관하는 데 사용 중인 기타 모든 파일
- 파일 확장자가
- 파일 확장자가
파일 만들기 팝업에 새 파일의 이름을 입력합니다. 파일 이름 지정에 대한 제한사항과 가이드라인은 파일 및 폴더 만들기에 관한 중요 참고사항을 참조하세요.
만들기를 선택합니다. 파일이 생성된 위치에 새 파일이 표시됩니다. 필요한 경우 쉽게 다른 폴더로 이동할 수 있습니다.
뷰 파일 만들기 관련 고려사항
대부분의 LookML 개발자는 LookML 프로젝트를 데이터베이스의 테이블 세트에서 생성할 때 자동으로 생성되는 하나 이상의 뷰 파일로 시작합니다. 하지만 개발 모드에서 Looker 개발자가 LookML 프로젝트에 뷰 파일을 추가할 수 있는 방법은 이 페이지에 설명된 빈 뷰 파일 만들기 및 파일 업로드 외에도 다양합니다.
데이터베이스의 테이블을 기반으로 뷰 파일 만들기:
- 모델 생성 문서 페이지에 설명된 대로 데이터베이스에 처음 연결할 때 데이터베이스 테이블에서 뷰 파일 생성합니다.
- 이 페이지의 기존 데이터베이스 테이블에서 새 뷰 추가 섹션에 설명된 대로 이미 데이터베이스에 연결된 프로젝트의 데이터베이스 테이블에서 뷰 파일 생성합니다.
파생된 테이블의 뷰 파일 만들기:
- 이 페이지에 설명된 옵션 중 하나를 사용하여 빈 뷰 파일로 시작한 후 기본 파생 테이블 만들기 문서 페이지의 LookML에서 기본 파생 테이블 정의 섹션에 설명된 대로 파생 테이블을 수동 정의합니다.
- 기본 파생 테이블 만들기 문서 페이지의 Explore를 사용하여 기본 파생 테이블 정의 섹션에 설명된 대로 Looker가 Explore에서 파생 테이블 LookML을 만들도록 합니다.
- SQL Runner를 사용하여 파생 테이블 만들기 문서 페이지에 설명된 대로 Looker가 SQL Runner 쿼리에서 파생 테이블 LookML을 만들도록 합니다.
새 뷰를 사용하려면 explore
매개변수를 사용하여 모델 파일에 추가하거나 join
매개변수를 사용하여 모델 파일의 기존 Explore에 조인합니다.
기존 데이터베이스 테이블에서 새 뷰 추가
개발 모드에서 기존 데이터베이스 테이블에서 뷰 파일을 만들 수 있습니다.
프로젝트 내에서 Looker IDE의 프로젝트 파일 목록 상단에 있는 +(더하기)를 선택하여 파일 또는 폴더 추가 메뉴를 선택하거나, 폴더 메뉴를 선택하여 폴더 내에 파일을 만들 수 있습니다.
테이블에서 뷰 만들기를 선택합니다.
Looker에 연결 중 하나와 연결된 테이블 목록이 표시됩니다. 연결을 변경하려면 왼쪽 상단의 연결 드롭다운을 사용합니다.
테이블 이름 왼쪽의 체크박스를 선택하여 뷰를 만들려는 테이블을 선택합니다. 이 목록의 데이터베이스 또는 스키마를 접거나 펼쳐 사용 가능한 모든 테이블에 액세스할 수 있습니다.
페이지 맨 아래로 스크롤하여 뷰 만들기를 선택합니다.
Looker는 모든 테이블 열에 LookML이 포함된 뷰를 생성합니다.
파일 업로드
컴퓨터에서 프로젝트에 파일을 업로드할 수도 있습니다. 컴퓨터에서 로컬로 JSON 데이터 파일 또는 LookML 파일을 만든 경우에 유용합니다.
프로젝트에 파일을 업로드하려면 Looker IDE에서 드래그 앤 드롭 기능을 사용하세요.
- 프로젝트 파일로 이동합니다.
- 컴퓨터의 파일을 Looker IDE로 드래그합니다. 이 파일은 디렉터리 구조의 루트에 표시됩니다.
- 파일이 업로드되면 항목을 다른 폴더로 이동합니다.
파일 및 폴더 삭제
IDE 왼쪽 패널에 있는 항목의 점 3개로 된 파일 옵션 메뉴에서 삭제를 선택하여 폴더나 파일을 삭제합니다.
폴더를 삭제하면 IDE에서 확인 팝업을 표시합니다. 팝업은 폴더 및 폴더 내의 모든 파일을 포함하여 삭제에 포함된 항목의 수를 지정합니다.
파일 및 폴더 일괄 삭제
폴더 및 파일을 일괄 삭제하려면 다음 단계를 따르세요.
파일 브라우저 패널 상단에서 일괄 수정 아이콘을 선택합니다.
삭제할 항목을 선택합니다. 선택한 파일 수가 파일 선택 헤더 옆에 표시됩니다.
- 개별 파일을 선택하거나 선택 해제하려면 폴더를 펼치고 파일 이름 옆의 체크박스를 선택합니다.
- 전체 폴더 및 폴더 콘텐츠를 선택하거나 선택 해제하려면 폴더 이름 옆의 체크박스를 선택합니다.
- 디렉터리 목록의 전체 섹션을 선택하려면 Shift 키를 누른 상태에서 클릭합니다. 범위 내 최상단에 있는 항목의 체크박스를 선택한 다음 Shift 키를 누른 상태에서 목록의 마지막 항목에 대한 체크박스를 선택합니다. 두 항목과 그 사이의 모든 항목이 선택됩니다. 항목을 Shift 키를 누른 채 클릭하여 디렉터리 목록에서 항목과 그 위에 있는 모든 항목을 선택할 수도 있습니다.
항목 삭제 휴지통 아이콘을 선택합니다. 그러면 IDE에서 선택한 항목을 나열하는 팝업 메뉴를 표시합니다.
예, 삭제합니다를 선택하여 삭제할 항목을 확인하거나 취소를 선택하여 항목 선택으로 돌아갑니다.
X 헤더에서 X를 선택하여 일괄 수정 모드를 종료합니다.
폴더 내 프로젝트의 항목 이동
파일을 이동하려면 파일 또는 폴더를 다른 폴더로 드래그 앤 드롭합니다.
다른 폴더 또는 파일을 수신하기 위해 대상 폴더를 확장하지 않아도 됩니다. 폴더 위로 마우스를 가져가면 폴더가 자동으로 확장됩니다.
파일 및 폴더 일괄 이동
폴더 및 파일을 일괄 이동하려면 다음 단계를 따르세요.
파일 브라우저 패널 상단에서 일괄 수정 아이콘을 선택합니다.
이동할 항목을 선택합니다. 선택한 파일 수가 파일 선택 헤더 옆에 표시됩니다.
- 개별 파일을 선택하거나 선택 해제하려면 폴더를 펼치고 파일 이름 옆의 체크박스를 선택합니다.
- 전체 폴더 및 폴더 콘텐츠를 선택하거나 선택 해제하려면 폴더 이름 옆의 체크박스를 선택합니다.
- 디렉터리 목록의 전체 섹션을 선택하려면 Shift 키를 누른 상태에서 클릭합니다. 범위 내 최상단에 있는 항목의 체크박스를 선택한 다음 Shift 키를 누른 상태에서 목록의 마지막 항목에 대한 체크박스를 선택합니다. 두 항목과 그 사이의 모든 항목이 선택됩니다. 항목을 Shift 키를 누른 채 클릭하여 디렉터리 목록에서 항목과 그 위에 있는 모든 항목을 선택할 수도 있습니다.
항목 이동 폴더 아이콘을 선택하여 옵션을 선택합니다. 그러면 IDE에서 폴더 선택 팝업 메뉴를 표시합니다.
이동 팝업 메뉴에서 선택한 항목이 있는 폴더를 선택하거나 새 폴더를 선택하여 새 폴더를 만듭니다. 다음 메뉴 페이지의 상단에서 선택했던 폴더의 파일 경로가 프로젝트 이름에 표시됩니다. 프로젝트의 루트 디렉터리로 항목을 이동하려면 폴더를 선택하지 않고 이동을 선택합니다.
이동을 선택하여 선택한 대상을 확인하거나, 새 폴더를 선택하여 선택한 폴더 내에 새 폴더를 만들거나, 파일 경로에서 프로젝트 이름 링크를 선택하여 기본 폴더 옵션 메뉴로 돌아갑니다.
X 헤더에서 X를 선택하여 일괄 수정 모드를 종료합니다.