IDE 사용
이 페이지에서는 LookML을 작성하는 데 도움이 되는 몇 가지 Looker IDE 기능에 대해 설명합니다.
Looker 개발 메뉴를 통해 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 검사기가 실행될 때만 표시됩니다.
빠른 도움말 패널
빠른 도움말 아이콘을 선택하여 코드의 현재 위치에 대한 설명과 옵션을 제공하는 빠른 도움말 패널을 엽니다. 사이드바에서 매개변수 이름을 선택하여 해당 매개변수의 Looker 문서 페이지를 엽니다.
자동 형식 지정
개발 모드에서는 형식 파일 단축키를 사용하여 LookML 파일을 자동으로 들여쓰기할 수 있습니다. 들여쓰기는 매개변수와 하위 매개변수의 계층 구조를 나타내므로 LookML이 더 쉽게 읽고 이해할 수 있습니다.
접이식
파일의 각 최상위 LookML 매개변수 시작 부분 옆에 있는 여백에 작은 화살표가 표시됩니다. 이 화살표를 선택하면 LookML의 해당 섹션이 접히거나 펼쳐져 특정 섹션에만 집중할 수 있습니다.
LookML 파일의 파일 작업 보기 메뉴는 현재 파일 내 상위 수준 매개변수까지 모든 LookML 섹션을 확장하거나 축소할 수 있는 LookML 접기 및 LookML 펼치기 옵션을 제공합니다.
단축키를 사용하여 LookML을 접거나 펼칠 수도 있습니다.
추가, 변경, 삭제 표시
LookML IDE에서는 개발 모드에 있고 커밋되지 않은 변경사항이 있으면 항상 여러 표시기가 표시됩니다.
- 파일 이름이 창 왼쪽에 파란색 점으로 표시되며 새 파일, 변경된 파일 또는 이름이 변경된 파일임을 나타냅니다.
- 새 파일이나 변경된 파일을 열면 파일 내의 줄 번호가 녹색으로 강조표시되어 새 줄 또는 변경된 줄을 표시하고 빨간색 가로 선은 삭제된 줄을 나타냅니다.
주석 추가
LookML에 주석을 추가하여 더 읽기 쉽게 만들 수 있습니다. 단일 주석을 추가하려면 # 문자를 사용합니다.
dimension: name {
sql: ${TABLE}.name ;; # This is the customer's full name
}
다음 단계에 따라 단축키를 사용하여 전체 코드 블록을 주석 처리할 수 있습니다.
- 주석 처리할 행을 선택합니다.
- Command + /(Mac) 또는 Ctrl + /(Windows)를 누릅니다.
IDE가 선택한 각 줄에 # 문자를 추가합니다.
SQL 블록 주석 처리
전적으로 SQL 코드 블록 내에 있는 줄을 주석 처리하는 경우 SQL 주석 표기법을 수동으로 추가합니다.
SQL 주석 블록을 사용하는 경우에도 주석 처리된 섹션은 LookML 코드로 계속 해석됩니다. 따라서 LookML에서 생성된 SQL 내에 주석이 표시되지만 쿼리 결과에 영향을 주지 않습니다.
객체 또는 파일로 바로 이동
Looker IDE에서 객체 또는 파일로 바로 이동 기능을 사용하여 LookML 객체 및 프로젝트 파일로 직접 이동할 수 있습니다. 파일 브라우저 또는 객체 브라우저에서 객체 또는 파일로 바로 이동 아이콘을 클릭하거나 단축키 Command-J(Mac) 또는 Ctrl+J(Windows)를 사용합니다.
자세한 내용은 LookML 프로젝트 파일 액세스 문서 페이지를 참조하세요.
프로젝트에서 텍스트 찾기 및 바꾸기
Looker IDE에는 찾기 및 바꾸기 함수가 있어, 이를 사용하면 모든 프로젝트 파일에서 텍스트를 검색한 다음 모든 인스턴스 또는 선택한 인스턴스를 일괄 작업으로 교체할 수 있습니다.
Looker IDE 찾기 함수를 사용하려면 다음 단계를 따르세요.
- IDE의 검색 패널로 이동합니다.
- 찾기 입력란에 검색어를 입력합니다.
- 원하는 경우 대소문자 구분을 선택하여 찾기 필드에서 입력한 인스턴스와 일치하는 인스턴스만 검색하거나 정규식을 선택하여 정규 표현식 검색을 수행할 수 있습니다.
- 찾기를 선택합니다.
- 원하는 경우 파일 이름을 선택하여 IDE에서 파일을 열 수 있습니다.
개발 모드인 경우 바꾸기 필드도 보입니다. 프로젝트에서 텍스트를 바꾸려면 다음 단계를 따르세요.
바꾸기 필드에 대체 텍스트를 입력합니다. 바꾸기 필드에서 텍스트를 바꾸는 대신 삭제하려면 바꾸기 필드를 비워 두면 됩니다.
선택 및 교체를 선택하여 프로젝트에서 텍스트가 대체되는 방법을 미리 봅니다.
프로젝트에서 교체할 모든 인스턴스가 강조표시됩니다. 다음 옵션을 사용하여 대체할 인스턴스를 맞춤설정할 수 있습니다.
- 결과 요약 옆의 체크박스를 사용하여 전체 프로젝트에서 모든 인스턴스를 선택하거나 선택 해제합니다.
- 단일 인스턴스 옆에 있는 체크박스를 사용하여 인스턴스를 선택하거나 선택 해제합니다.
선택한 항목 교체 버튼을 선택하여 선택한 인스턴스에 대체 항목을 적용합니다. 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에서 쿼리에 추가할 새 필드를 선택할 수 있습니다. 예를 들어 캘리포니아와 뉴욕의 평균 사용자 연령과 그렇지 않은 사용자의 평균 연령을 표시하는 새 필드를 모두 사용하여 쿼리를 만들 수 있습니다.
LookML 유효성 검사
업데이트에 만족하면 변경사항을 저장할 수 있습니다. IDE는 단일 파일 내에서 해결되지 않은 구문 오류를 알려줍니다.
다음으로 LookML 검사기를 사용하여 전체 모델 유효성 검사를 수행합니다. 조인 누락으로 인한 잘못된 필드 참조와 같은 일부 오류는 모델을 전체적으로 확인해야 하므로 LookML 검사기가 실행될 때만 표시됩니다. 프로덕션 환경에 게시하기 전에 LookML 변경사항의 유효성을 검사해야 합니다. 유효성 검사는 데이터베이스 권한 문제와 같은 모든 문제를 포착하지는 못하지만 대부분의 오류를 방지합니다.
LookML 검사기는 마지막 LookML 유효성 검사 후 업데이트된 LookML 파일 또는 업데이트의 영향을 받는 파일만 스캔합니다.
- 모델 수준 설정이 변경되면 모든 것이 다시 검사됩니다.
- 뷰가 변경되면 이를 사용하는 Explore만 다시 검사됩니다.
- Explore가 변경되면 해당 Explore만 다시 검사됩니다.
유효성 검사 실행
LookML 검사기를 실행하려면 Looker IDE 오른쪽 상단의 LookML 유효성 검사 버튼을 선택하거나 IDE 상단에서 프로젝트 상태 아이콘을 선택하여 프로젝트 상태 패널을 연 다음 LookML 유효성 검사 아이콘을 클릭합니다.
LookML 검사기를 실행한 후 해결해야 하는 오류 및 기타 경고 목록이 표시될 수 있습니다. 화살표를 선택하여 오류 또는 경고 목록을 펼칠 수 있습니다.
다른 변경사항을 적용한 후 프로젝트 상태 패널의 검사기 버튼을 다시 사용할 수 있게 됩니다.
유효성 검사 메시지
LookML에서 유효성 검사를 실행한 후 Looker에서 유효성 검사 메시지를 표시합니다.
LookML 오류를 찾을 수 없음
검사기에서 발견된 문제가 없으면 Looker는 LookerML 오류를 찾을 수 없음 텍스트와 함께 녹색 체크표시를 표시합니다.
LookML 오류
LookML 오류는 쿼리가 실행되지 못하도록 하는 문제입니다. 괄호 안의 숫자는 발견된 오류 수입니다(다음 예시에서는 9개).
확장된 문제 목록 내에서 유효성 검사가 통과하지 못한 이유를 확인할 수 있습니다. 종종 이 오류를 클릭하면 해당 코드의 문제 행으로 직접 이동하는 경우가 있습니다. 행 옆에 빨간색 'X'가 표시됩니다. 마우스를 가져가면 경우에 따라 더 자세한 오류 정보가 제공됩니다.
채팅팀 도움말: 가장 많이 표시되는 유효성 검사 오류는 '알 수 없거나 액세스할 수 없는 필드'입니다. 오류: 알 수 없거나 액세스할 수 없는 필드 권장사항 페이지에서 원인과 해결 방법을 확인합니다.
LookML 경고
LookML 경고로 인해 쿼리가 실행되지 않을 수 있지만 여전히 사용자에게 기능이 손상되거나 의도치 않은 기능이 발생할 수 있습니다. 오류에서와 마찬가지로 괄호 안의 숫자는 발견된 경고의 수입니다(다음 예시에서는 경고 3개).
LookML 오류와 마찬가지로, 프로젝트 상태 패널에서 경고를 선택한 다음 빨간색 X 아이콘 위로 마우스를 가져가 자세한 정보를 볼 수 있습니다. 이 방법으로 경고를 확장하고 문제 코드로 이동할 수 있습니다.
변경사항 배포
변경사항이 제대로 작동하는지 확인한 후 Looker의 Git 통합을 사용하여 변경사항을 프로덕션에 커밋하고 배포할 수 있습니다.