카테고리:

모델 모니터 함수

MODEL_MONITOR_DRIFT_METRIC

모델 모니터 에서 드리프트 메트릭을 가져옵니다. 각 모델 모니터는 하나의 머신 러닝 모델을 모니터링합니다.

참고 항목:

모니터링 결과 쿼리하기 에서 자세한 내용을 확인하십시오.

구문

MODEL_MONITOR_DRIFT_METRIC(
  <model_monitor_name>, <drift_metric_name>, <column_name>
  [ , <granularity> [ , <start_time>  [ , <end_time> ] ] ]
)
Copy

인자

필수:

model_monitor_name

메트릭을 계산하는 데 사용된 모델 모니터의 이름입니다.

유효한 값: 모델 모니터의 이름인 문자열. 단순 또는 정규화된 이름일 수 있습니다.

drift_metric_name

메트릭의 이름입니다.

유효한 값:

  • 'JENSEN_SHANNON'

  • 'DIFFERENCE_OF_MEANS'

  • 'WASSERSTEIN'

column_name

드리프트 계산에 사용되는 열의 이름입니다.

유효한 값: 모델 모니터에서 특성 열, 예측 열 또는 실제 열로 존재하는 모든 문자열.

선택 사항:

granularity

쿼리하는 시간 범위의 세분성. 기본값은 1 DAY 입니다.

유효한 값:

  • '<숫자> DAY'

  • '<숫자> WEEK'

  • '<숫자> MONTH'

  • '<숫자> QUARTER'

  • '<숫자> YEAR'

  • 'ALL'

  • NULL

start_time

메트릭을 계산하는 데 사용되는 시간 범위의 시작입니다. 기본값은 현재 시간으로부터 60일 전이며 함수를 호출할 때마다 계산됩니다.

유효한 값: 타임스탬프 식 또는 NULL.

end_time

메트릭을 계산하는 데 사용되는 시간 범위의 끝입니다. 기본값은 현재 시간이며 함수를 호출할 때마다 계산됩니다.

유효한 값: 타임스탬프 식 또는 NULL.

반환

설명

예제 값

EVENT_TIMESTAMP

시간 범위가 시작될 때의 타임스탬프입니다.

2024-01-01 00:00:00.000

METRIC_VALUE

지정된 시간 범위 내의 메트릭 값입니다.

5

COL_COUNT_USED

메트릭을 계산하는 데 사용된 레코드의 수입니다.

100

COL_COUNT_UNUSED

메트릭 계산에서 제외된 레코드의 수입니다.

10

BASELINE_COL_COUNT_USED

메트릭을 계산하는 데 사용된 레코드의 수입니다.

10

BASELINE_COL_COUNT_UNUSED

메트릭 계산에서 제외된 레코드의 수입니다.

0

METRIC_NAME

계산된 드리프트 메트릭의 이름입니다.

DIFFERENCE_OF_MEANS

COLUMN_NAME

드리프트 메트릭이 계산된 열의 이름입니다.

FEATURE_NAME

사용법 노트

모델 모니터에는 드리프트 메트릭을 계산할 기준선이 설정되어 있어야 합니다.

다음과 같은 경우 오류가 발생할 수 있습니다.

  • 모델 모니터에 대한 기준선을 설정하지 마십시오.

  • 숫자가 아닌 기능에 대한 숫자 드리프트 메트릭을 요청했습니다.

  • 모델 모니터에 존재하지 않는 드리프트 메트릭을 사용합니다.

다음은 하루 기간 동안 MY_MONITOR 에 대한 평균 드리프트 메트릭의 차이를 가져오는 예입니다.

SELECT * FROM TABLE(MODEL_MONITOR_DRIFT_METRIC(
'MY_MONITOR', 'DIFFERENCE_OF_MEANS', 'MODEL_PREDICTION', '1 DAY', TO_TIMESTAMP_TZ('2024-01-01'), TO_TIMESTAMP_TZ('2024-01-02'))
)
Copy

다음은 지난 30일 동안 MY_MONITOR 에 대한 젠슨-섀넌 드리프트 메트릭을 가져오는 예입니다.

SELECT * FROM TABLE(MODEL_MONITOR_DRIFT_METRIC(
'MY_MONITOR', 'JENSEN_SHANNON', 'MODEL_PREDICTION', '1 DAY', DATEADD('DAY', -30, CURRENT_DATE()), CURRENT_DATE())
)
Copy