카테고리:: LOCAL 스키마 , 테이블 함수

DATA_QUALITY_MONITORING_RESULTS¶

지정된 오브젝트에 할당된 각 데이터 메트릭 함수에 대해 행을 반환하며, 여기에는 오브젝트에 대한 데이터 메트릭 함수의 평가 결과와 기타 메타데이터가 포함됩니다.

참고 항목:: DATA_QUALITY_MONITORING_RESULTS 뷰 (LOCAL 뷰)

구문¶

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

Copy

인자¶

REF_ENTITY_NAME => 'string'

데이터 메트릭 함수가 설정된 테이블 오브젝트의 이름입니다.

전체 오브젝트 이름은 작은따옴표로 묶어야 합니다.
오브젝트 이름이 대/소문자를 구분하거나, 특수 문자 또는 공백을 포함하는 경우 대/소문자를 처리하려면 큰따옴표가 필요합니다. 큰따옴표는 작은따옴표로 묶어야 합니다(예: '"<테이블_이름>"').

REF_ENTITY_DOMAIN => 'string'

데이터 메트릭 함수가 설정되는 오브젝트 유형입니다.

오브젝트가 일종의 테이블인 경우, 'TABLE' 을 인자 값으로 사용합니다.

오브젝트가 뷰 또는 구체화된 뷰인 경우, 'VIEW' 를 인자 값으로 사용합니다.

데이터 메트릭 함수를 설정할 수 있도록 지원되는 오브젝트 유형의 목록은 지원되는 테이블 종류 섹션을 참조하십시오.

반환¶

이 함수는 다음 열을 반환합니다.

열 이름	데이터 타입	설명
`scheduled_time`	TIMESTAMP_LTZ	테이블 또는 뷰에 대해 설정된 일정에 따라 DMF가 실행되도록 예약된 시간입니다.
`change_commit_time`	TIMESTAMP_LTZ	DMF 트리거 작업이 발생한 시간(트리거 작업에 의해 DMF가 실행되도록 예약되지 않은 경우 `None`)입니다. 트리거 작업에 대한 정보는 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 의 반환 유형입니다.
`arguments_ids`	ARRAY	DMF 인자의 식별자 배열입니다. 배열 요소는 인자와 동일한 순서로 정렬됩니다.
`arguments_types`	ARRAY	각 DMF 인자의 도메인/타입 배열입니다. 배열 요소는 인자와 동일한 순서로 정렬됩니다. 현재는 COLUMN 타입 인자만 지원합니다.
`arguments_names`	ARRAY	DMF 인자의 이름 배열입니다. 열 인자의 경우 각 요소는 열의 이름입니다. 배열 요소는 인자와 동일한 순서로 정렬됩니다.
`reference_id`	VARCHAR	메트릭 엔터티 참조를 고유하게 식별하는 ID를 연결 ID라고 합니다.
`value`	VARIANT	DMF 평가의 결과입니다.

액세스 제어 요구 사항¶

이 함수를 호출하는 데 필요한 권한과 역할을 결정하려면 데이터 품질 결과 보기 섹션을 참조하세요.

사용법 노트¶

지정된 오브젝트 이름이 존재하지 않거나 쿼리 연산자가 오브젝트에 대한 데이터 메트릭 함수를 볼 권한이 없는 경우 오류가 발생합니다. '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'));

Copy