Looker IDE 개요

Looker IDE(통합 개발 환경)는 LookML 프로젝트 파일 및 LookML 프로젝트의 설정에 대한 액세스를 제공합니다.

Looker IDE 액세스

LookML 프로젝트를 보려면 프로젝트에서 하나 이상의 모델에 대한 develop 권한이 있어야 합니다. Looker 기본 탐색 메뉴의 개발 패널을 통해 Looker IDE에 액세스할 수 있습니다.

  1. 탐색 패널에서 개발을 선택하여 개발 패널을 엽니다.
  2. 개발 패널에서 액세스하려는 프로젝트 이름을 선택합니다.

Looker에서 선택한 LookML 프로젝트로 IDE가 열립니다.

또는 Explore에서 또는 객체 브라우저에서 특정 LookML 객체로 IDE를 열 수도 있습니다. 자세한 내용과 기타 옵션은 프로젝트 파일 액세스를 참조하세요.

Looker IDE의 요소

Looker IDE에는 다음과 같은 요소가 있습니다.

  1. 개발 모드 배너: 이 배너는 LookML 파일을 변경하고 인스턴스의 콘텐츠에 미치는 영향을 미리 볼 수 있는 개발 모드에 있음을 나타냅니다. 배너에서 개발 모드 종료 링크를 클릭하여 프로덕션 모드로 전환할 수 있습니다.
  2. IDE 탐색 메뉴: 탐색 메뉴를 사용하여 Looker IDE의 다양한 기능에 액세스합니다. 일부 기능은 개발 모드에서만 사용할 수 있습니다. IDE 탐색 메뉴에서 기능을 선택한 후 탐색 메뉴 항목을 다시 선택하여 기능 패널을 접을 수 있습니다. IDE 탐색 메뉴에서는 다음 IDE 기능에 액세스할 수 있습니다.
    • 파일 브라우저: LookML 프로젝트의 파일 및 폴더에 액세스할 수 있는 파일 브라우저가 열립니다.
    • 객체 브라우저: 프로젝트의 LookML 객체를 표시하고 객체 간의 계층적 관계를 보여주는 객체 브라우저를 엽니다.
    • 찾기 및 바꾸기: 프로젝트에서 찾기 및 바꾸기 페이지가 표시됩니다. 일괄 작업에서 이 페이지를 사용하여 모든 프로젝트 파일에서 텍스트를 검색하여 모든 인스턴스 또는 선택한 인스턴스를 바꿀 수 있습니다.
    • Git 작업: (개발 모드에서만 표시) 프로젝트의 Git 브랜치를 표시하고 프로젝트의 Git 브랜치에 사용할 수 있는 Git 명령어를 표시합니다. LookML 프로젝트에서 Git을 사용하는 방법에 대한 자세한 내용은 버전 제어 및 배포 사용 문서 페이지를 참고하세요.
    • 설정: (개발 모드에서만 표시) 프로젝트의 프로젝트 설정 페이지를 표시합니다. 여기에서 프로젝트 버전 제어 옵션, 가져온 프로젝트의 인증 사용자 인증 정보, 프로젝트에서 사용하는 Git 브랜치, IDE 설정을 구성할 수 있습니다.
    • 배포: (개발 모드에서만 표시) 고급 배포 모드로 설정된 프로젝트의 경우 Deployment Manager가 열립니다. deploy 권한이 있는 개발자는 여기에서 Looker 프로덕션 환경에 커밋 또는 태그를 배포할 수 있습니다.
  3. 기능 패널: 파일 브라우저 및 객체 브라우저의 LookML 파일 및 객체 탐색, 찾기 및 바꾸기 기능의 검색 매개변수, Git 작업 패널에서 사용할 수 있는 Git 명령어, 프로젝트 설정 패널의 다양한 설정에 액세스하는 탭을 제공합니다.
  4. IDE 편집기 패널: LookML 파일의 편집기입니다. IDE 탐색 메뉴에서 파일 브라우저 또는 객체 브라우저를 선택하면 편집기가 표시됩니다. 편집기에 대한 자세한 내용은 Looker IDE 수정 기능을 참조하세요.
  5. 측면 패널 선택기: 옵션을 클릭하여 IDE 측면 패널 기능을 엽니다.
    • 프로젝트 상태: 프로젝트 상태 패널을 엽니다.
    • 빠른 도움말: 메타데이터 패널에 액세스할 수 있는 탭이 포함된 빠른 도움말 패널을 엽니다.
    • 코딩 도우미: (Gemini가 사용 설정된 Looker(Google Cloud 핵심 서비스) 인스턴스의 경우) 코딩 도우미 패널을 엽니다. 측면 패널 선택기 옵션을 다시 한 번 클릭하여 IDE 측면 패널을 숨깁니다.
  6. IDE 측면 패널: 선택한 측면 패널 기능을 표시합니다.
  7. Git 버튼: 프로젝트 상태에 따라 이 버튼에는 프로젝트를 프로덕션으로 전환하기 위해 수행해야 하는 다음 작업이 표시됩니다. 예를 들면 LookML 검증 ,브랜치를 원격으로 푸시 또는 커밋이 있습니다. 버튼을 클릭하여 작업을 수행합니다. 버튼이 표시하고 실행할 수 있는 명령어는 Git 명령어 참조를 확인하세요.

