LookML 파일 및 폴더 관리

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 처리하려는 경우에 매우 유용합니다.

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

  1. 적절한 메뉴에서 폴더 만들기 옵션을 선택합니다.
    • 디렉터리 구조의 최상위에 새 폴더를 만들려면 파일 브라우저 패널 상단에서 +(더하기) 아이콘을 선택하여 액세스할 수 있는 파일 또는 폴더 추가 메뉴를 사용하세요.
    • 기존 폴더에 새 하위 폴더를 만들려면 기존 폴더에 점 3개로 된 폴더 옵션 메뉴를 사용합니다.
  2. 새 폴더의 이름을 입력합니다.
  3. 만들기를 선택합니다.

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

파일 만들기

모델을 생성하면 Looker에서 데이터베이스를 기반으로 하는 모델 파일과 뷰 파일을 자동으로 만듭니다. 기존 프로젝트의 경우 새 파일을 수동으로 만들 수 있습니다.

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

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

    • 디렉터리 구조의 최상위 수준에서 새 파일을 만들려면 파일 브라우저 패널 상단에서 +(더하기) 아이콘을 선택하여 액세스할 수 있는 파일 또는 폴더 추가 메뉴를 사용하세요.
    • 기존 폴더에 새 파일을 만들려면 기존 폴더에 점 3개로 된 폴더 옵션 메뉴를 사용합니다.

  2. 만들려는 LookML 파일 유형을 선택합니다. 각 파일 유형에 관한 자세한 설명을 보려면 다음 목록에서 링크를 선택하세요. 만들 수 있는 파일 유형은 다음과 같습니다.

  3. Create File 대화상자에 새 파일의 이름을 입력합니다. 파일 이름 지정에 대한 제한사항과 가이드라인은 중요한 파일 및 폴더 이름 지정 규칙 섹션을 참고하세요.

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

파일 만들기 고려사항

파일을 만들 때는 다음 사항을 고려하세요.

  • Looker IDE에서 파일을 만들거나 Looker IDE에서 파일을 업로드하는 방식으로 Looker IDE를 사용하여 LookML 프로젝트에 파일을 추가하는 것이 좋습니다. 대신 Looker IDE 외부에 파일을 만든 다음 Looker IDE를 사용하여 가져오기 (프로덕션 브랜치)하는 경우 올바른 이름 지정 규칙을 사용하고 파일 이름에 .lkml 확장자 (또는 Explore 파일의 경우 explore.lkml)를 포함해야 합니다. 파일 이름에 지원되지 않는 문자가 포함되어 있으면 Looker IDE 파일 브라우저에 파일 이름이 빨간색으로 표시되며, 지원되는 문자로 파일의 이름을 변경할 때까지 파일의 콘텐츠를 볼 수 없습니다. 또한 파일에 .lkml 확장자가 없으면 Looker IDE에 파일이 전혀 표시되지 않습니다.
  • 파일을 만든 후 프로젝트의 다른 LookML 파일에서 파일의 요소를 참조하려면 include 매개변수를 사용해야 합니다. 자세한 내용은 include 매개변수 문서 페이지를 참고하세요.
  • 7개 이상의 폴더 아래에 중첩된 파일을 만들면 파일 탐색기에 파일이 표시되지 않습니다.
  • 프로젝트 매니페스트 파일은 + (더하기) 아이콘을 선택하여 Looker IDE의 파일 브라우저 상단에서 파일 또는 폴더 추가 메뉴를 열거나 프로젝트에 아직 매니페스트 파일이 없는 경우에만 만들 수 있습니다. 한 프로젝트에는 하나의 매니페스트 파일만 있을 수 있으며, 매니페스트 파일은 프로젝트의 디렉터리 구조 중 루트 수준에 있어야 하기 때문입니다.
  • 언어 문자열 파일 만들기 옵션은 Looker IDE의 파일 브라우저 상단에 있는 파일 또는 폴더 추가 + (더하기) 아이콘에서만 사용할 수 있습니다. 하지만 언어 문자열 파일이 생성되거나 업로드되면 파일을 폴더로 이동할 수 있습니다. 모델을 현지화하기 위해 언어 문자열 파일을 만들고 Looker의 기본 제공 UI 현지화도 활용하려면 사용자 문서 페이지의 언어 섹션에서 확인할 수 있는 구체적인 언어 코드를 사용하여 문자열 파일의 이름을 지정해야 합니다.
  • Explore 파일을 만들 때 파일 이름 끝에 .explore.lkml 확장자가 있어야 합니다. 파일을 업로드하는 경우 전체 .explore.lkml 확장자를 사용해야 합니다. 일반 LookML 파일 옵션으로 Looker IDE를 사용하여 파일을 만드는 경우, 확장자가 없으면 Looker에서 파일 이름 끝에 .lkml를 추가하지만 파일 이름에 확장자의 .explore 부분을 수동으로 추가해야 합니다. 예를 들어 Looker IDE를 사용하여 flights라는 Explore 파일을 만들려면 flights.explore 또는 flights.explore.lkml를 입력하면 됩니다. 그러면 파일 이름이 flights.explore.lkml로 지정됩니다.

