DESCRIBE MODEL MONITOR¶

특정 모델 모니터 에 대한 정보를 표시합니다. 이 명령은 SHOW MODEL MONITORS 명령에 표시된 모든 정보와 추가 정보를 표시합니다.

DESCRIBE는 DESC로 축약할 수 있습니다.

참고 항목:: CREATE MODEL MONITOR, ALTER MODEL MONITOR, SHOW MODEL MONITORS, DROP MODEL MONITOR

구문¶

{ DESCRIBE | DESC } MODEL MONITOR <monitor_name>

Copy

매개 변수¶

monitor_name

모델 모니터가 설명할 식별자를 지정합니다.

식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

출력¶

명령 출력은 다음 열에 모델 모니터 속성 및 메타데이터를 제공합니다.

열	설명
`created_on`	모델 모니터가 생성된 날짜 및 시간입니다.
`name`	모델 모니터의 이름입니다.
`database_name`	모델 모니터가 저장된 데이터베이스입니다.
`schema_name`	모델 모니터가 저장된 스키마입니다.
`warehouse_name`	모델을 모니터링하는 데 사용되는 웨어하우스.
`refresh_interval`	모델 모니터의 새로 고침을 트리거하기 위한 새로 고침 간격(대상 지연)입니다.
`aggregation_window`	메트릭을 계산하기 위한 집계 창입니다.
`model_task`	모니터링 중인 모델의 작업으로, TABULAR_BINARY_CLASSIFICATION 또는 TABULAR_REGRESSION 입니다.
`monitor_state`	모델 모니터의 상태입니다. ACTIVE: 모델 모니터가 활동 중이며 올바르게 작동합니다. SUSPENDED: 모델 모니터링이 일시 중지되었습니다. PARTIALLY_SUSPENDED: 기본 테이블 중 하나가 예상된 입력 간격에서 새로 고침을 멈춘 오류 상태입니다. 자세한 내용은 DESCRIBE 섹션을 참조하십시오. UNKNOWN: 기본 테이블의 상태를 식별할 수 없는 오류 상태입니다.
`source`	집계의 기반이 되는 원본 테이블 또는 뷰를 자세히 설명하는 JSON 오브젝트의 문자열 표현입니다. 테이블이 존재하지 않거나 액세스할 수 없는 경우 값은 빈 문자열입니다. 테이블 JSON 오브젝트 사양 섹션을 참조하십시오.
`baseline`	모니터링에 사용되는 기준 테이블을 자세히 설명하는 JSON 오브젝트의 문자열 표현이며, 이 중 복제본이 모델 모니터 오브젝트에 포함되어 있습니다. 테이블 JSON 오브젝트 사양 섹션을 참조하십시오.
`model`	모니터링 중인 모델에 대한 정보를 구체적으로 포함하는 JSON 오브젝트의 문자열 표현입니다. 테이블 JSON 오브젝트 사양 섹션을 참조하십시오.
`comment`	모델 모니터에 대해 설명합니다.
다음 열은 SHOW 와 비교하여 DESCRIBE 에 표시되는 추가 열입니다
`aggregation_status`	중첩된 각 유형의 동적 테이블의 집계 상태를 포함하는 JSON 오브젝트의 문자열 표현입니다. 키는 SOURCE_AGGREGATED 또는 ACCURACY_AGGREGATED 입니다. 값은 ACTIVE 또는 SUSPENDED 입니다.
`aggregation_last_error`	중첩된 각 유형의 동적 테이블의 마지막 오류가 포함된 JSON 오브젝트의 문자열 표현입니다. 키는 SOURCE_AGGREGATED 또는 ACCURACY_AGGREGATED 입니다. 이 값은 오류 메시지이거나 마지막 실행이 성공적으로 완료된 경우 빈 문자열입니다.
`aggregation_last_data_timestamp`	중첩된 동적 테이블의 마지막 시간 유형이 업데이트된 것을 포함하는 JSON 오브젝트의 문자열 표현입니다. 키는 SOURCE_AGGREGATED 또는 ACCURACY_AGGREGATED 입니다. 값은 타임스탬프입니다.
`columns`	중첩된 동적 테이블이 마지막으로 업데이트된 시간 유형을 포함하는 JSON 오브젝트의 문자열 표현입니다. 열 JSON 오브젝트 사양 섹션을 참조하십시오.