Looker IDE 설정

다음 방법으로 Looker IDE를 맞춤설정할 수 있습니다.

텍스트 편집기 모드

Looker IDE는 다음 세 가지 텍스트 편집기 모드를 지원합니다.

  • Looker IDE 편집기(기본값)
  • Vim
  • Emacs

텍스트 편집기 모드를 변경하려면 다음 단계를 따르세요.

  1. Looker IDE의 왼쪽 탐색창에서 설정 아이콘을 선택합니다.
  2. IDE 설정에서 편집기 탭을 선택합니다.
  3. 텍스트 편집기 모드 풀다운 메뉴를 사용하여 옵션을 선택합니다.

풀다운 메뉴에서 옵션을 선택하면 선택한 텍스트 편집기 모드를 사용하도록 Looker IDE가 즉시 업데이트됩니다.

줄바꿈 모드

기본적으로 Looker IDE는 줄바꿈을 사용 설정합니다.

줄바꿈을 사용 설정 또는 사용 중지하려면 다음 안내를 따르세요.

  1. Looker IDE의 왼쪽 탐색창에서 설정 아이콘을 선택합니다.
  2. IDE 설정에서 편집기 탭을 선택합니다.
  3. IDE에서 줄바꿈을 사용 설정 또는 중지하려면 줄바꿈 모드 전환 버튼을 사용합니다.

전환 버튼을 변경하면 업데이트가 Looker IDE에 적용됩니다.

IDE 측면 패널 크기 조절

IDE에서는 파일 브라우저, 객체 브라우저, Git 작업 패널을 포함하는 기능 패널과 프로젝트 상태, 빠른 도움말, 메타데이터 패널을 포함하는 측면 패널의 너비를 모두 변경할 수 있습니다.

IDE 패널 크기를 조절하려면 커서를 패널 테두리 위에 놓고 드래그하여 패널 크기를 조절합니다.

개발 모드의 경우에는 IDE에서 로그인 및 새로고침을 수행할 때 측면 패널의 크기가 유지됩니다.

IDE 측면 패널 접기

IDE 편집기 패널의 너비를 최대화하려면 IDE 측면 패널을 접으세요.

  • IDE 기능 패널을 표시하거나 숨기려면 단축키 Command-B(Mac) 또는 Ctrl+B(Windows)를 사용하거나 이미 선택된 IDE 탐색 메뉴에서 아이콘을 클릭합니다.
  • IDE 측면 패널을 표시하거나 숨기려면 측면 패널 선택기에서 이미 선택된 아이콘을 클릭합니다.

Looker IDE 편집 기능

다음 섹션에서는 LookML로 개발하는 데 도움이 되는 몇 가지 Looker IDE 편집 기능을 설명합니다.

자동 추천

