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

DATA_QUALITY_MONITORING_EXPECTATION_STATUS¶

지정된 오브젝트에 대해 기대치 가 포함된 DMF(데이터 메트릭 함수)가 실행될 때마다 행을 반환합니다. 각 행에서 기대치의 상태를 얻을 수 있습니다.

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

구문¶

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

Copy

인자¶

REF_ENTITY_NAME => 'string'

기대치가 포함된 데이터 메트릭 함수가 설정된 테이블 오브젝트의 이름입니다. 이름은 정규화되어야 합니다.

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

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	각 인자의 도메인/유형 배열입니다. 배열 요소는 인자와 순서가 같습니다. 현재는 COLUMN 타입 인자만 지원합니다.
`arguments_names`	ARRAY	DMF 인자의 이름 배열입니다. 열 인자의 경우 각 요소는 열의 이름입니다. 배열 요소는 인자와 동일한 순서로 정렬됩니다.
`reference_id`	VARCHAR	메트릭 엔터티 참조를 고유하게 식별하는 ID를 연결 ID라고 합니다.
`value`	VARIANT	DMF 평가의 결과입니다.
`expectation_name`	VARCHAR	기대치가 DMF와 오브젝트 사이의 연결에 추가될 때 지정된 이름입니다.
`expectation_id`	VARCHAR	시스템 생성 식별자입니다.
`expectation_expression`	VARCHAR	기대치의 부울 식입니다. 기대치를 충족하는 항목 정의하기 섹션을 참조하십시오.
`expectation_violated`	BOOLEAN	TRUE인 경우 기대치가 위반된 것입니다. `expectation_expression` 이 FALSE로 평가되면 기대치가 위반된 것입니다. NULL 값은 예상 평가가 실패했음을 나타냅니다.

액세스 제어 요구 사항¶

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

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

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

스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한.

사용법 노트¶

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

예¶

my_table 이라는 테이블에 할당된 기대치를 사용하여 각 데이터 메트릭 함수에 대한 행을 반환합니다.

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

Copy