DATA_METRIC_FUNCTION_EXPECTATIONS

계정에 존재하는 기대치(expectation)에 대한 정보를 반환하는 Information Schema 테이블 함수예요. 이 기능은 Enterprise Edition 이상에서 사용할 수 있어요.

출처: 공식 문서

본문

Enterprise Edition 기능 (Enterprise Edition Feature): Data Quality Monitoring에는 Enterprise Edition이 필요합니다. 업그레이드 문의는 Snowflake Support에 연락하세요.

계정에 존재하는 기대치에 대한 정보를 반환합니다.

구문 (Syntax)

DATA_METRIC_FUNCTION_EXPECTATIONS(
  [ METRIC_NAME => '<string>' ]
  [, REF_ENTITY_NAME => '<string>' ]
  [, REF_ENTITY_DOMAIN => '<string>' ]
)

인자 (Arguments)

시스템 또는 사용자 지정 데이터 메트릭 함수(DMF)의 이름을 지정합니다. 이 함수는 객체와 지정된 DMF 사이의 연관관계에 추가된 기대치를 반환합니다.

DMF가 연관된 객체의 이름을 지정합니다. 해당 객체에 대한 DMF 연관관계에 추가된 기대치를 반환합니다. 지정하면 REF_ENTITY_DOMAIN도 지정해야 합니다.

전체 객체 이름은 작은따옴표로 묶어야 합니다.

객체 이름이 대소문자를 구분하거나 특수 문자나 공백을 포함하면 대소문자/문자를 처리하기 위해 큰따옴표가 필요합니다. 큰따옴표는 작은따옴표 안에 있어야 합니다(예: '"table_name"').

REF_ENTITY_NAME의 객체 유형입니다.

객체가 어떤 유형의 테이블이든 인자 값으로 table을 사용하세요.
객체가 뷰 또는 구체화된 뷰이면 인자 값으로 view를 사용하세요.

출력 (Output)

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

Column name	Data type	Description
metric_database_name	VARCHAR	DMF가 존재하는 데이터베이스.
metric_schema_name	VARCHAR	DMF가 존재하는 스키마.
metric_name	VARCHAR	DMF의 이름.
metric_signature	VARCHAR	DMF의 시그니처.
metric_data_type	VARCHAR	DMF가 반환하는 데이터 타입.
ref_entity_database_name	VARCHAR	DMF와 연관된 객체의 데이터베이스.
ref_entity_schema_name	VARCHAR	DMF와 연관된 객체의 스키마.
ref_entity_name	VARCHAR	DMF와 연관된 객체의 이름.
ref_entity_domain	VARCHAR	DMF와 연관된 객체의 유형.
ref_arguments	ARRAY	DMF에 전달된 인자.
ref_id	VARCHAR	시스템 생성 식별자.
expectation_id	VARCHAR	기대치의 시스템 생성 식별자.
expectation_name	VARCHAR	사용자가 DMF 연관관계에 추가할 때 기대치에 부여한 이름.
expectation_expression	VARCHAR	기대치의 Boolean 표현식. Defining what meets the expectation을 참고하세요.

예제 (Examples)

특정 객체에 존재하는 기대치를 반환합니다.

SELECT *
  FROM TABLE(
    INFORMATION_SCHEMA.DATA_METRIC_FUNCTION_EXPECTATIONS(
      REF_ENTITY_NAME => 'my_table',
      REF_ENTITY_DOMAIN => 'table'));

특정 DMF에 존재하는 기대치를 반환합니다.

SELECT *
  FROM TABLE(
    INFORMATION_SCHEMA.DATA_METRIC_FUNCTION_EXPECTATIONS(
      METRIC_NAME => 'SNOWFLAKE.CORE.NULL_COUNT'));

객체와 DMF 사이의 특정 연관관계에 존재하는 기대치를 반환합니다.

SELECT *
  FROM TABLE(
    INFORMATION_SCHEMA.DATA_METRIC_FUNCTION_EXPECTATIONS(
      METRIC_NAME => 'SNOWFLAKE.CORE.NULL_COUNT',
      REF_ENTITY_NAME => 'my_table',
      REF_ENTITY_DOMAIN => 'table'));

DATA_METRIC_FUNCTION_EXPECTATIONS