입력과 동시에 IDE는 입력하는 컨텍스트에 민감한 매개변수와 사용 가능한 값을 제안합니다. 예를 들어 측정기준의 type 매개변수에 대한 추천에는 해당 매개변수에 유효한 옵션만 포함됩니다. 또한 sql 매개변수의 필드는 ${...}로 표시되어야 하므로 IDE는 필드를 제안할 때 해당 구문을 추가합니다.

자동 제안은 표시될 수 있는 모든 곳에 자동으로 표시됩니다. 닫으려면 키보드에서 Esc 키를 누릅니다. 특정 시점을 확인하려면 Ctrl+Space(Windows) 또는 Control-Space(Mac) 키를 누릅니다.

임시 오류 확인

IDE는 입력할 때 구문 오류를 포착합니다. 여백에서 빨간색 X는 구문 오류를 나타내며 빨간색 밑줄로 표시됩니다. 빨간색 X 위에 커서를 놓으면 문제에 대한 간단한 설명이 표시됩니다. 예를 들어 측정 시 type 매개변수 값으로 average 대신 실수로 avrage를 입력한 경우 IDE에는 Invalid value for "type":avrage 오류가 표시됩니다.

전체 모델 유효성 검사를 수행하려면 LookML 검사기가 여전히 필요합니다. 누락된 조인으로 인해 발생하는 잘못된 필드 참조와 같은 일부 오류는 모델을 전체적으로 확인해야 하므로 LookML 검사기가 실행될 때만 표시됩니다.

자동 형식 지정

개발 모드에서는 형식 파일 단축키를 사용하여 LookML 파일을 자동으로 들여쓰기할 수 있습니다. 들여쓰기는 매개변수와 하위 매개변수의 계층 구조를 나타내므로 LookML이 더 쉽게 읽고 이해할 수 있습니다.

접이식

파일의 각 최상위 LookML 매개변수 시작 부분 옆에 있는 여백에 작은 화살표가 표시됩니다. 이 화살표를 선택하면 LookML의 해당 섹션이 접히거나 펼쳐져 특정 섹션에만 집중할 수 있습니다.

LookML 파일의 파일 작업 보기 메뉴는 현재 파일 내 상위 수준 매개변수까지 모든 LookML 섹션을 확장하거나 축소할 수 있는 LookML 접기LookML 펼치기 옵션을 제공합니다.

단축키를 사용하여 LookML을 접거나 펼칠 수도 있습니다.

댓글

LookML에 주석을 추가하여 더 읽기 쉽게 만들 수 있습니다. 단일 주석을 추가하려면 # 문자를 사용합니다.

dimension: name {
  sql: ${TABLE}.name ;; # This is the customer's full name
}

다음 단계를 수행하면 단축키를 사용하여 전체 코드 블록을 주석 처리할 수 있습니다.

  1. 주석 처리할 행을 선택합니다.
  2. Command + /(Mac) 또는 Ctrl + /(Windows)를 누릅니다.

IDE가 선택한 각 줄에 # 문자를 추가합니다.

SQL 블록 주석 처리

전적으로 SQL 코드 블록 내에 있는 줄을 주석 처리하는 경우 SQL 주석 표기법을 수동으로 추가합니다.

SQL 주석 블록을 사용하는 경우에도 주석 처리된 섹션은 LookML 코드로 계속 해석됩니다. 따라서 LookML에서 생성된 SQL 내에 주석이 표시되지만 쿼리 결과에 영향을 주지 않습니다.

추가, 변경, 삭제 보기

LookML IDE에서는 개발 모드에 있고 커밋되지 않은 변경사항이 있으면 항상 여러 표시기가 표시됩니다.

  • 파일 이름이 창 왼쪽에 파란색 점으로 표시되며 새 파일, 변경된 파일 또는 이름이 변경된 파일임을 나타냅니다.
  • 새 파일이나 변경된 파일을 열면 파일 내의 줄 번호가 녹색으로 강조표시되어 새 줄 또는 변경된 줄을 표시하고 빨간색 가로 선은 삭제된 줄을 나타냅니다.

IDE 상태 지속성

