OUTLIER_IQR_PERCENT

OUTLIER_IQR_PERCENT (시스템 데이터 메트릭 함수)

SNOWFLAKE.CORE.OUTLIER_IQR_PERCENT 함수는 열 값 중 표준 Tukey 경계(fence)(사분위 범위의 1.5배) 밖에 속하는 값의 백분율을 반환해요.

출처: OUTLIER_IQR_PERCENT (시스템 데이터 메트릭 함수)

본문

OUTLIER_IQR_PERCENT 함수는 열의 표준 Tukey 경계(사분위 범위 IQR의 1.5배) 밖에 속하는 열 값의 백분율을 반환해요.

Enterprise Edition 기능: 데이터 품질 모니터링(Data Quality Monitoring)에는 Enterprise Edition이 필요해요. 업그레이드 문의는 Snowflake 지원팀에 문의하세요.

이 항목은 함수를 직접 호출하기 위한 구문을 제공해요. 함수를 테이블이나 뷰와 연결해 정기적으로 실행되게 하는 방법을 배우려면 데이터 메트릭 함수 연결(Associate a DMF)을 참조해요.

구문 (Syntax)

SNOWFLAKE.CORE.OUTLIER_IQR_PERCENT(<query>)

인자 (Arguments)

  • query — 단일 열을 프로젝트하는 SQL 쿼리를 지정해요.

허용 데이터 타입 (Allowed data types)

쿼리가 프로젝트하는 열은 다음 데이터 타입 중 하나여야 해요:

  • FLOAT
  • NUMBER

반환 (Returns)

함수는 FLOAT 데이터 타입의 스칼라 값을 반환해요.

사용 메모 (Usage notes)

  • 시스템 DMF를 수동으로 호출할 때 사용 중인 허용 데이터 타입을 지정할 필요는 없어요. 측정하려는 열에 대한 쿼리만 지정하면 돼요. Snowflake는 함수의 허용 데이터 타입을 열의 데이터 타입과 일치시켜요.
  • 함수는 NULL이 아니고 NaN이 아닌 값의 첫 번째 및 세 번째 사분위수(Q1, Q3)와 사분위 범위 IQR = Q3 - Q1을 계산한 다음, Q1 - 1.5 * IQR보다 작거나 Q3 + 1.5 * IQR보다 큰 값의 백분율을 측정해요.
  • 백분율의 분모에는 프로젝트된 열이 NULL 또는 NaN인 행을 포함해 테이블의 모든 행이 포함돼요.
  • 열에 100개 미만의 NULL·NaN이 아닌 값이 있거나, 필요한 사분위수가 유한(finite)하지 않으면 함수는 0을 반환해요.
  • 이 함수는 최대 약 100억 행의 테이블에 최적화되어 있어요. 이 범위를 넘어서면 평가 대기 시간이 증가하고 메트릭이 DMF 예약 창 내에 완료되지 않을 수 있어요.
  • 이 함수를 평가하면 열을 스캔하고 그 열에 대한 사분위수를 계산하므로 소비되는 서버리스 컴퓨팅(즉 비용)은 테이블 크기에 비례해요. DMF 평가가 어떻게 청구되는지에 대한 정보는 비용 고려 사항(Cost considerations)을 참조해요.

예제 (Example)

finance 테이블의 transaction_amount 열에 대한 이상치 값의 백분율을 측정해요:

SELECT SNOWFLAKE.CORE.OUTLIER_IQR_PERCENT(
  SELECT
    transaction_amount
  FROM finance.public.transactions
);

+------------------------------------------------------------------------------------------------+
| SNOWFLAKE.CORE.OUTLIER_IQR_PERCENT(SELECT transaction_amount FROM finance.public.transactions) |
+------------------------------------------------------------------------------------------------+
| 0.68                                                                                           |
+------------------------------------------------------------------------------------------------+

더 알아보기 (Learn more)

  • 데이터 메트릭 함수 (Data metric functions)
  • 시스템 데이터 메트릭 함수 (System data metric functions)
  • 데이터 품질 모니터링 (Data Quality Monitoring)