DESCRIBE MODEL MONITOR

DESCRIBE MODEL MONITOR

DESCRIBE MODEL MONITOR 명령은 특정 모델 모니터(model monitor)에 대한 정보를 표시하는 명령이에요. DESCRIBE는 DESC로 줄여 쓸 수 있습니다.

출처: DESCRIBE MODEL MONITOR

본문

특정 모델 모니터에 대한 정보를 표시하는 명령입니다. 모델 버전 모니터는 ML Observability를, 게이트웨이 모델 모니터는 Gateway Monitoring & A/B Testing을 참고하세요. 이 명령은 SHOW MODEL MONITORS 명령이 보여주는 모든 정보에 추가 정보를 더해 보여줘요. DESCRIBE는 DESC로 줄여 쓸 수 있습니다.

관련 명령: CREATE MODEL MONITOR, ALTER MODEL MONITOR, SHOW MODEL MONITORS, DROP MODEL MONITOR

Syntax

{ DESCRIBE | DESC } MODEL MONITOR <monitor_name>

Parameters

• monitor_name — 설명할 모델 모니터의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 감싸야 합니다. 큰따옴표로 감싼 식별자는 대소문자를 구분해요. 자세한 내용은 Identifier requirements 문서를 참고하세요.

Output (출력)

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

• 게이트웨이 모델 모니터와 연관된 Snowflake Gateway에 대한 정보를 담은 JSON 객체의 문자열 표현. 모델 버전 모니터의 경우 값은 비어 있어요. Gateway JSON object specification 참고.
• 게이트웨이 모델 모니터의 ground truth 테이블(생성 시 지정된 경우)을 상세히 설명하는 JSON 객체의 문자열 표현. 그 외에는 비어 있어요. Table JSON object specification 참고.
• 모델 모니터의 상태(state).
• 모델 버전 모니터의 경우 집계가 기반이 되는 소스 테이블 또는 뷰를 상세히 설명하는 JSON 객체의 문자열 표현. 게이트웨이 모델 모니터의 경우 값은 비어 있어요. 테이블이 존재하지 않거나 접근할 수 없으면 값은 빈 문자열입니다. Table JSON object specification 참고.
• 모니터링에 사용되는 기준(baseline) 테이블을 상세히 설명하는 JSON 객체의 문자열 표현. 기준 테이블의 클론은 모델 버전 모니터 객체에 내장됩니다. 게이트웨이 모델 모니터의 경우 값은 비어 있어요. Table JSON object specification 참고.
• 모니터링되는 모델에 대한 정보를 구체적으로 담은 JSON 객체의 문자열 표현. Model JSON object specification 참고.
• 각 동적 테이블 유형의 집계 상태를 담은 JSON 객체. 키: 문서를 참고. 값: ACTIVE 또는 SUSPENDED
• 각 동적 테이블 유형의 마지막 오류를 담은 JSON 객체. 키: aggregation_status와 동일. 값: 오류 메시지, 또는 성공 시 빈 문자열
• 각 동적 테이블 유형의 마지막 업데이트 타임스탬프를 담은 JSON 객체. 키: aggregation_status와 동일. 값: 마지막 성공적인 업데이트의 타임스탬프
• 모니터가 사용하는 컬럼 이름을 담은 JSON 객체의 문자열 표현. Column JSON object specification 참고.

Table JSON object specification

소스, 기준, ground_truth 컬럼에서 사용하는 테이블의 JSON 표현 형식은 다음과 같아요. 테이블의 상태(status): 문서를 참고하세요.

Gateway JSON object specification

gateway 컬럼에서 사용하는 게이트웨이의 JSON 표현 형식은 다음과 같아요. 문서를 참고하세요.

Model JSON object specification

model 컬럼에서 사용하는 모델의 JSON 표현 형식은 다음과 같아요. 문서를 참고하세요.

Column JSON object specification

columns 컬럼에서 사용하는 컬럼의 JSON 표현 형식은 다음과 같아요. 문서를 참고하세요.

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

이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 보유해야 해요.

스키마의 객체를 조작하려면 상위 데이터베이스에 대한 권한과 상위 스키마에 대한 권한이 각각 최소 하나씩 필요합니다. 지정된 권한 집합으로 사용자 정의 역할을 만드는 방법은 Creating custom roles 문서를, 보안 객체에 대한 SQL 작업의 역할·권한 부여에 대한 일반적인 정보는 Overview of Access Control 문서를 참고하세요.

Usage notes (사용 참고 사항)

모델 모니터는 모델의 품질·드리프트를 지속적으로 모니터링하는 객체예요.

더 알아보기 (Learn more)

• CREATE MODEL MONITOR
• ALTER MODEL MONITOR
• SHOW MODEL MONITORS
• DROP MODEL MONITOR