지속적 통합 (CI) 콘텐츠 검사기는 오류가 있는 대시보드와 Look을 식별합니다. 이러한 오류는 LookML 필드 참조가 누락되어 발생하는 경우가 많습니다.
CI 콘텐츠 검사기는 표준 Looker 콘텐츠 검사기와 유사한 유효성 검사를 실행하지만 몇 가지 차이점이 있습니다.
CI 콘텐츠 검사기는 다음을 지원합니다.
- Looker 개발자가 LookML 저장소에 pull 요청을 제출할 때 자동으로 실행되도록 CI 콘텐츠 검사기를 구성하거나 CI 모음을 수동으로 실행할 때 수동으로 실행되도록 구성할 수 있습니다.
- CI 콘텐츠 검사기 결과의 범위를 특정 Looker 콘텐츠 폴더 또는 LookML 프로젝트의 특정 모델 및 Explore로 제한할 수 있습니다. 기본적으로 CI 콘텐츠 검사기의 결과는 LookML 프로젝트로 자동 범위가 지정됩니다. CI 콘텐츠 검사기 범위 지정은 후처리입니다. 검사기는 전체 Looker 인스턴스에서 실행된 후 CI 모음을 만들 때 지정한 범위로 결과를 필터링합니다.
표준 Looker 콘텐츠 검사기는 다음을 지원합니다.
- Looker 콘텐츠 검사기는 수동으로만 실행할 수 있습니다.
- Looker 콘텐츠 검사기의 범위를 특정 Looker 콘텐츠 폴더 또는 특정 LookML 프로젝트로 지정할 수 있습니다. Looker 콘텐츠 검사기 범위 지정은 검사 전에 이루어집니다. 검사기는 콘텐츠 검사를 시작할 때 지정한 폴더와 프로젝트에서만 실행됩니다.
- Looker 콘텐츠 검사기를 사용하여 필드, 뷰, Explore, 모델 이름을 바꾸고, 필드를 삭제하고, Look을 삭제할 수 있습니다.
CI 모음을 만들거나 수정할 때 구성할 수 있는 옵션에 관한 자세한 내용은 이 페이지의 콘텐츠 검사기 옵션 섹션을 참고하세요. 콘텐츠 검사기 실행에 관한 자세한 내용은 지속적 통합 모음 실행 문서 페이지를 참고하세요.
실행 결과 페이지에서 콘텐츠 검사기는 오류가 있는 각 Look 또는 대시보드의 오류 메시지와 콘텐츠 링크를 제공합니다.
콘텐츠 검사기 옵션
CI 모음을 만들 때 콘텐츠 검사기 실행 방식을 구성하는 여러 옵션을 지정할 수 있습니다. 옵션은 이 페이지의 다음 섹션에 설명되어 있습니다.
탐색할 쿼리
기본적으로 콘텐츠 검사기는 LookML 프로젝트의 모든 모델 및 Explore에서 콘텐츠 유효성 검사를 실행합니다.
Explores to query 필드를 사용하여 콘텐츠 검사에 포함할 Explore 및 모델을 지정할 수 있습니다.
Explore는 다음 형식으로 지정할 수 있습니다. model_name/explore_name
예를 들어 thelook.model.lkml 파일에서 users 및 orders라는 Explore를 지정하려면 다음을 입력합니다. thelook/users, thelook/orders
이 필드에서 Explore 및 모델을 지정하는 방법에 관한 자세한 내용과 예시는 SQL 검사기 문서 페이지를 참고하세요.
제외할 Explore
기본적으로 콘텐츠 검사기는 LookML 프로젝트의 모든 모델과 Explore에서 콘텐츠 유효성 검사를 실행합니다.
제외할 Explore 필드를 사용하여 콘텐츠 검사에서 제외할 Explore 및 모델을 지정할 수 있습니다.
Explore는 다음 형식으로 지정할 수 있습니다. model_name/explore_name
이 필드에서 Explore 및 모델을 지정하는 방법에 관한 자세한 내용과 예시는 SQL 검사기 문서 페이지를 참고하세요.
검사할 폴더
폴더 ID 또는 쉼표로 구분된 폴더 ID 목록을 지정하여 Looker 인스턴스의 특정 콘텐츠 폴더로 콘텐츠 검사 범위를 지정할 수 있습니다.
폴더의 ID를 가져오려면 Looker 기본 탐색 메뉴를 사용하여 폴더를 연 다음 브라우저 URL에서 폴더 ID를 가져옵니다. 폴더 ID는 URL의 마지막 요소입니다. 예를 들어 다음 URL에서 폴더 ID는 45입니다.
https://myinstance.looker.com/folders/45
제외할 폴더
제외할 폴더 필드에 폴더 ID 또는 쉼표로 구분된 폴더 ID 목록을 지정하여 콘텐츠 검사에서 특정 콘텐츠 폴더를 제외할 수 있습니다.
개인 공간의 콘텐츠 제외
콘텐츠 검사기에서 공유 폴더의 콘텐츠만 검사하도록 하려면 개인 공간의 콘텐츠 제외 필드를 사용 설정하세요. 개인 공간의 콘텐츠 제외 필드가 사용 설정되면 콘텐츠 검사기는 Looker 인스턴스의 개인 폴더에 있는 콘텐츠를 무시합니다.
증분 검사
증분 유효성 검사는 특정 개발 브랜치에만 고유한 오류, 즉 프로덕션에 아직 존재하지 않는 오류를 찾는 방법입니다. 증분 검사를 사용하면 개발자가 프로젝트의 기존 오류에 방해받지 않고 담당하는 오류를 찾아 수정할 수 있으며, 특히 Explore가 많은 LookML 프로젝트의 경우 검사 속도를 높일 수 있습니다.
검사기 결과에서 콘텐츠 검사기는 유효성 검사 중인 브랜치 또는 커밋의 컴파일된 SQL에 변경사항이 없어 건너뛴 각 Explore를 표시합니다. 증분 유효성 검사 결과의 예는 증분 유효성 검사 결과 보기를 참고하세요.
연속 통합 모음을 만들거나 수정할 때 콘텐츠 검사기 섹션에서 증분 오류만 표시 체크박스를 선택하여 콘텐츠 검사기의 증분 검증을 사용 설정할 수 있습니다.
증분 유효성 검사에 대해서는 다음 사항에 유의하세요.
- 프로덕션 브랜치에서 수동으로 실행하는 경우와 같이 콘텐츠 검사기가 프로덕션 브랜치 자체를 검사하는 경우에는 증분 유효성 검사 설정이 적용되지 않습니다. 프로덕션 브랜치를 검사할 때 콘텐츠 검사기에는 전체 결과 검사가 표시됩니다.
콘텐츠 검사의 제한사항
모델을 삭제하거나 이름을 변경하면 콘텐츠 검사기에서 이러한 '댕글링' 콘텐츠 오류를 반환하지 않습니다. 모델을 더 이상 테스트 중인 프로젝트와 연결할 수 없기 때문입니다.