SHOW MODEL MONITORS

SHOW MODEL MONITORS 명령은 현재 또는 지정한 스키마에서 접근할 수 있는 모든 모델 모니터(model monitor)를 나열하고 각각에 대한 정보를 표시하는 명령이에요. 모델 버전 모니터링은 ML Observability를, 게이트웨이 모델 모니터는 Gateway Monitoring & A/B Testing을 참고해요.

출처: 문서

본문

이 명령은 접근할 수 있는 모델 모니터를 나열해요.

구문 (Syntax)

SHOW MODEL MONITORS
[ LIKE <pattern> ]
[ IN
    {
      ACCOUNT                  |

      DATABASE                 |
      DATABASE <database_name> |

      SCHEMA                   |
      SCHEMA <schema_name>     |
      <schema_name>            |

      GATEWAY <gateway_name>
    }
 ]

파라미터 (Parameters)

LIKE <pattern> — 명령 출력을 객체 이름으로 필터링해요. 대소문자를 구분하지 않는 패턴 매칭이며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.
[ IN ... ] — 명령의 범위를 선택적으로 지정해요:
- ACCOUNT — 전체 계정의 레코드 반환.
- DATABASE 또는 DATABASE db_name — 현재 또는 지정한 데이터베이스의 레코드 반환.
- SCHEMA 또는 SCHEMA schema_name — 현재 또는 지정한 스키마의 레코드 반환.
- GATEWAY <gateway_name> — 지정한 Snowflake Gateway와 연결된 게이트웨이 모델 모니터를 나열해요. 출력 컬럼은 스키마의 SHOW MODEL MONITORS가 반환하는 것과 일치하지만, 해당 게이트웨이의 GATEWAY_MODEL_MONITOR 유형 모니터만 포함해요.
- IN ...을 생략하면 범위는 세션의 현재 데이터베이스 유무에 따라 달라져요: 있으면 IN DATABASE와 같은 효과, 없으면 IN ACCOUNT와 같은 효과.

출력 (Output)

명령 출력은 모델 모니터 속성과 메타데이터를 다음 컬럼으로 제공해요:

created_on — 모델 모니터가 생성된 날짜·시간.
name — 모델 모니터 이름.
database_name — 모델 모니터가 저장된 데이터베이스.
schema_name — 모델 모니터가 저장된 스키마.
warehouse_name — 모델을 모니터링하는 데 사용되는 웨어하우스.
refresh_interval — 모델 모니터 새로고침을 트리거하는 새로고침 간격(target lag).
aggregation_window — 메트릭을 계산하는 집계 창.
model_task — 모니터링되는 모델의 작업: TABULAR_BINARY_CLASSIFICATION, TABULAR_REGRESSION, 또는 TABULAR_MULTI_CLASSIFICATION.
type — 모니터 유형: MODEL_VERSION_MONITOR 또는 GATEWAY_MODEL_MONITOR.
gateway — 게이트웨이 모델 모니터와 연결된 Snowflake Gateway 정보를 담은 JSON 객체의 문자열 표현. 모델 버전 모니터는 빈 값. (Gateway JSON 객체 사양 참고)
ground_truth — 게이트웨이 모델 모니터의 ground truth 테이블을 상세히 설명하는 JSON 객체의 문자열 표현. 생성 시 지정한 경우에만. 그 외에는 빈 값.
monitor_state — 모델 모니터의 상태: ACTIVE(활성·정상 작동), SUSPENDED(일시 중단), PARTIALLY_SUSPENDED(기본 테이블 중 하나가 예상 간격으로 새로고침을 멈춘 오류 상태), UNKNOWN(기본 테이블 상태를 식별할 수 없는 오류 상태).
source — 모델 버전 모니터의 집계 기준이 되는 소스 테이블·뷰를 상세히 설명하는 JSON 객체의 문자열 표현. 게이트웨이 모델 모니터는 빈 값. 테이블이 없거나 접근할 수 없으면 빈 문자열.
baseline — 모니터링에 사용되는 베이스라인 테이블을 상세히 설명하는 JSON 객체의 문자열 표현. 그 복제본이 모델 버전 모니터 객체에 포함돼요. 게이트웨이 모델 모니터는 빈 값.
model — 모니터링되는 모델에 대한 정보를 담은 JSON 객체의 문자열 표현.
comment — 모델 모니터에 대한 주석.

접근 제어 요구 사항 (Access control requirements)

권한 (Privilege)	대상 (Target)	비고
임의(Any)	모델 모니터	스키마, 데이터베이스, 계정 내 `SHOW MODEL MONITORS`용.
USAGE	게이트웨이	`SHOW MODEL MONITORS IN GATEWAY`용.

사용 참고 사항 (Usage notes)

실행에 실행 중인 웨어하우스를 요구하지 않아요.
현재 역할에 하나 이상의 접근 권한이 부여된 객체만 반환해요.
MANAGE GRANTS 권한은 보유자가 계정의 모든 객체를 볼 수 있게 해줘요. 기본적으로 ACCOUNTADMIN과 SECURITYADMIN 역할만 이 권한을 가져요.
출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요. 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표로 감싸서 사용해요.

더 알아보기 (Learn more)

CREATE MODEL MONITOR — 모델 모니터 만들기
ALTER MODEL MONITOR — 모델 모니터 수정
DESCRIBE MODEL MONITOR — 모델 모니터 상세 확인