지속적 통합 (CI) 어설션 검사기는 LookML 프로젝트에서 Looker 개발자가 만든 LookML 데이터 테스트를 실행하고 각 데이터 테스트의 결과를 표시합니다. 실패한 데이터 테스트의 경우 어설트 검사기에 오류가 표시됩니다.
LookML 데이터 테스트를 사용하면 Looker 모델의 논리를 검증할 수 있습니다. 데이터 테스트는 다음과 같은 복잡한 가정을 테스트할 수 있습니다.
- 전년도 5월의 수익은 204,259달러여야 합니다.
- 전환율은 0보다 커야 합니다.
- 주문 상태는 null이 아니어야 합니다.
LookML 데이터 테스트는 다음 예와 같이 작은 explore_source 쿼리와 yesno assert 표현식으로 구성됩니다.
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 검사기 옵션
지속적 통합 스위트를 만들거나 수정할 때 어설트 유효성 검사기 실행 방식을 구성하기 위해 지정할 수 있는 몇 가지 옵션이 있습니다. 옵션은 이 페이지의 다음 섹션에 설명되어 있습니다.
쿼리할 Explore
기본적으로 어설션 검사기는 LookML 프로젝트의 각 데이터 테스트를 실행합니다.
데이터 테스트는 프로젝트의 Explore를 가리키는 explore_source 매개변수를 사용하여 정의되며, Explore를 쿼리 필드를 사용하여 데이터 테스트의 기반이 되는 특정 Explore로 어설션 유효성 검사를 제한할 수 있습니다.
다음 형식으로 Explore를 지정할 수 있습니다. model_name/explore_name
예를 들어 thelook.model.lkml 파일에서 users 및 orders라는 Explore를 지정하려면 thelook/users, thelook/orders를 입력합니다.
이 필드에서 Explore 및 모델을 지정하는 방법과 예시에 대한 자세한 내용은 SQL 검사기 문서 페이지를 참고하세요.
제외할 Explore
기본적으로 어설션 검사기는 LookML 프로젝트의 각 데이터 테스트를 실행합니다. 제외할 Explore 필드를 사용하여 데이터 테스트의 기반이 되는 특정 Explore를 어설션 검사에서 제외할 수 있습니다. 어설트 유효성 검사기는 제외된 탐색 분석을 기반으로 하는 데이터 테스트를 실행하지 않습니다.
다음 형식으로 Explore를 지정할 수 있습니다. model_name/explore_name
이 필드에서 Explore 및 모델을 지정하는 방법과 예시에 대한 자세한 내용은 SQL 검사기 문서 페이지를 참고하세요.
쿼리 동시 실행
기본적으로 어설트 검사기는 Looker 인스턴스에 과부하가 걸리지 않도록 한 번에 10개 이하의 쿼리를 실행합니다. 쿼리 동시 실행 필드를 사용하여 Assert Validator가 동시에 실행할 수 있는 최대 쿼리 수를 다르게 지정할 수 있습니다.
쿼리 동시 실행 필드의 최대값은 데이터베이스 연결의 이 연결의 최대 동시 쿼리 수 설정으로 제한됩니다.
어설션 유효성 검사를 실행하는 동안 Looker 인스턴스가 느려지는 경우 이 값을 줄일 수 있습니다.