뷰 파일 만들기 관련 고려사항

대부분의 LookML 개발자는 LookML 프로젝트를 데이터베이스의 테이블 세트에서 생성할 때 자동으로 생성되는 하나 이상의 뷰 파일로 시작합니다. 하지만 개발 모드에서 Looker 개발자가 LookML 프로젝트에 뷰 파일을 추가할 수 있는 방법은 이 페이지에 설명된 빈 뷰 파일 만들기 및 파일 업로드 외에도 다양합니다.

새 뷰를 사용하려면 explore 매개변수를 사용하여 모델 파일에 추가하거나 join 매개변수를 사용하여 모델 파일의 기존 Explore에 조인합니다.

기존 데이터베이스 테이블에서 새 뷰 추가

개발 모드에서 기존 데이터베이스 테이블에서 뷰 파일을 만들 수 있습니다.

  1. 프로젝트 내에서 Looker IDE의 프로젝트 파일 목록 상단에 있는 +(더하기)를 선택하여 파일 또는 폴더 추가 메뉴를 선택하거나, 폴더 메뉴를 선택하여 폴더 내에 파일을 만들 수 있습니다.

  2. 테이블에서 뷰 만들기를 선택합니다.

  3. Looker에 연결 중 하나와 연결된 테이블 목록이 표시됩니다. 연결을 변경하려면 왼쪽 상단의 연결 드롭다운을 사용하세요.

  4. 테이블 이름 왼쪽의 체크박스를 선택하여 뷰를 만들 테이블을 선택합니다. 이 목록의 데이터베이스 또는 스키마를 접거나 펼쳐 사용 가능한 모든 테이블에 액세스할 수 있습니다.

  5. 페이지 하단으로 이동하여 뷰 만들기를 선택합니다.

  6. Looker는 모든 테이블 열에 LookML이 포함된 뷰를 생성합니다.

파일 업로드

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

프로젝트에 파일을 업로드하려면 Looker IDE에서 드래그 앤 드롭 기능을 사용하여 다음 단계를 따르세요.

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

파일 및 폴더 삭제

폴더를 삭제하면 폴더 내용도 삭제되므로 폴더를 삭제할 때 주의하세요. 폴더를 삭제하기 전에 다음 단계를 따르세요.

  • 폴더를 삭제하기 전에 폴더의 파일을 삭제할지 또는 파일을 다른 위치로 이동할지 확인합니다.
  • 폴더에 프로젝트의 include 문에 참조된 파일이 없는지 확인합니다. IDE 폴더에서 include를 사용하는 방법에 대한 자세한 내용은 include 매개변수 문서 페이지의 IDE 폴더에서 include 사용 섹션을 참고하세요.

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

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

모델 파일을 삭제해도 모델이 속한 모델 세트에서는 모델이 삭제되지 않습니다. 삭제된 모델과 동일한 이름으로 새 모델 파일을 만들면 삭제된 모델이 포함된 모델 세트에 새 모델이 포함됩니다. 이로 인해 새 모델 파일에 원치 않는 액세스 권한이 부여될 수 있습니다. Looker 관리자는 모델 세트를 수정하고 삭제된 모델을 제거하여 이 문제를 방지할 수 있습니다.

파일 및 폴더 일괄 삭제

