SHOW MODELS

SHOW MODELS 명령은 접근 권한(privilege)이 있는 머신 러닝 모델 목록을 보여주는 명령이에요.

출처: 문서

본문

이 명령은 접근 권한이 있는 머신 러닝 모델을 나열해요. 출력은 데이터베이스, 스키마, 모델 이름 기준 사전 순으로 정렬된 메타데이터와 속성을 반환해요.

SHOW MODELS [ LIKE '<pattern>' ]
            [ IN { DATABASE [ <db_name> ] | SCHEMA [ <schema_name> ] } ]

LIKE <pattern> — 명령 출력을 객체 이름으로 필터링해요. 대소문자를 구분하지 않는 패턴 매칭이며 SQL 와일드카드 문자(%와 _)를 지원해요. 기본값: 없음.
IN { DATABASE [ <db_name> ] | SCHEMA [ <schema_name> ] } — 명령의 범위를 지정해요. 지정한 데이터베이스 또는 스키마의 모델만 나열해요. 기본값: 세션에 현재 데이터베이스가 있으면 현재 데이터베이스(범위 DATABASE), 없으면 계정 범위(ACCOUNT)가 기본.

명령 출력은 다음 컬럼을 포함해요:

created_on — 모델이 생성된 날짜·시간.
name — 모델 이름.
model_type — 모델 유형. 사용자 코드를 포함한 모델은 USER_MODEL, Cortex Fine-tuning으로 만든 모델은 CORTEX_FINETUNED.
database_name — 모델이 저장된 데이터베이스.
schema_name — 모델이 저장된 스키마.
owner — 모델을 소유한 역할.
comment — 모델에 대한 주석.
versions — 모델 버전을 나열하는 JSON 배열.
default_version_name — 버전 없이 모델을 참조할 때 사용되는 모델 버전.
aliases — 모델 버전 별칭을 해당 모델 버전 이름에 매핑하는 SQL 객체.

결과는 데이터베이스 이름, 스키마 이름, 모델 이름 순으로 정렬돼요. 이는 한 데이터베이스의 결과에 여러 스키마의 모델이 포함될 수 있고 페이지네이션을 깨뜨릴 수 있음을 의미해요. 페이지네이션이 예상대로 작동하려면 단일 스키마에 대해 SHOW MODELS 문을 실행해야 해요. SHOW MODELS 명령에 IN SCHEMA <schema_name> 파라미터를 사용하거나, SHOW MODELS 실행 전에 USE SCHEMA <schema_name>을 실행해 현재 컨텍스트의 스키마를 사용할 수 있어요.
실행에 실행 중인 웨어하우스를 요구하지 않아요.
현재 역할에 하나 이상의 접근 권한이 부여된 객체만 반환해요.
MANAGE GRANTS 권한은 보유자가 계정의 모든 객체를 볼 수 있게 해줘요. 기본적으로 ACCOUNTADMIN과 SECURITYADMIN 역할만 이 권한을 가져요.
출력을 후처리하려면 파이프 연산자(|>) 또는 RESULT_SCAN 함수를 사용할 수 있어요. 출력 컬럼을 참조할 때는 컬럼 이름을 큰따옴표로 감싸서 사용해요.