- 카테고리:
MODEL_MONITOR_DRIFT_METRIC¶
모델 모니터 에서 드리프트 메트릭을 가져옵니다. 각 모델 모니터는 하나의 머신 러닝 모델을 모니터링합니다.
- 참고 항목:
모니터링 결과 쿼리하기 에서 자세한 내용을 확인하십시오.
구문¶
MODEL_MONITOR_DRIFT_METRIC(
<model_monitor_name>, <drift_metric_name>, <column_name>
[ , <granularity> [ , <start_time> [ , <end_time> ] ] ]
)
인자¶
필수:
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
.
반환¶
열 |
설명 |
예제 값 |
---|---|---|
|
시간 범위가 시작될 때의 타임스탬프입니다. |
|
|
지정된 시간 범위 내의 메트릭 값입니다. |
|
|
메트릭을 계산하는 데 사용된 레코드의 수입니다. |
|
|
메트릭 계산에서 제외된 레코드의 수입니다. |
|
|
메트릭을 계산하는 데 사용된 레코드의 수입니다. |
|
|
메트릭 계산에서 제외된 레코드의 수입니다. |
|
|
계산된 드리프트 메트릭의 이름입니다. |
|
|
드리프트 메트릭이 계산된 열의 이름입니다. |
|
사용법 노트¶
모델 모니터에는 드리프트 메트릭을 계산할 기준선이 설정되어 있어야 합니다.
다음과 같은 경우 오류가 발생할 수 있습니다.
모델 모니터에 대한 기준선을 설정하지 마십시오.
숫자가 아닌 기능에 대한 숫자 드리프트 메트릭을 요청했습니다.
모델 모니터에 존재하지 않는 드리프트 메트릭을 사용합니다.
예¶
다음은 하루 기간 동안 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'))
)
다음은 지난 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())
)