Note
이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.
Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.
registered-models 내의 명령 그룹에는 Unity 카탈로그의 모델 레지스트리에서 모델을 관리하는 명령이 포함되어 있습니다. 등록된 모델은 Databricks 작업 영역에서 ML 모델의 중앙 집중식 액세스 제어, 감사, 계보 및 검색을 제공합니다.
Unity 카탈로그에서 모델 수명 주기 관리를 참조하세요.
databricks 등록된 모델 생성
Unity 카탈로그에 등록된 새 모델을 만듭니다.
등록된 모델의 모델 버전에 대한 파일 스토리지는 부모 스키마 또는 부모 카탈로그 또는 Metastore로 지정된 기본 위치에 있습니다.
등록된 모델 만들기가 성공하려면 사용자가 다음 조건을 충족해야 합니다.
- 호출자는 메타스토어 관리자이거나 부모 카탈로그 및 스키마
USE_CATALOG의 소유자이거나 부모 카탈로그에 대한 권한과USE_SCHEMA부모 스키마에 대한 권한이 있어야 합니다. - 호출자는 부모 스키마에 대한
CREATE MODEL또는CREATE FUNCTION권한이 있어야 합니다.
databricks registered-models create CATALOG_NAME SCHEMA_NAME NAME [flags]
Arguments
CATALOG_NAME
스키마와 등록된 모델이 있는 카탈로그의 이름입니다.
SCHEMA_NAME
등록된 모델이 있는 스키마의 이름입니다.
NAME
등록된 모델의 이름입니다.
Options
--comment string
등록된 모델에 첨부된 주석입니다.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
--storage-location string
모델 버전 데이터 파일이 저장되는 클라우드의 스토리지 위치입니다.
Examples
다음 예제에서는 지정된 카탈로그 및 스키마에 등록된 모델을 만듭니다.
databricks registered-models create main my_schema my_model
다음 예제에서는 주석을 사용하여 등록된 모델을 만듭니다.
databricks registered-models create main my_schema my_model --comment "My model description"
databricks 등록된 모델 삭제 (databricks registered-models delete)
지정된 부모 카탈로그 및 스키마에서 등록된 모델 및 해당 모델 버전을 모두 삭제합니다.
호출자는 메타스토어 관리자이거나 등록된 모델의 소유자여야 합니다. 후자의 경우 호출자는 소유자이거나 USE_CATALOG 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.
databricks registered-models delete FULL_NAME [flags]
Arguments
FULL_NAME
등록된 모델의 세 수준(정규화된) 이름입니다.
Options
Examples
다음 예제에서는 등록된 모델을 삭제합니다.
databricks registered-models delete main.my_schema.my_model
databricks의 등록된-모델 delete-alias
등록된 모델 별칭을 삭제합니다.
호출자는 메타스토어 관리자이거나 등록된 모델의 소유자여야 합니다. 후자의 경우 호출자는 소유자이거나 USE_CATALOG 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.
databricks registered-models delete-alias FULL_NAME ALIAS [flags]
Arguments
FULL_NAME
등록된 모델의 세 수준(정규화된) 이름입니다.
ALIAS
별칭의 이름입니다.
Options
Examples
다음 예제에서는 등록된 모델 별칭을 삭제합니다.
databricks registered-models delete-alias main.my_schema.my_model production
databricks registered-models get (데이터브릭스 등록된 모델 가져오기)
등록된 모델을 가져옵니다.
호출자는 메타스토어 관리자이거나 등록된 모델의 소유자 또는 EXECUTE 권한이 있어야 합니다. 후자의 경우 호출자는 소유자이거나 USE_CATALOG 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.
databricks registered-models get FULL_NAME [flags]
Arguments
FULL_NAME
등록된 모델의 세 수준(정규화된) 이름입니다.
Options
--include-aliases
응답에 등록된 모델 별칭을 포함할지 여부입니다.
--include-browse
사용자가 선택적 메타데이터에만 접근할 수 있는 경우의 등록된 모델을 응답에 포함할지 여부입니다.
Examples
다음 예제에서는 등록된 모델에 대한 정보를 가져옵니다.
databricks registered-models get main.my_schema.my_model
다음 예제에서는 별칭을 포함하여 등록된 모델에 대한 정보를 가져옵니다.
databricks registered-models get main.my_schema.my_model --include-aliases
databricks 등록된 모델 목록 (registered-models list)
등록된 모델을 나열합니다. 특정 스키마 아래에 등록된 모델을 나열하거나 현재 메타스토어에 등록된 모든 모델을 나열할 수 있습니다.
반환된 모델은 호출하는 사용자의 권한에 따라 필터링됩니다. 예를 들어 메타스토어 관리자는 등록된 모든 모델을 나열할 수 있습니다. 일반 사용자는 소유자이거나 EXECUTE 등록된 모델에 대한 권한이 있어야 응답에 등록된 모델을 받을 수 있습니다. 후자의 경우 호출자는 소유자이거나 USE_CATALOG 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.
응답에서 요소의 특정 순서를 보장하지 않습니다.
databricks registered-models list [flags]
Options
--catalog-name string
등록된 모델을 나열할 카탈로그의 식별자입니다.
--include-browse
사용자가 선택적 메타데이터에만 접근할 수 있는 경우의 등록된 모델을 응답에 포함할지 여부입니다.
--max-results int
반환할 등록된 모델의 최대 수입니다.
--page-token string
결과의 다음 페이지(페이지 매김)에 대해 보낼 불투명 토큰입니다.
--schema-name string
등록된 모델을 나열할 스키마의 식별자입니다.
Examples
다음 예제에서는 현재 메타스토어에 등록된 모든 모델을 나열합니다.
databricks registered-models list
다음 예제에서는 특정 카탈로그에 등록된 모델을 나열합니다.
databricks registered-models list --catalog-name main
다음 예제에서는 특정 스키마에 등록된 모델을 나열합니다.
databricks registered-models list --catalog-name main --schema-name my_schema
Databricks 등록된-모델별 별칭-설정
지정된 등록된 모델에 별칭을 설정합니다.
호출자는 메타스토어 관리자이거나 등록된 모델의 소유자여야 합니다. 후자의 경우 호출자는 소유자이거나 USE_CATALOG 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.
databricks registered-models set-alias FULL_NAME ALIAS VERSION_NUM [flags]
Arguments
FULL_NAME
등록된 모델의 전체 이름입니다.
ALIAS
별칭의 이름입니다.
VERSION_NUM
별칭이 가리키는 모델 버전의 버전 번호입니다.
Options
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
Examples
다음 예제에서는 등록된 모델에 별칭을 설정합니다.
databricks registered-models set-alias main.my_schema.my_model production 1
databricks 등록된 모델 업데이트
지정된 등록된 모델을 업데이트합니다.
호출자는 메타스토어 관리자이거나 등록된 모델의 소유자여야 합니다. 후자의 경우 호출자는 소유자이거나 USE_CATALOG 부모 카탈로그에 대한 권한과 USE_SCHEMA 부모 스키마에 대한 권한이 있어야 합니다.
현재는 등록된 모델의 이름, 소유자 또는 주석만 업데이트할 수 있습니다.
databricks registered-models update FULL_NAME [flags]
Arguments
FULL_NAME
등록된 모델의 세 수준(정규화된) 이름입니다.
Options
--comment string
등록된 모델에 첨부된 주석입니다.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
'--new-name 문자열'**
등록된 모델의 새 이름입니다.
--owner string
등록된 모델을 소유한 사용자의 식별자입니다.
Examples
다음 예제에서는 등록된 모델의 주석을 업데이트합니다.
databricks registered-models update main.my_schema.my_model --comment "Updated model description"
다음 예제에서는 등록된 모델의 이름을 업데이트합니다.
databricks registered-models update main.my_schema.my_model --new-name my_new_model
전역 표시기
--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 문자열
해당하는 경우 사용할 번들 대상