카테고리:: 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`)입니다. 트리거 작업에 대한 정보는 실행할 DMFs 예약 섹션을 참조하십시오.
`measurement_time`	TIMESTAMP_LTZ	메트릭이 평가되는 시간입니다.
`table_id`	NUMBER	규칙이 연관된 테이블의 내부/시스템 생성 식별자입니다. 규칙은 테이블에 직접 연결될 수도 있고 테이블의 모든 열에 연결될 수도 있습니다.
`table_name`	VARCHAR	테이블의 이름입니다.
`table_schema`	VARCHAR	테이블이 포함된 스키마의 이름입니다.
`table_database`	VARCHAR	테이블을 포함하는 데이터베이스의 이름입니다.
`metric_id`	NUMBER	메트릭의 내부/시스템 생성 식별자입니다.
`metric_name`	VARCHAR	메트릭의 이름입니다.
`metric_schema`	VARCHAR	메트릭이 포함된 스키마의 이름입니다.
`metric_database`	VARCHAR	메트릭을 포함하는 데이터베이스의 이름입니다.
`metric_return_type`	VARCHAR	메트릭의 반환 유형입니다.
`arguments_ids`	ARRAY	규칙을 평가하는 데 사용되는 참조 인자의 IDs가 포함된 배열입니다. 배열의 항목은 인자의 위치에 따라 정렬됩니다.
`arguments_types`	ARRAY	규칙을 평가하는 데 사용되는 참조 인자의 유형을 포함하는 배열입니다. 배열의 항목은 인자의 위치에 따라 정렬됩니다. 현재는 COLUMN 타입 인자만 지원합니다.
`arguments_names`	ARRAY	규칙을 평가하는 데 사용되는 참조 인자의 이름을 포함하는 배열입니다. 배열의 항목은 인자의 위치에 따라 정렬됩니다.
`reference_id`	VARCHAR	메트릭 엔터티 참조를 고유하게 식별하는 ID를 연결 ID라고 합니다.
`value`	VARIANT	평가의 결과입니다.

액세스 제어 요구 사항¶

이 함수에 액세스하려면 사용 중인 역할에 최소한 SNOWFLAKE.DATA_QUALITY_MONITORING_LOOKUP 애플리케이션 역할이 있어야 합니다. 다른 애플리케이션 역할 옵션은 DMF 결과에 대한 액세스 관리하기 섹션을 참조하십시오. GRANT APPLICATION ROLE 명령을 사용하여 역할에 애플리케이션 역할을 부여합니다.

결과를 보려면 사용 중인 역할에 다음 권한도 있어야 합니다.

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

사용법 노트¶

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