DATA_QUALITY_MONITORING_EXPECTATION_STATUS

지정한 객체에서 기대값(expectation)이 있는 데이터 메트릭 함수(DMF)가 실행될 때마다 한 행씩 반환하는 LOCAL 스키마 테이블 함수예요. 각 행에서 기대값의 상태를 확인할 수 있어요.

출처: 공식 문서

본문

Data Quality Monitoring은 Enterprise Edition이 필요합니다. 업그레이드 문의는 Snowflake Support에 연락하세요.

지정된 객체에 대해, 기대값을 가진 데이터 메트릭 함수(DMF)가 실행될 때마다 행 하나를 반환합니다. 각 행에서 기대값의 상태를 얻을 수 있습니다.

참고 (See also): DATA_QUALITY_MONITORING_EXPECTATION_STATUS view (LOCAL 뷰)

구문 (Syntax)

DATA_QUALITY_MONITORING_EXPECTATION_STATUS(
  REF_ENTITY_NAME => '<string>' ,
  REF_ENTITY_DOMAIN => '<string>'
  )

인자 (Arguments)

REF_ENTITY_NAME => 'string'

기대값이 있는 데이터 메트릭 함수가 설정된 테이블 객체의 이름입니다. 이름은 완전히 한정되어야 합니다. 전체 객체 이름은 작은따옴표로 묶어야 합니다. 객체 이름이 대소문자를 구분하거나 특수 문자나 공백을 포함하면, 대소문자/문자를 처리하기 위해 큰따옴표가 필요합니다. 큰따옴표는 작은따옴표 안에 포함되어야 합니다(예: '"table_name"').

REF_ENTITY_DOMAIN => 'string'

기대값이 있는 데이터 메트릭 함수가 설정된 객체 유형입니다. 객체가 테이블 종류면 인자 값으로 'TABLE'을 사용합니다. 객체가 뷰 또는 구체화된 뷰이면 인자 값으로 'VIEW'를 사용합니다. 데이터 메트릭 함수를 설정할 수 있는 지원되는 객체 유형 목록은 "Supported table kinds"를 참고하세요.

출력 (Output)

함수는 다음 컬럼을 가진 행을 반환합니다:

컬럼 이름	데이터 타입	설명
`scheduled_time`	TIMESTAMP_LTZ	테이블이나 뷰에 설정한 일정에 따라 DMF가 실행되도록 예약된 시간.
`change_commit_time`	TIMESTAMP_LTZ	DMF 트리거 연산이 발생한 시간, 또는 DMF가 트리거 연산으로 실행되도록 예약되지 않았으면 NULL. 트리거 연산에 대한 정보는 DMF 일정 조정을 참고.
`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	각 인자의 도메인/타입 배열. 배열 요소는 인자와 같은 순서. 현재는 COLUMN 타입 인자만 지원.
`argument_names`	ARRAY	DMF 인자 이름의 배열. 컬럼 인자의 경우 각 요소는 컬럼의 이름. 배열 요소는 인자와 같은 순서.
`reference_id`	VARCHAR	메트릭 엔티티 참조를 고유하게 식별하는 ID로, 연관 ID로 알려짐.
`value`	VARIANT	DMF 평가의 결과.
`expectation_name`	VARCHAR	기대값이 DMF와 객체 사이의 연관에 추가될 때 주어진 이름.
`expectation_id`	VARCHAR	시스템 생성 식별자.
`expectation_expression`	VARCHAR	기대값의 Boolean 표현식. 기대값 충족 여부 정의를 참고.
`expectation_violated`	BOOLEAN	TRUE이면 기대값이 위반됨. `expectation_expression`이 FALSE로 평가되면 기대값이 위반된 것. NULL 값은 기대값 평가가 실패했음을 나타냄.

접근 제어 요구 사항

이 함수에 접근하려면 사용 중인 역할이 최소한 SNOWFLAKE.DATA_QUALITY_MONITORING_LOOKUP 애플리케이션 역할을 가져야 합니다. 다른 애플리케이션 역할 옵션은 데이터 품질 결과 보기를 참고하세요. GRANT APPLICATION ROLE 명령으로 애플리케이션 역할을 역할에 부여하세요.

결과를 보려면 사용 중인 역할이 또한 다음 권한을 가져야 합니다:

데이터 메트릭 함수가 할당된 객체(테이블 또는 뷰)에 대한 SELECT 또는 OWNERSHIP 권한.
데이터 메트릭 함수에 대한 USAGE 또는 OWNERSHIP 권한.

스키마의 객체를 운영하려면 부모 데이터베이스에 대해 최소 하나의 권한, 그리고 부모 스키마에 대해 최소 하나의 권한이 필요합니다.

사용 참고 (Usage notes)

지정된 객체 이름이 존재하지 않거나, 쿼리 연산자가 객체의 데이터 메트릭 함수를 볼 권한이 없으면 오류가 발생합니다. REF_ENTITY_DOMAIN 인자에 지정된 지원되지 않는 객체 유형(예: 'STREAM')도 오류를 반환합니다.

예제 (Examples)

my_table이라는 테이블에 할당된 기대값이 있는 각 데이터 메트릭 함수에 대해 행 하나를 반환합니다:

SELECT *
  FROM TABLE(SNOWFLAKE.LOCAL.DATA_QUALITY_MONITORING_EXPECTATION_STATUS(
    REF_ENTITY_NAME => 'my_db.sch1.my_table',
    REF_ENTITY_DOMAIN => 'TABLE'));

더 알아보기 (Learn more)

DATA_QUALITY_MONITORING_EXPECTATION_STATUS 뷰 — 뷰 버전
Data quality expectations
Data Quality Monitoring