Looker 26.0 문서를 보고 있습니다. 이 링크를 클릭하여 최신 문서를 확인하세요.

연속 통합 SQL 검사기

연속 통합 (CI) SQL 검사기는 Explore의 측정기준이 데이터베이스에 대해 올바르게 실행되는지 확인합니다. 이를 위해 SQL 검사기는 LookML 프로젝트의 Explore에서 일련의 쿼리를 실행합니다.

기본적으로 SQL 검사기는 다음 작업을 실행합니다.

프로젝트의 각 Explore에 대해 SQL 검사기는 Explore의 모든 측정기준을 포함하는 Explore 쿼리를 실행합니다.
Looker에서 Explore 쿼리에 대한 오류를 반환하면 SQL 검사기는 Explore의 각 측정기준에 대해 별도의 Explore 쿼리를 실행합니다.

SQL 검사기가 모든 Explore의 모든 측정기준을 테스트하지 않도록 하려면 다음 중 하나 이상을 선택적으로 실행하면 됩니다.

특정 Explore만 쿼리하도록 SQL 검사기를 구성합니다.
특정 Explore를 제외하도록 SQL 검사기를 구성합니다.
SQL 검사기를 구성하여 다음으로 정의된 LookML 측정기준을 무시합니다. hidden: yes.
SQL 검사기가 Explore 쿼리에 측정기준을 포함하지 않도록 하려면 측정기준의 LookML에 ci: ignore 주석 또는 태그 를 추가합니다.

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

실행 결과 페이지에서 SQL 검사기는 문제 LookML에 대한 링크와 디버깅을 위한 여기에서 Explore 링크와 함께 측정기준 및 Explore별로 분류된 각 SQL 오류를 표시합니다.

SQL 검사기 발견 항목을 보여주는 지속적 통합 결과 페이지

리소스 소비

SQL 검사기는 Looker 및 데이터 웨어하우스 내에서 가장 적은 리소스를 소비하도록 설계되었습니다. 모든 SQL 검사기 쿼리에는 LIMIT 0 및 WHERE 1=2 절이 포함됩니다. 이러한 절은 데이터 웨어하우스의 쿼리 플래너에 데이터를 처리하지 말고 SQL의 유효성을 검사하도록 효과적으로 지시합니다.

예를 들어 BigQuery에서 이러한 유형의 쿼리는 BigQuery에서 드라이 런 쿼리를 실행하는 것과 비슷합니다. BigQuery의 경우 LIMIT 0 쿼리는 데이터를 검사하지 않으므로 SQL 검사기가 실행하는 쿼리에 대해 요금이 청구되지 않습니다.

SQL 검사에서 측정기준 제외

검사 중에 매개변수의 값이 null이고 항상 SQL 오류가 발생하므로 매개변수에 종속된 측정기준과 같은 특정 측정기준을 SQL 검사에서 제외할 수 있습니다.

sql 매개변수가 없는 측정기준(예: type: distance, type: location 또는 type: duration의 측정기준)을 제외할 수도 있습니다.

SQL 검사에서 측정기준을 제외하려면 다음 두 가지 방법 중 하나로 측정기준의 LookML을 수정하면 됩니다.

다음 예와 같이 측정기준의 LookML 정의의 tags 매개변수에 ci: ignore 문을 추가할 수 있습니다.
```
dimension: addresses {
  sql: ${TABLE}.addresses ;;
  tags: ["ci: ignore"]
}
```
다음 예와 같이 측정기준의 LookML의 sql 필드에 주석 -- ci: ignore를 추가할 수 있습니다.
```
dimension: addresses {
  sql:
    -- ci: ignore
    ${TABLE}.addresses ;;
}
```

SQL 검사기 옵션

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

쿼리할 Explore
제외할 Explore
빠른 실패
숨김 무시
쿼리 동시 실행
증분 검사

쿼리할 Explore

기본적으로 SQL 검사기는 LookML 프로젝트의 모든 모델 및 Explore에서 SQL 검사를 실행합니다.

쿼리할 Explore 필드를 사용하여 SQL 검사에 포함할 Explore 및 모델을 지정할 수 있습니다.

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

다음에 유의하세요.

model_name의 경우 .model.lkml 확장자가 없는 모델 파일의 이름을 사용합니다. 예를 들어 thelook.model.lkml에 정의된 모델을 지정하려면 thelook을 입력합니다.
explore_name의 경우 explore LookML 매개변수의 explore_name을 사용합니다. 예를 들어 LookML 프로젝트에서 explore: users로 정의된 Explore를 지정하려면 users를 입력합니다.
쉼표로 구분된 목록을 만들어 여러 Explore를 지정할 수 있습니다.
model_name 또는 explore_name에서 * 와일드 카드를 사용할 수 있습니다.