개발 모드에서는 Looker IDE에서 새로고침 및 로그인 시에도 IDE 상태고 유지됩니다. IDE 상태에는 다음이 포함됩니다.

  • IDE 탐색 메뉴에서 선택한 항목(예: 파일 브라우저, Git 작업, 객체 브라우저, 프로젝트 설정)
  • 파일 브라우저에 표시되는 LookML 파일 열기
  • 파일 브라우저 및 객체 브라우저의 항목 펼치기 또는 접기 상태
  • IDE 측면 패널의 너비
  • IDE의 오른쪽 사이드바에서 선택한 항목(예: 빠른 도움말 패널, 메타데이터 패널, 프로젝트 상태 패널)
  • 편집기의 줄바꿈 모드

IDE를 기본값으로 재설정하려면 Looker IDE의 왼쪽 탐색 창에서 설정 아이콘을 선택하고 IDE 설정 섹션에서 편집기 탭을 선택한 다음 IDE 레이아웃 재설정 버튼을 클릭합니다. 계속해서 파일을 열고 선택하면 IDE에서 상태가 다시 유지됩니다.

객체 또는 파일로 바로 이동

Looker IDE에서 객체 또는 파일로 바로 이동 기능을 사용하여 LookML 객체 및 프로젝트 파일로 직접 이동할 수 있습니다. 파일 브라우저 또는 객체 브라우저에서 객체 또는 파일로 바로 이동 아이콘을 클릭하거나 단축키 Command-J(Mac) 또는 Ctrl+J(Windows)를 사용합니다.

자세한 내용은 LookML 프로젝트 파일 액세스 문서 페이지를 참조하세요.

빠른 도움말 패널

빠른 도움말 아이콘을 선택하여 코드의 현재 위치에 대한 설명과 옵션을 제공하는 빠른 도움말 패널을 엽니다. 사이드바에서 매개변수 이름을 선택하여 해당 매개변수의 Looker 문서 페이지를 엽니다.

코딩 도우미 패널

Gemini가 사용 설정된 Looker(Google Cloud 핵심 서비스) 인스턴스가 있는 경우 Looker의 Gemini를 사용하여 LookML을 작성할 수 있습니다.

코딩 도우미 아이콘이 강조 표시된 Looker IDE

자세한 내용은 Looker의 Gemini 지원으로 LookML 작성 문서를 참조하세요.

파일 및 폴더의 옵션 메뉴

파일 브라우저의 왼쪽 패널에 있는 각 파일이나 폴더에는 해당 항목에 사용 가능한 작업을 표시하는 메뉴가 있습니다. 파일 및 폴더 위로 커서를 가져간 다음 점 3개로 된 폴더 옵션 메뉴(폴더의 경우) 또는 파일 옵션 메뉴(파일의 경우)를 선택하여 메뉴를 엽니다. 긴 이름이 있거나 여러 폴더에 중첩된 항목의 경우 파일 브라우저 패널에서 옆으로 스크롤하여 메뉴에 액세스할 수 있습니다.

옵션 메뉴에서 파일 브라우저를 사용하여 폴더와 파일을 만들고, 파일을 업로드하며, 파일과 폴더를 삭제하고 이동할 수 있습니다. 자세한 내용은 LookML 파일 및 폴더 관리 문서 페이지를 참조하세요.

폴더로 LookML 파일을 구성할 때 다른 Looker 개발자가 볼 수 있도록 변경사항을 커밋하고 프로덕션에 배포해야 합니다. 이는 LookML 프로젝트를 변경하는 것과 같습니다.

프로젝트에서 텍스트 찾기 및 바꾸기

Looker IDE에는 찾기 및 바꾸기 함수가 있어, 이를 사용하면 모든 프로젝트 파일에서 텍스트를 검색한 다음 모든 인스턴스 또는 선택한 인스턴스를 일괄 작업으로 교체할 수 있습니다.

