Note
이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.
Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.
model-versions 내의 명령 그룹에는 Unity 카탈로그의 모델 레지스트리에서 모델 버전을 관리하는 명령이 포함되어 있습니다. Unity 카탈로그의 모델은 Databricks 작업 영역에서 ML 모델의 중앙 집중식 액세스 제어, 감사, 계보 및 검색을 제공합니다.
Unity 카탈로그에서 모델 수명 주기 관리를 참조하세요.
databricks 모델-버전 삭제 (model-versions delete 명령어)
지정된 등록된 모델에서 모델 버전을 삭제합니다. 모델 버전에 할당된 모든 별칭도 삭제됩니다.
호출자는 메타스토어 관리자이거나 부모 등록 모델의 소유자여야 합니다. 후자의 경우 호출자는 소유자이거나 USE_CATALOG 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.
databricks model-versions delete FULL_NAME VERSION [flags]
Arguments
FULL_NAME
모델 버전의 세 수준(정규화된) 이름
VERSION
모델 버전의 정수 버전 번호
Options
Examples
다음 예제에서는 모델의 버전 1을 삭제합니다.
databricks model-versions delete main.my_schema.my_model 1
databricks 모델 버전 가져오기 (databricks model-versions get)
모델 버전을 가져옵니다.
호출자는 메타스토어 관리자거나, 부모 등록 모델의 소유자이거나, 또는 EXECUTE 권한을 보유해야 합니다. 후자의 경우 호출자는 소유자이거나 USE_CATALOG 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.
databricks model-versions get FULL_NAME VERSION [flags]
Arguments
FULL_NAME
모델 버전의 세 수준(정규화된) 이름
VERSION
모델 버전의 정수 버전 번호
Options
--include-aliases
응답에 모델 버전과 연결된 별칭을 포함할지 여부입니다.
--include-browse
주체가 선택적으로 메타데이터만 액세스할 수 있는 응답에 모델 버전을 포함할지 여부입니다.
Examples
다음 예제에서는 모델의 버전 1을 가져옵니다.
databricks model-versions get main.my_schema.my_model 1
다음 예제에서는 별칭이 포함된 모델의 버전 1을 가져옵니다.
databricks model-versions get main.my_schema.my_model 1 --include-aliases
databricks model-versions get-by-alias
별칭으로 모델 버전을 가져옵니다.
호출자는 메타스토어 관리자이거나 등록된 모델의 소유자 또는 EXECUTE 권한이 있어야 합니다. 후자의 경우 호출자는 소유자이거나 USE_CATALOG 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.
databricks model-versions get-by-alias FULL_NAME ALIAS [flags]
Arguments
FULL_NAME
등록된 모델의 세 수준(정규화된) 이름
ALIAS
별칭의 이름
Options
--include-aliases
응답에 모델 버전과 연결된 별칭을 포함할지 여부입니다.
Examples
다음 예제에서는 별칭으로 모델 버전을 가져옵니다.
databricks model-versions get-by-alias main.my_schema.my_model production
다음 예제에서는 별칭을 사용하여 별칭이 포함된 모델 버전을 가져옵니다.
databricks model-versions get-by-alias main.my_schema.my_model production --include-aliases
databricks 모델-버전 목록
모델 버전을 나열합니다. 특정 스키마 아래에 모델 버전을 나열하거나 현재 메타스토어의 모든 모델 버전을 나열할 수 있습니다.
반환된 모델은 호출하는 사용자의 권한에 따라 필터링됩니다. 예를 들어 metastore 관리자는 모든 모델 버전을 나열할 수 있습니다. 일반 사용자는 소유자이거나 EXECUTE 부모 등록 모델에 대한 권한이 있어야 응답에서 모델 버전을 받을 수 있습니다. 후자의 경우 호출자는 소유자이거나 USE_CATALOG 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.
응답에서 요소의 특정 순서를 보장하지 않습니다. 응답의 요소에는 별칭이나 태그가 포함되지 않습니다.
databricks model-versions list FULL_NAME [flags]
Arguments
FULL_NAME
모델 버전을 나열할 등록된 모델의 전체 3단계 이름
Options
--include-browse
주체가 선택적으로 메타데이터만 액세스할 수 있는 응답에 모델 버전을 포함할지 여부입니다.
--max-results int
반환할 모델 버전의 최대 수입니다.
--page-token string
이전 쿼리를 기반으로 다음 페이지로 이동하기 위한 불투명 페이지네이션 토큰입니다.
Examples
다음 예제에서는 등록된 모델의 모든 모델 버전을 나열합니다.
databricks model-versions list main.my_schema.my_model
다음 예제에서는 페이지 매김이 있는 모델 버전을 나열합니다.
databricks model-versions list main.my_schema.my_model --max-results 10 --page-token abc123token
databricks 모델 버전 업데이트
지정된 모델 버전을 업데이트합니다.
호출자는 메타스토어 관리자이거나 부모 등록 모델의 소유자여야 합니다. 후자의 경우 호출자는 소유자이거나 USE_CATALOG 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.
현재 모델 버전의 주석만 업데이트할 수 있습니다.
databricks model-versions update FULL_NAME VERSION [flags]
Arguments
FULL_NAME
모델 버전의 세 수준(정규화된) 이름
VERSION
모델 버전의 정수 버전 번호
Options
--comment string
모델 버전에 연결된 주석입니다.
--json JSON
요청 본문과 함께 인라인 JSON 문자열 또는 @path JSON 파일에 대한 문자열
Examples
다음 예제에서는 모델 버전 주석을 업데이트합니다.
databricks model-versions update main.my_schema.my_model 1 --comment "Updated model with improved accuracy"
다음 예제에서는 JSON 파일을 사용하여 모델 버전을 업데이트합니다.
databricks model-versions update main.my_schema.my_model 1 --json @model-version-update.json
전역 표시기
--debug
디버그 로깅을 사용할지 여부입니다.
-h 또는 --help
Databricks CLI 또는 관련 명령 그룹 또는 관련 명령에 대한 도움말을 표시합니다.
--log-file 문자열
출력 로그를 쓸 파일을 나타내는 문자열입니다. 이 플래그가 지정되지 않으면 출력 로그는 기본적으로 stderr에 기록됩니다.
--log-format 포맷
로그 형식 형식 text 또는 json. 기본값은 text입니다.
--log-level 문자열
로그 형식 수준을 나타내는 문자열입니다. 지정하지 않으면 로그 형식 수준을 사용할 수 없습니다.
-o, --output 유형
명령 출력 형식 text 또는 json. 기본값은 text입니다.
-p, --profile 문자열
명령을 실행하는 데 사용할 파일의 프로필 ~/.databrickscfg 이름입니다. 이 플래그를 지정하지 않으면, 존재하는 경우 DEFAULT로 명명된 프로필이 사용됩니다.
--progress-format 포맷
진행률 로그를 표시할 형식: default, append, inplace또는 json
-t, --target 문자열
해당하는 경우 사용할 번들 대상