SHOW VERSIONS IN MODEL

SHOW VERSIONS IN MODEL

머신 러닝 모델의 버전을 나열하는 명령이에요. 모델은 여러 버전을 가질 수 있으며, 그중 하나가 기본(default)으로 지정되어야 해요(ALTER MODEL 참고). 출력은 테이블 메타데이터와 속성을 데이터베이스, 스키마, 모델 이름 기준 사전순으로 반환해요. 제공된 필터로 결과를 필터링하려면 이 점을 유의해야 해요.

출처: 문서

본문

머신 러닝 모델의 버전을 나열해요. 모델은 여러 버전을 가질 수 있으며, 그중 하나가 기본으로 지정되어야 해요(ALTER MODEL 참고). 출력은 테이블 메타데이터와 속성을 데이터베이스, 스키마, 모델 이름 기준 사전순으로 반환해요. 제공된 필터로 결과를 필터링하려면 이 점을 유의해야 해요.

구문

SHOW VERSIONS [ LIKE '<pattern>' ] IN MODEL <model_name>

매개변수

LIKE 'pattern'

선택적으로 객체 이름으로 명령 출력을 필터링해요. 필터는 SQL 와일드카드 문자(%와 _)를 지원하며 대소문자를 구분하지 않는 패턴 매칭을 사용해요. 예를 들어 다음 패턴들은 같은 결과를 반환해요:

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

기본값: 값 없음(출력에 필터링이 적용되지 않음).

IN MODEL model_name

나열할 버전을 포함하는 모델의 식별자를 지정해요. 식별자에 공백, 특수 문자 또는 대소문자가 섞인 문자가 포함되면 전체 식별자를 큰따옴표로 묶어야 해요. 큰따옴표로 묶은 식별자는 대소문자를 구분해요(예: "My Object"). 모델 식별자가 정규화되지 않은 경우(db_name.schema_name.model_name 또는 schema_name.model_name 형태), 명령은 세션의 현재 스키마에서 모델을 찾아요.

출력

명령 출력은 테이블 속성과 메타데이터를 다음 컬럼으로 제공해요:

컬럼 설명
created_on 모델 버전이 생성된 날짜와 시각이에요.
name 버전의 이름이에요.
aliases 모델 버전의 별칭(있는 경우)이에요. ALTER MODEL로 할당한 별칭과 적용되는 시스템 별칭(DEFAULT, FIRST, LAST)이 포함돼요. 모델 버전에 별칭이 없으면 이 컬럼은 빈 ARRAY([])를 포함해요.
database_name 버전이 저장된 데이터베이스예요.
schema_name 버전이 저장된 스키마예요.
model_name 이 버전이 속한 모델의 이름이에요.
is_default_version 이 버전이 모델의 기본 버전인지 여부를 나타내는 부울 값이에요.
functions 이 버전에서 사용할 수 있는 함수 이름의 JSON 배열이에요.
metadata 키-값 쌍으로 메타데이터를 포함하는 JSON 객체예요(메타데이터가 지정되지 않으면 {}).
user_data 모델 정의 매니페스트(manifest)의 user_data 섹션에 있는 JSON 객체예요(사용자 데이터가 지정되지 않으면 {}).

사용 메모

  • 이 명령은 실행에 웨어하우스가 필요하지 않아요.
  • 이 명령은 현재 사용자의 현재 역할에 액세스 권한이 하나 이상 부여된 객체만 반환해요.
  • MANAGE GRANTS 액세스 권한은 보유자에게 계정의 모든 객체를 볼 수 있는 권한을 암묵적으로 부여해요. 기본적으로 계정 관리자(ACCOUNTADMIN 역할)와 보안 관리자(SECURITYADMIN 역할)만 MANAGE GRANTS 권한을 가져요.
  • 이 명령의 출력을 후처리하려면 파이프 연산자(->>)나 RESULT_SCAN 함수를 사용할 수 있어요. 두 구성 모두 출력을 쿼리할 수 있는 결과 집합으로 취급해요. 예를 들어 SHOW 명령 출력에서 특정 컬럼을 선택하거나 행을 필터링할 수 있어요.
  • 출력 컬럼을 참조할 때는 큰따옴표로 묶은 식별자를 사용해요. 예를 들어 type 출력 컬럼을 선택하려면 SELECT "type"이라고 지정해요. SHOW 명령의 출력 컬럼 이름은 소문자이므로 큰따옴표로 묶은 식별자를 사용해야 해요.

더 알아보기 (Learn more)