Looker IDE 찾기 함수를 사용하려면 다음 단계를 수행합니다.

  1. IDE의 검색 패널로 이동합니다.
  2. 찾기 입력란에 검색어를 입력합니다.
  3. 원하는 경우 대소문자 구분을 선택하여 찾기 필드에서 입력한 인스턴스와 일치하는 인스턴스만 검색하거나 정규식을 선택하여 정규 표현식 검색을 수행할 수 있습니다.
  4. 찾기를 선택합니다.
  5. 원하는 경우 파일 이름을 선택하여 IDE에서 파일을 열 수 있습니다.

개발 모드인 경우 바꾸기 필드도 보입니다. 프로젝트에서 텍스트를 바꾸려면 다음 단계를 수행합니다.

  1. 바꾸기 필드에 대체 텍스트를 입력합니다. 바꾸기 필드에서 텍스트를 바꾸는 대신 삭제하려면 바꾸기 필드를 비워 두면 됩니다.

  2. 선택 및 교체를 선택하여 프로젝트에서 텍스트가 대체되는 방법을 미리 봅니다.

  3. 프로젝트에서 교체할 모든 인스턴스가 강조표시됩니다. 다음 옵션을 사용하여 대체할 인스턴스를 맞춤설정할 수 있습니다.

    • 결과 요약 옆의 체크박스를 사용하여 전체 프로젝트에서 모든 인스턴스를 선택하거나 선택 해제합니다.
    • 단일 인스턴스 옆에 있는 체크박스를 사용하여 인스턴스를 선택하거나 선택 해제합니다.
  4. 선택한 항목 교체 버튼을 선택하여 선택한 인스턴스에 대체 항목을 적용합니다. IDE에 변경사항이 표시됩니다.

새 필드 만들기 및 테스트

LookML을 편집하기 위한 예시로 여러 필드를 추가한 다음 테스트합니다.

측정기준 만들기

먼저 사용자가 캘리포니아 출신인지 또는 뉴욕 출신인지 확인하는 새 측정기준을 users 뷰에 추가합니다. 측정기준은 type: yesno입니다. 즉, 사용자가 캘리포니아 또는 뉴욕 출신인 경우 를 반환하고, 그렇지 않으면 아니요를 반환합니다.

새 측정기준의 LookML은 다음과 같습니다.

dimension: from_ca_or_ny {
  type: yesno
  sql: ${TABLE}.state = "California" OR ${TABLE}.state = "New York" ;;
}

이 측정기준을 user 뷰 파일에 추가한 후 파일에서 변경사항 저장 버튼을 클릭합니다.

${TABLE}.state에 대한 자세한 내용은 대체 연산자를 참조하세요.

측정값 만들기

다음으로 user 뷰에 사용자의 연령 평균을 나타내는 새 측정값을 추가합니다. 이 측정값은 type: average이며 age 열에 대해 집계됩니다.

이 새로운 측정의 LookML은 다음과 같습니다.

measure: average_age {
  type: average
  sql: ${TABLE}.age ;;
}

이 측정값을 user 뷰 파일에 추가한 후 파일에서 변경사항 저장 버튼을 클릭합니다.

Explore에서 필드 테스트

쿼리하여 새 측정기준을 테스트하고 측정할 수 있습니다. 변경사항을 저장하면 이러한 필드가 Explore의 필드 선택 도구에 표시됩니다. 보기 파일 이름 옆에 있는 파일 작업 보기 드롭다운 메뉴를 사용하면 현재 뷰의 Explore에 액세스할 수 있습니다. 파일 작업 보기 드롭다운 메뉴에는 뷰가 조인된 Explore를 포함하여 뷰를 기반으로 하는 모든 Explore가 나열됩니다. 예를 들어 users라는 뷰에 대한 Explore에 액세스하려면 파일 작업 보기 드롭다운 메뉴에서 사용자 Explore 옵션을 선택합니다.

사용자 Explore에서 쿼리에 추가할 새 필드를 선택할 수 있습니다. 예를 들어 캘리포니아와 뉴욕의 평균 사용자 연령과 그렇지 않은 사용자의 평균 연령을 표시하는 새 필드를 모두 사용하여 쿼리를 만들 수 있습니다.

CA 또는 NY(예/아니요)의 사용자 필드와 사용자 평균 연령 필드가 선택된 사용자 Explore 샘플의 데이터 테이블입니다.