폴더를 삭제하면 폴더 내용도 삭제되므로 폴더를 삭제할 때 주의하세요. 폴더를 삭제하기 전에 다음 단계를 따르세요.

  • 폴더를 삭제하기 전에 폴더의 파일을 삭제할지 또는 파일을 다른 위치로 이동할지 확인합니다.
  • 폴더에 프로젝트의 include 문에 참조된 파일이 없는지 확인합니다. IDE 폴더에서 include를 사용하는 방법에 대한 자세한 내용은 include 매개변수 문서 페이지의 IDE 폴더에서 include 사용 섹션을 참고하세요.

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

  1. 파일 브라우저 패널 상단에서 일괄 수정 아이콘을 선택합니다.

  2. 삭제할 항목을 선택합니다. 선택한 파일 수가 파일 선택 헤더 옆에 표시됩니다.

    • 개별 파일을 선택하거나 선택 해제하려면 폴더를 펼치고 파일 이름 옆의 체크박스를 선택합니다.
    • 전체 폴더 및 폴더 콘텐츠를 선택하거나 선택 해제하려면 폴더 이름 옆의 체크박스를 선택합니다.
    • 디렉터리 목록의 전체 섹션을 선택하려면 Shift 키를 누른 채 클릭합니다. 범위 내 최상단에 있는 항목의 체크박스를 선택한 다음 Shift 키를 누른 상태에서 목록의 마지막 항목에 대한 체크박스를 선택합니다. 두 항목과 그 사이의 모든 항목이 선택됩니다. 항목을 Shift 키를 누른 채 클릭하여 디렉터리 목록에서 항목과 그 앞에 있는 모든 항목을 선택할 수도 있습니다.

  3. 항목 삭제 휴지통 아이콘을 선택합니다. 그러면 IDE에서 선택한 항목을 나열하는 대화상자를 표시합니다.

  4. 예, 삭제합니다를 선택하여 삭제할 항목을 확인하거나 취소를 선택하여 항목 선택으로 돌아갑니다.

  5. 파일 선택 헤더에서 X를 선택하여 일괄 수정 모드를 종료합니다.

폴더 내 프로젝트의 항목 이동

파일을 이동하려면 파일 또는 폴더를 다른 폴더로 드래그합니다.

다른 폴더 또는 파일을 수신하기 위해 대상 폴더를 확장하지 않아도 됩니다. 폴더 위로 마우스를 가져가면 폴더가 자동으로 확장됩니다.

파일 경로를 변경할 때는 프로젝트의 include 문을 새 경로와 일치하도록 업데이트해야 합니다. IDE 폴더에서 include를 사용하는 방법에 대한 자세한 내용은 include 매개변수 문서 페이지의 IDE 폴더에서 include 사용 섹션을 참고하세요.

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

파일 및 폴더 일괄 이동

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

  1. 파일 브라우저 패널 상단에서 일괄 수정 아이콘을 선택합니다.

  2. 이동할 항목을 선택합니다. 선택한 파일 수가 파일 선택 헤더 옆에 표시됩니다.

    • 개별 파일을 선택하거나 선택 해제하려면 폴더를 펼치고 파일 이름 옆의 체크박스를 선택합니다.
    • 전체 폴더 및 폴더 콘텐츠를 선택하거나 선택 해제하려면 폴더 이름 옆의 체크박스를 선택합니다.
    • 디렉터리 목록의 전체 섹션을 선택하려면 Shift 키를 누른 채 클릭합니다. 범위 내 최상단에 있는 항목의 체크박스를 선택한 다음 Shift 키를 누른 상태에서 목록의 마지막 항목에 대한 체크박스를 선택합니다. 두 항목과 그 사이의 모든 항목이 선택됩니다. 항목을 Shift 키를 누른 채 클릭하여 디렉터리 목록에서 항목과 그 앞에 있는 모든 파일을 선택할 수도 있습니다.

  3. 항목 이동 폴더 아이콘을 선택하여 옵션을 선택합니다. 그러면 IDE에서 폴더 선택 대화상자를 표시합니다.

  4. 이동 대화상자에서 선택한 항목의 폴더를 선택하거나 새 폴더를 선택하여 새 폴더를 만듭니다. 다음 메뉴 페이지의 상단에서 선택했던 폴더의 경로가 프로젝트 이름에 표시됩니다. 프로젝트의 루트 디렉터리로 항목을 이동하려면 폴더를 선택하지 않고 이동을 선택합니다.

  5. 이동을 선택하여 선택한 대상을 확인하거나, 새 폴더를 선택하여 선택한 폴더 내에 새 폴더를 만들거나, 경로에서 프로젝트 이름 링크를 선택하여 기본 폴더 옵션 메뉴로 돌아갑니다.

  6. 파일 선택 헤더에서 X를 선택하여 일괄 수정 모드를 종료합니다.

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

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