시스템 규칙 템플릿 목록

Knowledge Catalog (이전 명칭: Dataplex Universal Catalog)는 데이터 품질 및 데이터 검증 프로세스를 정의하고 자동화하는 데 사용할 수 있는 다양한 규칙 템플릿을 지원합니다. 이러한 템플릿을 구현하는 것은 데이터 거버넌스의 핵심 부분으로, 데이터 세트의 정확성과 일관성을 유지하는 데 도움이 됩니다.

사용할 템플릿을 식별하려면 리소스에 데이터 프로파일링을 실행하여 잠재적인 품질 문제를 파악하면 됩니다. 필요한 품질 검사를 식별한 후 이 페이지에서 적절한 템플릿을 선택하여 리소스에 대한 규칙을 정의할 수 있습니다.

이 페이지에는 모든 지역에서 사용할 수 있는 시스템 규칙 템플릿이 나열되어 있습니다.

표 모양

이름 설명
열 개수 동일성 기대치 표의 열 수가 지정된 값과 같은지 평가하는 집계 규칙입니다. 이 규칙에는 쿼리되는 테이블과 데이터 세트에 대한 bigquery.tables.get, bigquery.tables.list, bigquery.datasets.get 권한이 필요합니다.
열 개수 범위 기대치 표의 열 수가 지정된 범위 내에 있는지 평가하는 집계 규칙입니다. 이 규칙에는 쿼리되는 테이블과 데이터 세트에 대한 bigquery.tables.get, bigquery.tables.list, bigquery.datasets.get 권한이 필요합니다.
열 존재 여부 기대치 테이블에 특정 열이 있는지 평가하는 집계 규칙입니다. 이 규칙에는 쿼리되는 테이블과 데이터 세트에 대한 bigquery.tables.get, bigquery.tables.list, bigquery.datasets.get 권한이 필요합니다.
최신성 기대치 열의 최신 데이터가 지정된 간격보다 최신인지 평가하는 집계 규칙입니다.
그룹화된 최신성 기대치 열의 최신 그룹화된 데이터가 지정된 간격보다 최신인지 평가하는 집계 규칙입니다.
정렬된 스키마 일치 예상 테이블의 정렬된 열이 정렬된 지정된 목록과 정확히 일치하는지 평가하는 집계 규칙입니다.
행 수 동등성 기대치 표의 행 수가 지정된 값과 같은지 평가하는 집계 규칙입니다.
행 수 범위 기대치 테이블의 행 수가 지정된 범위 내에 있는지 평가하는 집계 규칙입니다.
스키마 포함 기대치 테이블의 열 집합에 지정된 집합의 모든 열이 포함되어 있는지 평가하는 집계 규칙입니다. 이 규칙에는 쿼리되는 테이블과 데이터 세트에 대한 bigquery.tables.get, bigquery.tables.list, bigquery.datasets.get 권한이 필요합니다.
스키마 제외 기대치 표의 열이 지정된 집합에 없는지 평가하는 집계 규칙입니다. 이 규칙에는 쿼리되는 테이블과 데이터 세트에 대한 bigquery.tables.get, bigquery.tables.list, bigquery.datasets.get 권한이 필요합니다.
스키마 일치 예상 테이블의 열이 지정된 집합과 정확히 일치하는지 평가하는 집계 규칙입니다. 이 규칙에는 쿼리되는 테이블과 데이터 세트에 대한 bigquery.tables.get, bigquery.tables.list, bigquery.datasets.get 권한이 필요합니다.
표 비교 집계 동등성 기대치 집계 표현식의 결과가 현재 테이블과 지정된 참조 테이블 간에 동일한지 평가하는 집계 규칙입니다.
표 비교 집계 범위 기대치 현재 테이블의 집계 표현식 결과가 참조 테이블에서 지정된 허용 오차보다 벗어나는지 평가하는 집계 규칙입니다.
표 비교 행 수 동일성 기대치 현재 테이블의 행 수가 지정된 참조 테이블의 행 수와 같은지 평가하는 집계 규칙입니다. 계산 전에 행 필터링을 선택적으로 수행할 수 있습니다.
Table Comparison Row Count Factor Equality Expectation 현재 테이블의 행 수가 지정된 참조 테이블의 행 수의 인자와 같은지 평가하는 집계 규칙입니다. 계산 전에 선택적으로 행을 필터링할 수 있습니다.

