SHOW MODELS¶
액세스 권한이 있는 머신 러닝 모델을 나열합니다.
출력은 데이터베이스, 스키마, 모델 이름을 기준으로 사전순으로 정렬된 테이블 메타데이터와 속성을 반환합니다(출력 열에 대한 설명은 이 항목의 출력 참조). 제공된 필터를 사용해 결과를 필터링하려는 경우 이 점에 유의해야 합니다.
- 참고 항목:
CREATE MODEL , DROP MODEL , ALTER MODEL, SHOW VERSIONS IN MODEL
구문¶
SHOW MODELS [ LIKE '<pattern>' ]
[ IN { DATABASE [ <db_name> ] | SCHEMA [ <schema_name> ] } ]
매개 변수¶
LIKE 'pattern'
오브젝트 이름으로 명령 출력을 선택적으로 필터링합니다. 이 필터는 SQL 와일드카드 문자(
%
및_
) 지원과 함께 대/소문자를 구분하지 않는 패턴 일치를 사용합니다.예를 들어, 다음 패턴은 같은 결과를 반환합니다.
... LIKE '%testing%' ...
... LIKE '%TESTING%' ...
. 기본값: 값 없음(출력에 필터링이 적용되지 않음).
IN DATABASE [ db_name ] | SCHEMA [ schema_name ]
명령의 범위를 선택적으로 지정하여 이 명령이 현재/지정된 데이터베이스 또는 스키마의 모델만 나열할지 여부를 결정합니다.
키워드
ACCOUNT
를 지정하는 경우 이 명령은 현재 계정의 모든 데이터베이스에 있는 모든 스키마의 레코드를 검색합니다.키워드
DATABASE
를 지정하면 다음 사항이 적용됩니다.db_name
을 지정하는 경우 이 명령은 지정된 데이터베이스의 모든 스키마의 레코드를 검색합니다.db_name
을 지정하지 않으면 다음 사항이 적용됩니다.현재 데이터베이스가 있는 경우 이 명령은 현재 데이터베이스의 모든 스키마의 레코드를 검색합니다.
현재 데이터베이스가 없는 경우 이 명령은 계정의 모든 데이터베이스 및 스키마의 레코드를 검색합니다.
키워드
SCHEMA
를 지정하면 다음 사항이 적용됩니다.정규화된 스키마 이름(예:
my_database.my_schema
)을 지정하는 경우 이 명령은 지정된 데이터베이스 및 스키마의 레코드를 검색합니다.정규화되지 않은
schema_name
을 지정하면 다음 사항이 적용됩니다.현재 데이터베이스가 있는 경우 이 명령은 현재 데이터베이스의 지정된 스키마의 레코드를 검색합니다.
현재 데이터베이스가 없는 경우 이 명령은
SQL compilation error: Object does not exist, or operation cannot be performed
오류 메시지를 표시합니다.
schema_name
을 지정하지 않으면 다음 사항이 적용됩니다.현재 데이터베이스가 있으면 다음 사항이 적용됩니다.
현재 스키마가 있는 경우 이 명령은 현재 데이터베이스의 현재 스키마의 레코드를 검색합니다.
현재 스키마가 없는 경우 이 명령은 현재 데이터베이스의 모든 스키마의 레코드를 검색합니다.
현재 데이터베이스가 없는 경우 이 명령은 계정의 모든 데이터베이스 및 모든 스키마의 레코드를 검색합니다.
기본값: 세션에 현재 사용 중인 데이터베이스가 있는지 여부에 따라 다릅니다.
데이터베이스:
DATABASE
가 기본값입니다(즉, 이 명령은 현재 데이터베이스에서 볼 권한이 있는 모델을 반환함).데이터베이스 없음: 계정 범위가 기본값입니다(즉, 이 명령은 계정에서 볼 권한이 있는 모델을 반환함).
출력¶
명령 출력은 다음 열에 테이블 속성 및 메타데이터를 제공합니다.
열 |
설명 |
---|---|
created_on |
모델이 생성된 날짜 및 시간입니다. |
이름 |
모델의 이름입니다. |
데이터베이스_이름 |
모델이 저장되는 데이터베이스입니다. |
스키마_이름 |
모델이 저장되는 스키마입니다. |
owner |
모델을 소유한 역할입니다. |
comment |
모델에 대한 설명입니다. |
versions |
모델의 JSON 배열 목록 버전입니다. |
default_version_name |
버전이 없는 모델을 참조할 때 사용되는 모델의 버전입니다. |
사용법 노트¶
결과는 순서대로 데이터베이스 이름, 스키마 이름, 모델 이름을 기준으로 정렬됩니다. 이는 데이터베이스 결과에 여러 스키마의 모델이 포함될 수 있으며 페이지 매김이 중단될 수 있음을 의미합니다. 페이지 매김이 예상대로 작동하려면 단일 스키마에 대해 SHOW MODELS 문을 실행해야 합니다. SHOW MODELS 명령에 IN SCHEMA schema_name
매개 변수를 사용할 수 있습니다. 또는 SHOW TABLES 문을 실행하기 전에 USE SCHEMA schema_name
을 실행하여 현재 컨텍스트에서 스키마를 사용할 수 있습니다.