SHOW MODELS

액세스 권한이 있는 머신 러닝 모델을 나열합니다.

출력은 데이터베이스, 스키마, 모델 이름을 기준으로 사전순으로 정렬된 테이블 메타데이터와 속성을 반환합니다(출력 열에 대한 설명은 이 항목의 출력 참조). 제공된 필터를 사용해 결과를 필터링하려는 경우 이 점에 유의해야 합니다.

참고 항목:

CREATE MODEL , DROP MODEL , ALTER MODEL, SHOW VERSIONS IN MODEL

구문

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

매개 변수

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

모델이 생성된 날짜 및 시간입니다.

이름

모델의 이름입니다.

model_type

모델 유형으로, 사용자 코드가 포함된 모델의 경우 USER_MODEL이고 Cortex Fine-tuning 으로 생성된 모델의 경우 CORTEX_FINETUNED입니다.

데이터베이스_이름

모델이 저장되는 데이터베이스입니다.

스키마_이름

모델이 저장되는 스키마입니다.

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 역할이 있는 사용자)만 MANAGE GRANTS 권한을 가집니다.

  • 이 명령의 출력을 후처리하기 위해 파이프 연산자 (->>) 또는 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.