누락된 값, 고유한 값, 유형

이름 설명
열 유형 기대치 열 데이터 유형이 지정된 유형과 일치하는지 평가하는 집계 규칙입니다. 이 규칙에는 쿼리되는 테이블과 데이터 세트에 대한 bigquery.tables.get, bigquery.tables.list, bigquery.datasets.get 권한이 필요합니다.
열 유형 목록 기대치 열 데이터 유형이 지정된 집합에 있는지 평가하는 집계 규칙입니다. 이 규칙에는 쿼리되는 테이블과 데이터 세트에 대한 bigquery.tables.get, bigquery.tables.list, bigquery.datasets.get 권한이 필요합니다.
Null이 아닌 값 기대 각 열 값이 null이 아닌지 평가하는 행 수준 규칙입니다.
Null Expectation 각 열 값이 null인지 평가하는 행 수준 규칙입니다.
문자열 케이스 기대치 각 열 값 문자열이 지정된 대소문자와 일치하는지 평가하는 행 수준 규칙입니다.
고유성 기대치 각 열 값이 고유한지 평가하는 행 수준 규칙입니다.

세트 및 범위

이름 설명
기대치 감소 열의 값이 감소하는지 평가하는 집계 규칙입니다. NULL 값은 무시됩니다. 기대가 충족되지 않는 첫 번째 행을 반환합니다.
기대치 높이기 열의 값이 증가하는지 평가하는 집계 규칙입니다. NULL 값은 무시됩니다. 기대가 충족되지 않는 첫 번째 행을 반환합니다.
범위 기대치 각 열 값이 지정된 범위 내에 있는지 평가하는 행 수준 규칙입니다.
참조 기대치 설정 각 열 값이 지정된 참조 세트에 포함되는지 평가하는 행 수준 규칙입니다.
제외 기대치 설정 각 열 값이 지정된 집합에 포함되지 않는지 평가하는 행 수준 규칙입니다.
기대치 설정 각 열 값이 지정된 집합에 포함되는지 평가하는 행 수준 규칙입니다.

문자열 일치

이름 설명
패턴 제외 기대치 각 열 값이 지정된 SQL LIKE 패턴과 일치하지 않는지 평가하는 행 수준 규칙입니다.
패턴 제외 기대치 목록 각 열 값이 지정된 SQL LIKE 패턴과 일치하지 않는지 평가하는 행 수준 규칙입니다.
패턴 기대치 각 열 값이 지정된 SQL LIKE 패턴과 일치하는지 평가하는 행 수준 규칙입니다.
패턴 기대 목록 각 열 값이 지정된 SQL LIKE 패턴 중 하나 이상과 일치하는지 평가하는 행 수준 규칙입니다.
정규식 제외 예상 각 열 값이 지정된 정규 표현식과 일치하지 않는지 평가하는 행 수준 규칙입니다.
정규식 제외 예상 목록 각 열 값이 지정된 정규 표현식과 일치하지 않는지 평가하는 행 수준 규칙입니다.
정규식 예상 각 열 값이 지정된 정규 표현식과 일치하는지 평가하는 행 수준 규칙입니다.
정규식 예상 목록 각 열 값이 지정된 정규 표현식 중 하나 이상과 일치하는지 평가하는 행 수준 규칙입니다.
문자열 길이 동일성 기대치 각 열 값 문자열 길이가 지정된 값과 같은지 평가하는 행 수준 규칙입니다.
문자열 길이 범위 기대치 각 열 값 문자열 길이가 지정된 범위 내에 있는지 평가하는 행 수준 규칙입니다.

집계 함수

