지속적 통합 어설션 검사기

지속적 통합 (CI) 어설션 검사기는 Looker 개발자가 LookML 프로젝트에서 만든 LookML 데이터 테스트를 실행하고 각 데이터 테스트의 결과를 표시합니다. 데이터 테스트가 실패하면 어설션 검사기에서 오류를 표시합니다.

LookML 데이터 테스트를 사용하면 Looker 모델의 로직을 검증할 수 있습니다. 데이터 테스트는 다음과 같은 복잡한 가정을 테스트할 수 있습니다.

  • 작년 5월의 수익은 204,259달러여야 합니다.
  • 전환율은 0보다 커야 합니다.
  • 주문 상태는 null이 아니어야 합니다.

LookML 데이터 테스트는 작은 explore_source 쿼리와 yesno 어설션 표현식으로 구성됩니다(예: 다음 예 참고).

test: historic_revenue_is_accurate {
  explore_source: orders {
    column: total_revenue { field: orders.total_revenue }
    filters: [orders.created_date: "2024"]
  }
  assert: revenue_is_expected_value {
    expression: ${orders.total_revenue} = 626000 ;;
  }
}

CI 모음을 만들거나 수정할 때 구성할 수 있는 옵션에 관한 자세한 내용은 이 페이지의 Assert Validator 옵션 섹션을 참고하세요. 어설션 검사기 실행에 관한 자세한 내용은 지속적 통합 모음 실행 문서 페이지를 참고하세요.

실행 결과 페이지에서 어설션 검사기에는 각 데이터 테스트의 결과가 표시됩니다. 실패한 데이터 테스트의 경우 어설션 검사기에서 다음과 같이 오류를 표시합니다.

어설션 검사기 결과를 보여주는 지속적 통합 결과 페이지

어설션 검사기 옵션

CI 모음을 만들거나 수정할 때 Assert Validator 실행 방식을 구성하는 데 사용할 수 있는 몇 가지 옵션이 있습니다. 옵션은 이 페이지의 다음 섹션에 설명되어 있습니다.

탐색할 쿼리

기본적으로 어설션 검사기는 LookML 프로젝트에서 각 데이터 테스트를 실행합니다.

데이터 테스트는 프로젝트의 Explore를 가리키는 explore_source 매개변수를 사용하여 정의되며, 쿼리할 Explore 필드를 사용하여 데이터 테스트의 기반이 되는 특정 Explore로 어설션 유효성 검사를 제한할 수 있습니다.

Explore는 다음 형식으로 지정할 수 있습니다. model_name/explore_name

예를 들어 thelook.model.lkml 파일에서 usersorders라는 Explore를 지정하려면 다음을 입력합니다. thelook/users, thelook/orders

이 필드에서 Explore 및 모델을 지정하는 방법에 관한 자세한 내용과 예시는 SQL 검사기 문서 페이지를 참고하세요.

제외할 Explore

기본적으로 어설션 검사기는 LookML 프로젝트에서 각 데이터 테스트를 실행합니다. 제외할 Explore 필드를 사용하여 데이터 테스트의 기반이 되는 특정 Explore를 어설션 유효성 검사에서 제외할 수 있습니다. 어설션 검사기는 이러한 제외된 탐색 분석을 기반으로 하는 데이터 테스트를 실행하지 않습니다.

Explore는 다음 형식으로 지정할 수 있습니다. model_name/explore_name

이 필드에서 Explore 및 모델을 지정하는 방법에 관한 자세한 내용과 예시는 SQL 검사기 문서 페이지를 참고하세요.

쿼리 동시 실행

기본적으로 어설션 검사기는 Looker 인스턴스의 과부하를 방지하기 위해 한 번에 10개 이하의 쿼리를 실행합니다. 쿼리 동시 실행 필드를 사용하여 Assert 검사기가 동시에 실행할 수 있는 최대 쿼리 수를 다르게 지정할 수 있습니다.

쿼리 동시 실행 필드의 최대 값은 데이터베이스 연결의 이 연결의 최대 동시 쿼리 수 설정으로 제한됩니다.

어설션 유효성 검사를 실행하는 동안 Looker 인스턴스가 느려지면 이 값을 줄일 수 있습니다.