DATA_QUALITY_MONITORING_RESULTS
DATA_QUALITY_MONITORING_RESULTS
지정된 객체에 할당된 각 데이터 메트릭 함수에 대해 행을 반환해요. 여기에는 객체에서 데이터 메트릭 함수의 평가 결과와 기타 메타데이터가 포함돼요.
출처: Snowflake SQL Reference - DATA_QUALITY_MONITORING_RESULTS
본문
구문
DATA_QUALITY_MONITORING_RESULTS(
REF_ENTITY_NAME => '<string>' ,
REF_ENTITY_DOMAIN => '<string>'
)
인자
- 데이터 메트릭 함수가 설정된 테이블 객체의 이름이에요.
- 전체 객체 이름은 작은따옴표로 묶어야 해요.
- 객체 이름이 대소문자를 구분하거나 특수 문자나 공백을 포함하면, 대소문자/문자를 처리하기 위해 큰따옴표가 필요해요. 큰따옴표는 작은따옴표 안에 묶여야 해요. 예:
'"<table_name>"'.
- 데이터 메트릭 함수가 설정된 객체 타입이에요.
- 객체가 테이블 종류라면 인자 값으로 'TABLE'을 사용해요.
- 객체가 뷰 또는 구체화된 뷰라면 인자 값으로 'VIEW'를 사용해요.
- 데이터 메트릭 함수를 설정할 수 있는 지원 객체 타입 목록은 Supported table kinds를 참고해요.
반환 값
함수는 다음 컬럼을 반환해요.
| Column name | Data type | Description |
|---|---|---|
| scheduled_time | TIMESTAMP_LTZ | 테이블 또는 뷰에 대해 설정한 일정에 따라 DMF가 실행되도록 예약된 시간이에요. |
| change_commit_time | TIMESTAMP_LTZ | DMF 트리거 작업이 발생한 시간이에요. 또는 DMF가 트리거 작업으로 실행되도록 예약되지 않은 경우 NULL이에요. 트리거 작업에 대한 자세한 내용은 Adjust the schedule for DMFs를 참고해요. |
| measurement_time | TIMESTAMP_LTZ | 메트릭이 평가된 시각이에요. |
| table_id | NUMBER | DMF가 연결된 테이블의 내부/시스템 생성 식별자예요. |
| table_name | VARCHAR | DMF가 연결된 테이블의 이름이에요. |
| table_schema | VARCHAR | DMF가 연결된 테이블을 포함하는 스키마의 이름이에요. |
| table_database | VARCHAR | DMF가 연결된 테이블을 포함하는 데이터베이스의 이름이에요. |
| metric_id | NUMBER | DMF의 내부/시스템 생성 식별자예요. |
| metric_name | VARCHAR | DMF의 이름이에요. |
| metric_schema | VARCHAR | DMF를 포함하는 스키마의 이름이에요. |
| metric_database | VARCHAR | DMF를 포함하는 데이터베이스의 이름이에요. |
| metric_return_type | VARCHAR | DMF의 반환 타입이에요. |
| argument_ids | ARRAY | DMF 인자의 식별자 배열이에요. 배열 요소는 인자와 같은 순서예요. |
| argument_types | ARRAY | 각 DMF 인자의 도메인/타입 배열이에요. 배열 요소는 인자와 같은 순서예요. 현재는 COLUMN 타입 인자만 지원해요. |
| argument_names | ARRAY | DMF 인자의 이름 배열이에요. 컬럼 인자의 경우 각 요소는 컬럼 이름이에요. 배열 요소는 인자와 같은 순서예요. |
| reference_id | VARCHAR | 메트릭 엔티티 참조를 고유하게 식별하는 ID로, 연관 ID(association ID)라고 해요. |
| value | VARIANT | DMF 평가의 결과예요. |
접근 제어 요구 사항
이 함수를 호출하는 데 필요한 권한과 역할을 확인하려면 Viewing data quality results를 참고해요.
사용상 주의사항
지정된 객체 이름이 존재하지 않거나 쿼리 연산자가 객체의 데이터 메트릭 함수를 볼 권한이 없으면 오류가 발생해요. 'stream' 같은 지원되지 않는 객체 타입을 REF_ENTITY_DOMAIN으로 나열한 경우도 오류를 반환해요.
예시
my_table이라는 테이블에 할당된 각 데이터 메트릭 함수에 대해 행을 반환해요.
USE DATABASE SNOWFLAKE;
USE SCHEMA LOCAL;
SELECT *
FROM TABLE(SNOWFLAKE.LOCAL.DATA_QUALITY_MONITORING_RESULTS(
REF_ENTITY_NAME => 'my_db.my_schema.my_table',
REF_ENTITY_DOMAIN => 'table'));