이름 설명
고유 값 포함 기대치 고유한 열 값 세트에 지정된 세트의 모든 값이 포함되어 있는지 평가하는 집계 규칙입니다.
Distinct Values Count Equality Expectation 열의 고유 값 수가 지정된 값과 같은지 평가하는 집계 규칙입니다.
고유 값 개수 범위 기대치 열의 고유 값 수가 지정된 범위 내에 있는지 평가하는 집계 규칙입니다.
Distinct Values Match Expectation(고유 값 일치 기대치) 고유 열 값 집합이 지정된 집합과 정확히 일치하는지 평가하는 집계 규칙입니다.
고유 값 비율 기대치 열의 고유 값 비율 (즉, 고유 값 수 / 총 행 수)이 지정된 범위 내에 있는지 평가하는 집계 규칙입니다.
고유 값 설정 기대치 각 고유 열 값이 지정된 세트에 포함되는지 평가하는 집계 규칙입니다.
최대 범위 기대치 열 최댓값이 지정된 범위 내에 있는지 평가하는 집계 규칙입니다.
평균 범위 기대치 열 평균이 지정된 범위 내에 있는지 평가하는 집계 규칙입니다. 부동 소수점 유형이 반환되면 AVG() 함수의 결과가 확정값이 아님을 나타냅니다.
중간 범위 기대치 열 중앙값이 지정된 범위 내에 있는지 평가하는 집계 규칙입니다.
최소 범위 기대치 열 최솟값이 지정된 범위 내에 있는지 평가하는 집계 규칙입니다.
모드 범위 기대치 모든 열 모드 (가장 자주 나오는 값)가 지정된 범위 내에 있는지 평가하는 집계 규칙입니다. 모드가 여러 개인 경우 각 모드가 범위에 대해 확인되고 실패한 모드가 반환됩니다.
모드 설정 기대치 모든 열 모드 (가장 자주 나오는 값)가 지정된 집합 내에 있는지 평가하는 집계 규칙입니다. 최빈값을 계산할 때 NULL 값은 무시됩니다. 최고 주파수가 동일한 모드가 여러 개 있는 경우 각 모드가 설정에 대해 확인되며 실패한 모드는 배열로 반환됩니다.
Quantile Range Expectation 열의 지정된 분위수에 있는 값이 지정된 범위 내에 있는지 평가하는 집계 규칙입니다.
표준 편차 범위 기대치 열 표준편차가 지정된 범위 내에 있는지 평가하는 집계 규칙입니다.
합계 범위 예상 열 합계가 지정된 범위 내에 있는지 평가하는 집계 규칙입니다. 부동 소수점 유형이 반환되면 SUM() 함수의 결과가 확정값이 아님을 나타냅니다.
Table Comparison Unique Values Count Equality Expectation 지정된 열의 고유 값 수가 현재 테이블과 참조 테이블 간에 동일한지 평가하는 집계 규칙입니다.

다중 열

이름 설명
열 비교 동일성 기대치 각 행에 대해 열 A의 값이 열 B의 값과 동일한지 평가하는 행 수준 규칙입니다.
열 비교 더 큰 기대치 각 행에 대해 열 A의 값이 열 B의 값보다 큰지 평가하는 행 수준 규칙입니다.
열 쌍 설정 기대치 A열과 B열의 쌍을 이루는 값이 지정된 세트에 포함되어 있는지 평가하는 집계 규칙입니다.
Multi Column Sum Equality Expectation 지정된 열 목록에 있는 모든 행의 합계가 지정된 값과 같은지 평가하는 집계 규칙입니다. 부동 소수점 유형이 반환되면 SUM() 함수의 결과가 확정값이 아님을 나타냅니다.
다중 열 고유성 기대치 지정된 열 목록의 값 조합이 각 행에 대해 고유한지 평가하는 행 수준 규칙입니다 (예: 다중 열 기본 키).
레코드 열 고유성 기대치 지정된 열 목록의 값이 각 레코드 (행) 내에서 고유한지 평가하는 행 수준 규칙입니다. 레코드는 중복될 수 있습니다.

분포 함수

이름 설명
날짜 부분 완전성 기대치 표에 기간 내의 모든 간격 (예: 매일)에 대한 데이터가 있는지 평가하는 집계 규칙입니다.
표준 편차 값 기대치 각 열 값이 열 평균에서 지정된 표준 편차 수 내에 있는지 평가하는 행 수준 규칙입니다.

일반 조건

이름 설명
행 조건 기대치 테이블의 각 행이 지정된 조건을 통과하는지 평가하는 행 수준 규칙입니다.
SQL 어설션 제공된 문에 대해 반환된 행 수를 평가하는 집계 규칙입니다. 반환되는 행이 있으면 이 규칙이 실패합니다.
표 조건 기대치 제공된 표현식이 테이블에 대해 참인지 평가하는 집계 규칙입니다.

다음 단계