테이블 JSON 오브젝트 사양¶

다음은 명령 출력에서 source 및 baseline 열에 사용되는 테이블의 JSON 표현 형식입니다.

`name`	소스 또는 기준 테이블 또는 뷰의 이름입니다.
`database_name`	테이블 또는 뷰가 저장된 데이터베이스입니다.
`schema_name`	테이블 또는 뷰가 저장된 스키마입니다.
`status`	테이블의 상태입니다. ACTIVE: 사용자가 테이블 또는 뷰에 액세스할 수 있습니다. MASKED: 현재 사용자에게 테이블 또는 뷰에 대한 액세스 권한이 없습니다. 다른 필드의 값은 마스킹되어 표시됩니다(즉, 일련의 별표로 표시됨). DELETED: 테이블 또는 뷰가 삭제되었습니다. NOT_SET: 상태가 설정되지 않았습니다.

name

소스 또는 기준 테이블 또는 뷰의 이름입니다.

database_name

테이블 또는 뷰가 저장된 데이터베이스입니다.

schema_name

테이블 또는 뷰가 저장된 스키마입니다.

status

테이블의 상태입니다.

ACTIVE: 사용자가 테이블 또는 뷰에 액세스할 수 있습니다.
MASKED: 현재 사용자에게 테이블 또는 뷰에 대한 액세스 권한이 없습니다. 다른 필드의 값은 마스킹되어 표시됩니다(즉, 일련의 별표로 표시됨).
DELETED: 테이블 또는 뷰가 삭제되었습니다.
NOT_SET: 상태가 설정되지 않았습니다.

모델 JSON 오브젝트 사양¶

다음은 명령 출력의 model 열에서 사용하는 JSON 모델 표현의 형식입니다.

필드	설명
`model_name`	모니터링 중인 모델의 이름입니다.
`version_name`	모니터링 중인 모델 버전의 버전 이름입니다.
`function_name`	지정된 모델 버전에서 모니터링 중인 특정 함수의 이름입니다.
`database_name`	모델이 저장되는 데이터베이스입니다.
`schema_name`	모델이 저장되는 스키마입니다.
`model_status`	모델의 상태입니다. ACTIVE, MASKED 또는 DELETED 일 수 있습니다. MASKED 는 사용자에게 모델에 대한 액세스 권한이 없음을 나타내며, 다른 필드는 일련의 별표로 표시됩니다.
`version_status`	모델 버전의 상태입니다. ACTIVE 또는 DELETED 일 수 있습니다. (MASKED 는 액세스 제어 기능이 없으므로 모델 버전에 유효한 상태가 아닙니다.)

열 JSON 오브젝트 사양¶

다음은 명령 출력에서 columns 열에 사용되는 JSON 열 표현 형식입니다.

필드	설명
`timestamp_column`	데이터 소스에서 타임스탬프 열의 이름입니다.
`id_columns`	소스 데이터의 각 행을 고유하게 식별하는 문자열 열 이름의 배열입니다.
`prediction_class_columns`	데이터 소스에서 모든 예측 클래스 열의 이름을 지정하는 문자열 배열입니다.
`prediction_score_columns`	데이터 소스에서 모든 예측 점수 열의 이름을 지정하는 문자열 배열입니다.
`actual_class_columns`	데이터 소스에서 모든 실제 클래스 열의 이름을 지정하는 문자열 배열입니다.
`numerical_columns`	모델 모니터가 소스 테이블에서 사용하는 모든 숫자 기능 열의 이름을 지정하는 문자열 배열입니다.
`string_columns`	모델 모니터가 소스 테이블에서 사용하는 모든 문자열(범주형) 기능 열의 이름을 지정하는 문자열 배열입니다.
`boolean_columns`	모델 모니터가 소스 테이블에서 사용하는 모든 부울(범주형) 기능 열의 이름을 지정하는 문자열 배열입니다.

액세스 제어 요구 사항¶

이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한	오브젝트	참고
임의	모델 모니터

스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.