다음을 통해 공유


model-registry 명령 그룹

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 문자열

    해당하는 경우 사용할 번들 대상