예를 들면 다음과 같습니다.

thelook.model.lkml 파일에서 explore: users로 정의된 사용자 Explore만 지정하려면 다음을 입력합니다.
```
thelook/users
```
thelook.model.lkml 파일에서 users 및 orders라는 Explore를 지정하려면 다음을 입력합니다.
```
thelook/users, thelook/orders
```
thelook.model.lkml의 모든 Explore를 지정하려면 다음을 입력합니다.
```
thelook/*
```
프로젝트의 모든 모델에서 users라는 모든 Explore를 지정하려면 다음을 입력합니다.
```
*/users
```

제외할 Explore

기본적으로 SQL 검사기는 LookML 프로젝트의 모든 모델 및 Explore에서 SQL 검사를 실행합니다.

제외할 Explore 필드를 사용하여 SQL 검사에서 제외할 Explore 및 모델을 지정할 수 있습니다.

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

SQL 검사기의 Explore를 지정하는 방법에 대한 자세한 내용은 쿼리할 Explore 섹션을 참고하세요.

빠른 실패

기본적으로 SQL 검사기는 쿼리의 모든 측정기준이 포함된 Explore당 하나의 쿼리를 실행합니다. Explore 쿼리가 실패하면 SQL 검사기는 Explore의 각 측정기준에 대해 개별적으로 Explore 쿼리를 실행합니다.

검사 속도를 높이려면 SQL 검사기가 Explore의 초기 쿼리, 즉 모든 측정기준을 한 번에 포함하는 쿼리만 실행하도록 빠른 실패 옵션을 사용 설정하면 됩니다. 해당 쿼리가 오류를 반환하면 SQL 검사기는 CI 실행 결과에 해당 오류를 표시하고 검사 중인 다음 Explore로 이동합니다.

빠른 실패 를 사용 설정하면 일반적으로 검사가 더 빠르게 완료됩니다. 하지만 여러 측정기준에 오류가 있을 수 있더라도 SQL 검사기 결과에는 각 Explore의 첫 번째 오류만 표시됩니다. 즉, 첫 번째 오류를 수정하면 SQL 검사기의 다음 실행에서 추가 오류가 표시될 수 있습니다.

숨김 무시

SQL 검사기가 Looker 개발자가 hidden: yes로 정의한 LookML 측정기준을 무시하도록 하려면 숨김 무시 필드를 사용 설정합니다. SQL 검사기는 검사 중에 이러한 측정기준을 Explore 쿼리에서 제외합니다.

쿼리 동시 실행

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

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

SQL 검사를 실행하는 동안 Looker 인스턴스의 속도가 느려지는 것을 확인하면 이 값을 줄일 수 있습니다.

증분 검사

증분 검사는 특정 개발 브랜치에 고유한 오류, 즉 프로덕션에 아직 존재하지 않는 오류를 찾는 방법입니다. 증분 검사를 사용하면 개발자가 프로젝트의 기존 오류에 방해받지 않고 담당하는 오류를 찾고 수정할 수 있으며, 특히 Explore가 많은 LookML 프로젝트의 경우 검사 속도를 높일 수도 있습니다.

증분 검사의 경우 SQL 검사기는 개발 버전 (기준 참조)과 프로덕션 버전 (타겟 참조) 간에 변경된 Explore 쿼리만 실행합니다. SQL 검사기는 프로덕션 버전 자체에 오류가 있더라도 개발 버전에 고유한 오류만 반환합니다.

검사기 결과에서 SQL 검사기는 검사 중인 브랜치 또는 커밋에서 컴파일된 SQL이 변경되지 않았기 때문에 건너뛴 각 Explore를 나타냅니다. 증분 검사 결과의 예는 증분 검사 결과 보기를 참고하세요.

연속 통합 모음을 만들거나 수정할 때 SQL 검사기 섹션에서 증분 오류만 체크박스를 선택하여 SQL 검사기에 증분 검사를 사용 설정할 수 있습니다.

증분 검사에 대해서는 다음 사항에 유의하세요.

프로덕션 브랜치에서의 수동 실행과 같이 SQL 검사기가 프로덕션 브랜치 자체를 검사할 때는 증분 검사 설정이 적용되지 않습니다. 프로덕션 브랜치를 검사할 때 SQL 검사기가 전체 검사를 실행합니다.
빠른 실패 모드는 개별 측정기준 쿼리는 프로젝트의 개발 브랜치에 고유한 증분 오류를 노출하는 데 필요하므로 증분 검사 실행에는 지원되지 않습니다.