지속적 통합 어설션 검사기

연속 통합 (CI) Assert 검사기는 LookML 프로젝트에서 Looker 개발자가 만든 LookML 데이터 테스트를 실행하고 각 데이터 테스트의 결과를 표시합니다. 실패한 데이터 테스트의 경우 Assert 검사기에 오류가 표시됩니다.

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

  • 지난해 5월의 수익은 204,259달러(US)여야 합니다.
  • 전환율은 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 검사기 옵션 섹션을 참고하세요. Assert 검사기 실행에 대한 자세한 내용은 연속 통합 모음 실행 문서 페이지를 참고하세요.

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

어설트 유효성 검사기 발견 항목을 보여주는 지속적 통합 결과 페이지

Assert 검사기 옵션

연속 통합 모음을 만들거나 수정할 때 Assert 검사기 실행 방식을 구성하기 위해 지정할 수 있는 몇 가지 옵션이 있습니다. 옵션은 이 페이지의 다음 섹션에 설명되어 있습니다.

쿼리할 Explore

기본적으로 Assert 검사기는 LookML 프로젝트의 각 데이터 테스트를 실행합니다.

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

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

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

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

제외할 Explore

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

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

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

쿼리 동시 실행

기본적으로 Assert 검사기는 Looker 인스턴스에 과부하가 걸리지 않도록 한 번에 10개 이하의 쿼리를 실행합니다. 쿼리 동시 실행 필드를 사용하여 Assert 검사기가 동시에 실행할 수 있는 최대 쿼리 수를 지정할 수 있습니다.

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

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