LookML 검증

LookML을 수정하면 Looker IDE는 단일 파일 내에서 해결되지 않은 구문 오류를 알려줍니다(Looker 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개).

LookML 오류(9) 텍스트가 있는 유효성 검사 메시지 예시입니다.

확장된 문제 목록 내에서 유효성 검사가 통과하지 못한 이유를 확인할 수 있습니다. 종종 이 오류를 클릭하면 해당 코드의 문제 행으로 직접 이동하는 경우가 있습니다. 행 옆에 빨간색 'X'가 표시됩니다. 마우스를 가져가면 경우에 따라 더 자세한 오류 정보가 제공됩니다.

값이 없는 유형 매개변수 정의에 마우스를 가져가면 발생하는 오류의 예시로, 유형 값을 제공해야 하는 오류 텍스트가 있습니다.

채팅팀 도움말: 가장 많이 표시되는 유효성 검사 오류는 '알 수 없거나 액세스할 수 없는 필드'입니다. 오류: 알 수 없거나 액세스할 수 없는 필드 권장사항 페이지에서 원인과 해결 방법을 확인합니다.

LookML 경고

LookML 경고로 인해 쿼리가 실행되지 않을 수 있지만 여전히 사용자에게 기능이 손상되거나 의도치 않은 기능이 발생할 수 있습니다. 오류에서와 마찬가지로 괄호 안의 숫자는 발견된 경고의 수입니다(다음 예시에서는 경고 3개).

LookML 경고(3) 텍스트가 있는 유효성 검사 메시지의 예시입니다.

LookML 오류와 마찬가지로, 프로젝트 상태 패널에서 경고를 선택한 다음 빨간색 X 아이콘 위로 마우스를 가져가 자세한 정보를 볼 수 있습니다. 이 방법으로 경고를 확장하고 문제 코드로 이동할 수 있습니다.

Explore 이름이 뷰 이름과 일치해야 하거나 Explore에 from 또는 view_name 속성이 있어야 한다는 텍스트가 있는 경고 예시입니다.

변경사항 배포

변경사항이 제대로 작동하는지 확인한 후 Looker의 Git 통합을 사용하여 변경사항을 프로덕션에 커밋하고 배포할 수 있습니다.