CREATE MODEL

현재/지정된 스키마에 새로운 머신 러닝 모델을 생성하거나 기존 모델을 대체합니다.

참고

모델을 처음부터 생성하려면 Snowflake Model Registry Python API를 사용합니다. SQL에서는 다른 모델에서만 모델을 만들 수 있습니다.

모델에는 버전이 지정됩니다. 모든 모델에는 하나 이상의 버전이 있어야 하며, 한 가지 버전을 기본 버전으로 지정해야 합니다. 모델에 버전을 추가하려면 ALTER MODEL … ADD VERSION 을 사용하십시오.

모델의 일부 속성을 수정할 수 있으며(ALTER MODEL 참조), 여러 버전을 추가할 수 있습니다.

이 명령은 다음 베리언트도 지원합니다.

  • CREATE MODEL … FROM internalStage(외부 스테이지의 파일에서 모델 생성)

참고 항목:

ALTER MODEL , ALTER MODEL … ADD VERSION , DROP MODEL , SHOW MODELS

구문

CREATE [ OR REPLACE ] MODEL [ IF NOT EXISTS ] <name> [ WITH VERSION <version_name> ]
    FROM MODEL <source_model_name> [ VERSION <source_version_or_alias_name> ]
Copy

베리언트 구문

이 베리언트는 Snowflake Model Registry Python API에서 사용됩니다. SQL에서는 모델을 처음부터 만들 수 없습니다.

CREATE [ OR REPLACE ] MODEL [ IF NOT EXISTS ] <name> FROM internalStage
Copy

여기서

internalStage ::=
    @[<namespace>.]<int_stage_name>[/<path>]
  | @[<namespace>.]%<table_name>[/<path>]
  | @~[/<path>]
Copy

추가적인 내부 스테이지 세부 정보는 로컬 파일을 위한 내부 스테이지 선택하기 섹션을 참조하십시오.

필수 매개 변수

name

새 모델의 식별자(즉, 이름)를 지정하는 문자열로, 모델이 생성되는 스키마에 대해 고유해야 합니다.

또한, 식별자는 알파벳 문자로 시작해야 하며 전체 식별자 문자열을 큰따옴표(예: "My object")로 묶지 않는 한 공백이나 특수 문자를 포함할 수 없습니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

자세한 내용은 식별자 요구 사항 섹션을 참조하십시오.

FROM MODEL source_model_name
FROM internalStage 베리언트를 사용하지 않는 경우에 필요함

새 모델을 만들 모델의 이름을 지정합니다.

FROM internalStage
FROM internalStage 베리언트를 사용할 경우 필수

모델의 파일이 포함된 내부 스테이지를 지정합니다. 이러한 파일의 필수 레이아웃은 현재 문서화되어 있지 않습니다.

선택적 매개 변수

WITH VERSION version_name
FROM MODEL 베리언트와 함께 사용

새 모델에서 생성할 버전의 이름을 지정합니다.

VERSION source_version_or_alias_name
FROM MODEL 베리언트와 함께 사용

원본 모델에서 복사할 버전의 이름이나 별칭을 지정합니다. 지정하지 않으면 원본 모델의 기본 버전이 사용됩니다.

액세스 제어 요구 사항

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

권한

오브젝트

참고

CREATE MODEL

스키마

스키마에서 USAGE에 의해 암시됨

OWNERSHIP

모델

스키마에 이미 존재하는 오브젝트와 동일한 이름을 가진 임시 오브젝트를 생성하려면 오브젝트에 대한 OWNERSHIP 권한을 역할에 부여하거나 상속해야 합니다.

스키마의 모든 오브젝트에 대해 작업하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한도 필요합니다.

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

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