Note
이 정보는 Databricks CLI 버전 0.205 이상에 적용됩니다. Databricks CLI는 공개 미리 보기로 제공됩니다.
Databricks CLI 사용은 Databricks 라이선스 및 Databricks 개인 정보 보호 고지, 그리고 모든 사용 데이터 관련 조항의 적용을 받습니다.
Note
이 API 참조는 작업 영역 모델 레지스트리에 대한 API를 문서화합니다. Databricks는 대신 Unity 카탈로그에서 모델을 사용하는 것이 좋습니다. Unity 카탈로그의 모델은 중앙 집중식 모델 거버넌스, 작업 영역 간 액세스, 계보 및 배포를 제공합니다. 작업 영역 모델 레지스트리는 향후 더 이상 사용되지 않습니다.
model-registry
Databricks CLI 내의 명령 그룹을 사용하면 MLflow 모델의 전체 수명 주기를 관리할 수 있습니다. 작업 영역 모델 레지스트리는 MLflow 모델의 전체 수명 주기를 관리할 수 있는 중앙 집중식 모델 리포지토리 및 UI 및 API 집합입니다.
databricks 모델-레지스트리 승인-전환-요청
모델 버전 단계 전환 요청을 승인합니다.
databricks model-registry approve-transition-request NAME VERSION STAGE ARCHIVE_EXISTING_VERSIONS [flags]
Arguments
NAME
모델의 이름입니다.
VERSION
모델의 버전입니다.
STAGE
전환의 목표 단계입니다. 지원되는 값: Archived, None, ProductionStaging
ARCHIVE_EXISTING_VERSIONS
대상 단계에서 모든 현재 모델 버전을 보관할지 여부를 지정합니다.
Options
--comment string
사용자가 제공한 작업에 대한 설명입니다.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
Databricks 모델 레지스트리 create-comment
모델 버전에 댓글을 게시합니다. 사용자가 주석을 제출하거나 프로그래밍 방식으로 제출하여 모델에 대한 관련 정보를 표시할 수 있습니다. 예를 들어 테스트 결과 또는 배포 오류입니다.
databricks model-registry create-comment NAME VERSION COMMENT [flags]
Arguments
NAME
모델의 이름입니다.
VERSION
모델의 버전입니다.
COMMENT
사용자가 제공한 작업에 대한 설명입니다.
Options
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
databricks 모델 레지스트리 모델 생성
요청 본문에 지정된 이름을 사용하여 등록된 새 모델을 만듭니다.
지정된 이름의 등록된 모델이 있는 경우 RESOURCE_ALREADY_EXISTS throw합니다.
databricks model-registry create-model NAME [flags]
Arguments
NAME
이 이름 아래에 모델 등록
Options
--description string
등록된 모델에 대한 선택적 설명입니다.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
databricks model-registry 모델 버전 생성
모델 버전을 만듭니다.
databricks model-registry create-model-version NAME SOURCE [flags]
Arguments
NAME
이 이름 아래에 모델 등록
SOURCE
모델 아티팩트 위치를 나타내는 URI입니다.
Options
--description string
모델 버전에 대한 선택적 설명입니다.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
--run-id string
MLflow 추적 서버에서 실험 실행에 의해 원본이 생성된 경우 상관 관계에 대한 MLflow 실행 ID입니다.
--run-link string
MLflow 실행 링크 - 이 모델 버전을 생성한 실행의 정확한 링크이며 잠재적으로 다른 MLflow 인스턴스에서 호스트됩니다.
databricks 모델 레지스트리 create-transition-request 요청 생성
모델 버전 단계 전환 요청을 만듭니다.
databricks model-registry create-transition-request NAME VERSION STAGE [flags]
Arguments
NAME
모델의 이름입니다.
VERSION
모델의 버전입니다.
STAGE
전환의 목표 단계입니다. 유효한 값은 다음과 같습니다.
- 없음: 모델 버전의 초기 단계입니다.
- 스테이징: 스테이징 또는 사전 프로덕션 단계.
- 프로덕션: 프로덕션 단계.
- 보관됨: 보관 단계입니다.
지원되는 값: [보관됨, 없음, 프로덕션, 스테이징]
Options
--comment string
사용자가 제공한 작업에 대한 설명입니다.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
databricks 모델-레지스트리 create-webhook (생성 웹훅)
Note
이 명령은 공개 미리 보기로 제공됩니다.
레지스트리 웹후크를 만듭니다.
databricks model-registry create-webhook [flags]
Arguments
None
Options
--description string
웹후크에 대한 사용자 지정 설명입니다.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
--model-name string
웹후크를 트리거하는 이벤트가 발생하는 모델의 이름입니다.
--status RegistryWebhookStatus
웹후크 트리거를 사용하거나 사용하지 않도록 설정하거나 웹후크를 테스트 모드로 전환합니다. 지원되는 값: [활성화, 비활성화, 테스트 모드]
데이터브릭스 모델 레지스트리 댓글 삭제
모델 버전에 대한 주석을 삭제합니다.
databricks model-registry delete-comment ID [flags]
Arguments
ID
삭제할 주석의 고유 식별자입니다.
Options
databricks 모델-레지스트리 삭제 모델
등록된 모델을 삭제합니다.
databricks model-registry delete-model NAME [flags]
Arguments
NAME
등록된 모델의 고유한 이름 식별자입니다.
Options
Databricks 모델 레지스트리에서 모델 태그 삭제 (databricks model-registry delete-model-tag)
등록된 모델의 태그를 삭제합니다.
databricks model-registry delete-model-tag NAME KEY [flags]
Arguments
NAME
태그가 기록된 등록된 모델의 이름입니다.
KEY
태그의 이름입니다. 이름은 정확히 일치해야 합니다. 와일드카드 삭제는 지원되지 않습니다. 최대 크기는 250바이트입니다.
Options
databricks 모델 레지스트리 삭제-모델-버전
모델 버전을 삭제합니다.
databricks model-registry delete-model-version NAME VERSION [flags]
Arguments
NAME
등록된 모델의 이름
VERSION
모델 버전 번호
Options
Databricks 모델 레지스트리에서 delete-model-version-tag 실행하기
모델 버전 태그를 삭제합니다.
databricks model-registry delete-model-version-tag NAME VERSION KEY [flags]
Arguments
NAME
태그가 기록된 등록된 모델의 이름입니다.
VERSION
태그가 기록된 모델 버전 번호입니다.
KEY
태그의 이름입니다. 이름은 정확히 일치해야 합니다. 와일드카드 삭제는 지원되지 않습니다. 최대 크기는 250바이트입니다.
Options
databricks 모델-레지스트리 전환 요청 삭제
모델 버전 단계 전환 요청을 취소합니다.
databricks model-registry delete-transition-request NAME VERSION STAGE CREATOR [flags]
Arguments
NAME
모델의 이름입니다.
VERSION
모델의 버전입니다.
STAGE
전환 요청의 대상 단계입니다. 유효한 값은 다음과 같습니다.
- 없음: 모델 버전의 초기 단계입니다.
- 스테이징: 스테이징 또는 사전 프로덕션 단계.
- 프로덕션: 프로덕션 단계.
- 보관됨: 보관 단계입니다.
지원되는 값: [보관됨, 없음, 프로덕션, 스테이징]
CREATOR
이 요청을 만든 사용자의 사용자 이름입니다. 지정된 세부 정보와 일치하는 전환 요청 중 이 사용자가 만든 하나의 전환만 삭제됩니다.
Options
--comment string
사용자가 제공한 작업에 대한 설명입니다.
데이터브릭스 모델-레지스트리 삭제-웹훅
Note
이 명령은 공개 미리 보기로 제공됩니다.
레지스트리 웹후크를 삭제합니다.
databricks model-registry delete-webhook [flags]
Arguments
None
Options
--id string
레지스트리 웹후크를 삭제하는 데 필요한 웹후크 ID입니다.
The text might remain untranslated due to its command-line specificity, common in technical documentation, where retaining the original term is often needed for accuracy. However, if a translation is preferred: databricks 모델 레지스트리 최신 버전 가져오기
등록된 모델의 최신 버전을 가져옵니다.
databricks model-registry get-latest-versions NAME [flags]
Arguments
NAME
등록된 모델의 고유한 이름 식별자입니다.
Options
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
Databricks 모델 레지스트리에서 모델 가져오기 (databricks model-registry get-model 명령어 사용)
모델의 세부 정보를 가져옵니다. 모델의 Databricks 작업 영역 ID와 모델에 대해 요청하는 사용자의 권한 수준도 반환하는 MLflow 엔드포인트 의 Databricks 작업 영역 버전입니다.
databricks model-registry get-model NAME [flags]
Arguments
NAME
등록된 모델의 고유한 이름 식별자입니다.
Options
databricks model-registry get-model-version (모델 레지스트리에서 모델 버전을 가져오는 명령)
모델 버전을 가져옵니다.
databricks model-registry get-model-version NAME VERSION [flags]
Arguments
NAME
등록된 모델의 이름
VERSION
모델 버전 번호
Options
databricks 모델-레지스트리 get-model-version-download-uri
모델 버전을 다운로드하는 URI를 가져옵니다.
databricks model-registry get-model-version-download-uri NAME VERSION [flags]
Arguments
NAME
등록된 모델의 이름
VERSION
모델 버전 번호
Options
databricks 모델 레지스트리 list-models 명령어
지정된 max_results을(를) 넘지 않도록 사용 가능한 모든 등록된 모델을 나열합니다.
databricks model-registry list-models [flags]
Arguments
None
Options
--max-results int
원하는 등록된 모델의 최대 수입니다.
--page-token string
이전 쿼리를 기반으로 다음 페이지로 이동하는 페이지 매김 토큰입니다.
databricks 모델 레지스트리 전환 요청 목록
모델 버전에 대한 열려 있는 모든 단계 전환 요청 목록을 가져옵니다.
databricks model-registry list-transition-requests NAME VERSION [flags]
Arguments
NAME
모델의 이름입니다.
VERSION
모델의 버전입니다.
Options
databricks model-registry list-webhooks
Note
이 명령은 공개 미리 보기로 제공됩니다.
모든 레지스트리 웹후크를 나열합니다.
databricks model-registry list-webhooks [flags]
Arguments
None
Options
--model-name string
지정하지 않으면 연결된 모델에 관계없이 지정된 이벤트와 연결된 모든 웹후크가 나열됩니다.
--page-token string
가져올 아티팩트 결과의 페이지를 나타내는 토큰입니다.
databricks 모델-레지스트리 전환 요청 거부
모델 버전 단계 전환 요청을 거부합니다.
databricks model-registry reject-transition-request NAME VERSION STAGE [flags]
Arguments
NAME
모델의 이름입니다.
VERSION
모델의 버전입니다.
STAGE
전환의 목표 단계입니다. 유효한 값은 다음과 같습니다.
- 없음: 모델 버전의 초기 단계입니다.
- 스테이징: 스테이징 또는 사전 프로덕션 단계.
- 프로덕션: 프로덕션 단계.
- 보관됨: 보관 단계입니다.
지원되는 값: [보관됨, 없음, 프로덕션, 스테이징]
Options
--comment string
사용자가 제공한 작업에 대한 설명입니다.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
databricks model-registry rename-model
등록된 모델의 이름을 바꿉니다.
databricks model-registry rename-model NAME [flags]
Arguments
NAME
등록된 모델의 고유한 이름 식별자입니다.
Options
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
--new-name string
제공된 경우 이 registered_model 이름을 업데이트합니다.
databricks 모델 레지스트리 search-model-versions
제공된 필터를 기반으로 특정 모델 버전을 검색합니다.
databricks model-registry search-model-versions [flags]
Arguments
None
Options
--filter string
문자열 필터 조건(예: "name='my-model-name'")입니다.
--max-results int
원하는 최대 모델 수입니다.
--page-token string
이전 검색 쿼리에 따라 다음 페이지로 이동하는 페이지 매김 토큰입니다.
databricks 모델 레지스트리 검색 모델
지정된 필터를 기반으로 등록된 모델을 검색합니다.
databricks model-registry search-models [flags]
Arguments
None
Options
--filter string
문자열 필터 조건으로, 예를 들면 "name LIKE 'my-model-name'" 과 같습니다.
--max-results int
원하는 최대 모델 수입니다.
--page-token string
이전 검색 쿼리에 따라 다음 페이지로 이동하는 페이지 매김 토큰입니다.
databricks model-registry set-model-tag
등록된 모델에 태그를 설정합니다.
databricks model-registry set-model-tag NAME KEY VALUE [flags]
Arguments
NAME
모델의 고유 이름입니다.
KEY
태그의 이름입니다. 최대 크기는 스토리지 백 엔드에 따라 달라집니다. 이 이름의 태그가 이미 있는 경우 기존 값이 지정된 값으로 바뀝니다. 모든 스토리지 백 엔드는 최대 250바이트 크기의 키 값을 지원하도록 보장됩니다.
VALUE
기록되는 태그의 문자열 값입니다. 최대 크기는 스토리지 백 엔드에 따라 달라집니다. 모든 스토리지 백 엔드는 최대 5,000바이트 크기의 키 값을 지원하도록 보장됩니다.
Options
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
Databricks 모델-레지스트리 set-model-version-tag (모델 버전 태그 설정)
모델 버전 태그를 설정합니다.
databricks model-registry set-model-version-tag NAME VERSION KEY VALUE [flags]
Arguments
NAME
모델의 고유 이름입니다.
VERSION
모델 버전 번호입니다.
KEY
태그의 이름입니다. 최대 크기는 스토리지 백 엔드에 따라 달라집니다. 이 이름의 태그가 이미 있는 경우 기존 값이 지정된 값으로 바뀝니다. 모든 스토리지 백 엔드는 최대 250바이트 크기의 키 값을 지원하도록 보장됩니다.
VALUE
기록되는 태그의 문자열 값입니다. 최대 크기는 스토리지 백 엔드에 따라 달라집니다. 모든 스토리지 백 엔드는 최대 5,000바이트 크기의 키 값을 지원하도록 보장됩니다.
Options
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
databricks 모델-레지스트리 테스트-레지스트리-웹훅
Note
이 명령은 공개 미리 보기로 제공됩니다.
레지스트리 웹후크를 테스트합니다.
databricks model-registry test-registry-webhook ID [flags]
Arguments
ID
웹후크 ID
Options
--event RegistryWebhookEvent
이벤트가 지정된 경우 테스트 트리거는 지정된 이벤트를 사용합니다. 지원되는 값: [ COMMENT_CREATED, MODEL_VERSION_CREATED, MODEL_VERSION_TAG_SET, MODEL_VERSION_TRANSITIONED_STAGE, MODEL_VERSION_TRANSITIONED_TO_ARCHIVED, MODEL_VERSION_TRANSITIONED_TO_PRODUCTION, MODEL_VERSION_TRANSITIONED_TO_STAGING, REGISTERED_MODEL_CREATED, TRANSITION_REQUEST_CREATED, TRANSITION_REQUEST_TO_ARCHIVED_CREATED, TRANSITION_REQUEST_TO_PRODUCTION_CREATED, TRANSITION_REQUEST_TO_STAGING_CREATED ]
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
databricks 모델 레지스트리 전환 단계
모델 버전의 단계를 전환합니다. 기록할 전환과 관련된 주석도 허용하는 MLflow 엔드포인트 의 Databricks 작업 영역 버전입니다.
databricks model-registry transition-stage NAME VERSION STAGE ARCHIVE_EXISTING_VERSIONS [flags]
Arguments
NAME
모델의 이름입니다.
VERSION
모델의 버전입니다.
STAGE
전환의 목표 단계입니다. 유효한 값은 다음과 같습니다.
- 없음: 모델 버전의 초기 단계입니다.
- 스테이징: 스테이징 또는 사전 프로덕션 단계.
- 프로덕션: 프로덕션 단계.
- 보관됨: 보관 단계입니다.
지원되는 값: [보관됨, 없음, 프로덕션, 스테이징]
ARCHIVE_EXISTING_VERSIONS
대상 단계에서 모든 현재 모델 버전을 보관할지 여부를 지정합니다.
Options
--comment string
사용자가 제공한 작업에 대한 설명입니다.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
데이터브릭스 모델-레지스트리 업데이트-코멘트
모델 버전의 댓글에 수정 내용을 게시합니다.
databricks model-registry update-comment ID COMMENT [flags]
Arguments
ID
활동의 고유 식별자
COMMENT
사용자가 제공한 작업에 대한 설명입니다.
Options
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
데이터브릭스 모델 레지스트리 업데이트-모델
등록된 모델을 업데이트합니다.
databricks model-registry update-model NAME [flags]
Arguments
NAME
등록된 모델의 고유한 이름 식별자입니다.
Options
--description string
제공된 경우 이 registered_model 대한 설명을 업데이트합니다.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
databricks 모델 레지스트리 업데이트-모델-버전 명령어
모델 버전을 업데이트합니다.
databricks model-registry update-model-version NAME VERSION [flags]
Arguments
NAME
등록된 모델의 이름
VERSION
모델 버전 번호
Options
--description string
제공된 경우 이 registered_model 대한 설명을 업데이트합니다.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
databricks 모델 레지스트리 업데이트 웹훅
Note
이 명령은 공개 미리 보기로 제공됩니다.
레지스트리 웹후크를 업데이트합니다.
databricks model-registry update-webhook ID [flags]
Arguments
ID
웹후크 ID
Options
--description string
웹후크에 대한 사용자 지정 설명입니다.
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
--status RegistryWebhookStatus
웹후크 트리거를 사용하거나 사용하지 않도록 설정하거나 웹후크를 테스트 모드로 전환합니다. 지원되는 값: [활성화, 비활성화, 테스트 모드]
권한 수준 가져오기 - databricks model-registry get-permission-levels
등록된 모델 사용 권한 수준을 가져옵니다.
databricks model-registry get-permission-levels REGISTERED_MODEL_ID [flags]
Arguments
REGISTERED_MODEL_ID
사용 권한을 얻거나 관리할 등록된 모델입니다.
Options
databricks 모델 레지스트리 권한 가져오기 (databricks model-registry get-permissions)
등록된 모델의 사용 권한을 가져옵니다. 등록된 모델은 루트 개체에서 사용 권한을 상속할 수 있습니다.
databricks model-registry get-permissions REGISTERED_MODEL_ID [flags]
Arguments
REGISTERED_MODEL_ID
사용 권한을 얻거나 관리할 등록된 모델입니다.
Options
databricks 모델 레지스트리 권한 설정
등록된 모델 사용 권한을 설정하고 기존 사용 권한이 있는 경우 대체합니다. 지정되지 않은 경우 모든 직접 권한을 삭제합니다. 개체는 루트 개체에서 사용 권한을 상속할 수 있습니다.
databricks model-registry set-permissions REGISTERED_MODEL_ID [flags]
Arguments
REGISTERED_MODEL_ID
사용 권한을 얻거나 관리할 등록된 모델입니다.
Options
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
databricks 모델 레지스트리 업데이트-권한 설정
등록된 모델에 대한 사용 권한을 업데이트합니다. 등록된 모델은 루트 개체에서 사용 권한을 상속할 수 있습니다.
databricks model-registry update-permissions REGISTERED_MODEL_ID [flags]
Arguments
REGISTERED_MODEL_ID
사용 권한을 얻거나 관리할 등록된 모델입니다.
Options
--json JSON
요청 본문은 인라인 JSON 문자열이거나 JSON 파일에 @path을 포함한 것입니다.
전역 표시기
--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 문자열
해당하는 경우 사용할 번들 대상