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``(비세그먼트) `SOURCE_AGGREGATED_<segment_column>`/``ACCURACY_AGGREGATED_<segment_column>``(세그먼트별) 값: `ACTIVE` 또는 `SUSPENDED`
`aggregation_last_error`	각 동적 테이블 유형에 대한 마지막 오류가 포함된 JSON 오브젝트입니다. 키: ``aggregation_status``와 동일 값: 오류 메시지 또는 성공 시 빈 문자열
`aggregation_last_data_timestamp`	각 동적 테이블 유형에 대한 마지막 업데이트 타임스탬프가 포함된 JSON 오브젝트입니다. 키: ``aggregation_status``와 동일 값: 마지막으로 성공한 업데이트의 타임스탬프
`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`	모델 모니터가 소스 테이블에서 사용하는 모든 부울(범주형) 기능 열의 이름을 지정하는 문자열 배열입니다.
`segment_columns`	데이터 소스의 모든 세그먼트 열의 이름을 지정하는 문자열 배열입니다. 세그먼트 없이 생성된 기존 모델 모니터의 경우 이 필드는 빈 배열입니다.

액세스 제어 요구 사항¶

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

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

스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한. 스키마에 대한 모든 권한이 부여된 역할은 스키마를 확인할 수 있습니다. 예를 들어, 스키마에 대해 CREATE 권한을 부여받은 역할은 해당 스키마에 대한 USAGE 권한을 함께 부여받지 않더라도 해당 스키마에 대한 오브젝트를 생성할 수 있습니다.

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

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

사용법 노트¶

이 명령의 출력을 후처리하기 위해 파이프 연산자 (->>) 또는 RESULT_SCAN 함수를 사용할 수 있습니다. 두 구문 모두 출력을 쿼리할 수 있는 결과 세트로 간주합니다.

For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.

When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column type, specify SELECT "type".

You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.