Dela via


model-registry kommandogrupp

Note

Den här informationen gäller för Databricks CLI-versionerna 0.205 och senare. The Databricks CLI is in Public Preview.

Databricks CLI use is subject to the Databricks License and Databricks Privacy Notice, including any Usage Data provisions.

Note

Api-referensen dokumenterar API:er för arbetsytemodellregistret. Databricks rekommenderar att du använder modeller i Unity Catalog i stället. Modeller i Unity Catalog ger centraliserad modellstyrning, åtkomst mellan arbetsytor, ursprung och distribution. Arbetsytemodellregistret kommer att bli inaktuellt i framtiden.

The model-registry command group within the Databricks CLI allows you to manage the full lifecycle of MLflow Models. Arbetsytemodellregistret är en centraliserad modelllagringsplats och ett användargränssnitt och en uppsättning API:er som gör att du kan hantera hela livscykeln för MLflow-modeller.

databricks model-registry approve-transition-request

Godkänn en begäran om modellversionsstegövergång.

databricks model-registry approve-transition-request NAME VERSION STAGE ARCHIVE_EXISTING_VERSIONS [flags]

Arguments

NAME

    Namnet på modellen.

VERSION

    Version av modellen.

STAGE

    Målfasen för övergången. Värden som stöds: Archived, None, Production, Staging

ARCHIVE_EXISTING_VERSIONS

    Anger om alla aktuella modellversioner ska arkiveras i målfasen.

Options

--comment string

    Kommentar från användaren om åtgärden.

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks model-registry create-comment

Publicera en kommentar om en modellversion. En kommentar kan skickas antingen av en användare eller programmatiskt för att visa relevant information om modellen. Till exempel testresultat eller distributionsfel.

databricks model-registry create-comment NAME VERSION COMMENT [flags]

Arguments

NAME

    Namnet på modellen.

VERSION

    Version av modellen.

COMMENT

    Kommentar från användaren om åtgärden.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks model-registry create-model

Skapa en ny registrerad modell med det namn som anges i begärandetexten.

Genererar RESOURCE_ALREADY_EXISTS om det finns en registrerad modell med det angivna namnet.

databricks model-registry create-model NAME [flags]

Arguments

NAME

    Registrera modeller under det här namnet

Options

--description string

    Valfri beskrivning för registrerad modell.

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks model-registry create-model-version

Skapa en modellversion.

databricks model-registry create-model-version NAME SOURCE [flags]

Arguments

NAME

    Registrera modell under det här namnet

SOURCE

    URI som anger platsen för modellartefakterna.

Options

--description string

    Valfri beskrivning för modellversion.

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--run-id string

    MLflow-körnings-ID för korrelation, om källan genererades av en experimentkörning i MLflow-spårningsservern.

--run-link string

    MLflow-körningslänk – det här är den exakta länken för körningen som genererade den här modellversionen, som potentiellt finns på en annan instans av MLflow.

Global flags

databricks model-registry create-transition-request

Skapa en modellversionsfasövergångsbegäran.

databricks model-registry create-transition-request NAME VERSION STAGE [flags]

Arguments

NAME

    Namnet på modellen.

VERSION

    Version av modellen.

STAGE

    Målfasen för övergången. Giltiga värden är:

  • Ingen: Den inledande fasen i en modellversion.
  • Mellanlagring: Mellanlagring eller förproduktionssteg.
  • Produktion: Produktionssteg.
  • Arkiverad: Arkiverad fas.

Värden som stöds: [Arkiverad, Ingen, Produktion, Mellanlagring]

Options

--comment string

    Kommentar från användaren om åtgärden.

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks model-registry create-webhook

Note

Det här kommandot finns i offentlig förhandsversion.

Skapa en registerwebbhook.

databricks model-registry create-webhook [flags]

Arguments

None

Options

--description string

    Användardefinerad beskrivning för webhooken.

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--model-name string

    Namnet på den modell vars händelser skulle utlösa den här webhooken.

--status RegistryWebhookStatus

    Aktivera eller inaktivera utlösande av webhooken eller placera webhooken i testläge. Värden som stöds: [ACTIVE, DISABLED, TEST_MODE]

Global flags

databricks model-registry delete-comment

Ta bort en kommentar om en modellversion.

databricks model-registry delete-comment ID [flags]

Arguments

ID

    Unik identifierare för kommentaren som ska tas bort.

Options

Global flags

databricks model-registry delete-model

Ta bort en registrerad modell.

databricks model-registry delete-model NAME [flags]

Arguments

NAME

    Unik namnidentifierare för registrerad modell.

Options

Global flags

databricks model-registry delete-model-tag

Ta bort taggen för en registrerad modell.

databricks model-registry delete-model-tag NAME KEY [flags]

Arguments

NAME

    Namnet på den registrerade modell som taggen loggades under.

KEY

    Namnet på taggen. Namnet måste vara en exakt matchning. borttagning av jokertecken stöds inte. Maximal storlek är 250 byte.

Options

Global flags

databricks model-registry delete-model-version

Ta bort en modellversion.

databricks model-registry delete-model-version NAME VERSION [flags]

Arguments

NAME

    Namnet på den registrerade modellen

VERSION

    Modellversionsnummer

Options

Global flags

databricks model-registry delete-model-version-tag

Ta bort en modellversionstagg.

databricks model-registry delete-model-version-tag NAME VERSION KEY [flags]

Arguments

NAME

    Namnet på den registrerade modell som taggen loggades under.

VERSION

    Modellversionsnummer som taggen loggades under.

KEY

    Namnet på taggen. Namnet måste vara en exakt matchning. borttagning av jokertecken stöds inte. Maximal storlek är 250 byte.

Options

Global flags

databricks model-registry delete-transition-request

Avbryt en begäran om modellversionsstegövergång.

databricks model-registry delete-transition-request NAME VERSION STAGE CREATOR [flags]

Arguments

NAME

    Namnet på modellen.

VERSION

    Version av modellen.

STAGE

    Målfasen för övergångsbegäran. Giltiga värden är:

  • Ingen: Den inledande fasen i en modellversion.
  • Mellanlagring: Mellanlagring eller förproduktionssteg.
  • Produktion: Produktionssteg.
  • Arkiverad: Arkiverad fas.

Värden som stöds: [Arkiverad, Ingen, Produktion, Mellanlagring]

CREATOR

    Användarnamn för användaren som skapade den här begäran. Av de övergångsbegäranden som matchar den angivna informationen tas endast den övergång som skapats av den här användaren bort.

Options

--comment string

    Kommentar från användaren om åtgärden.

Global flags

databricks model-registry delete-webhook

Note

Det här kommandot finns i offentlig förhandsversion.

Tar bort en registerwebbhook.

databricks model-registry delete-webhook [flags]

Arguments

None

Options

--id string

    Webhook-ID krävs för att ta bort en registerwebbhook.

Global flags

databricks model-registry get-latest-versions

Hämta den senaste versionen av en registrerad modell.

databricks model-registry get-latest-versions NAME [flags]

Arguments

NAME

    Unik namnidentifierare för registrerad modell.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks model-registry get-model

Hämta information om en modell. This is a Databricks workspace version of the MLflow endpoint that also returns the model's Databricks workspace ID and the permission level of the requesting user on the model.

databricks model-registry get-model NAME [flags]

Arguments

NAME

    Unik namnidentifierare för registrerad modell.

Options

Global flags

databricks model-registry get-model-version

Hämta en modellversion.

databricks model-registry get-model-version NAME VERSION [flags]

Arguments

NAME

    Namnet på den registrerade modellen

VERSION

    Modellversionsnummer

Options

Global flags

databricks model-registry get-model-version-download-uri

Hämta en URI för att ladda ned modellversionen.

databricks model-registry get-model-version-download-uri NAME VERSION [flags]

Arguments

NAME

    Namnet på den registrerade modellen

VERSION

    Modellversionsnummer

Options

Global flags

databricks model-registry list-models

List all available registered models, up to the limit specified in max_results.

databricks model-registry list-models [flags]

Arguments

None

Options

--max-results int

    Maximalt antal registrerade modeller som önskas.

--page-token string

    Sidnumreringstoken för att gå till nästa sida baserat på en tidigare fråga.

Global flags

databricks model-registry list-transition-requests

Hämta en lista över alla begäranden om övergång i öppen fas för modellversionen.

databricks model-registry list-transition-requests NAME VERSION [flags]

Arguments

NAME

    Namnet på modellen.

VERSION

    Version av modellen.

Options

Global flags

databricks model-registry list-webhooks

Note

Det här kommandot finns i offentlig förhandsversion.

Visa en lista över alla registerwebbhooks.

databricks model-registry list-webhooks [flags]

Arguments

None

Options

--model-name string

    Om det inte anges visas alla webhooks som är associerade med de angivna händelserna, oavsett deras associerade modell.

--page-token string

    Token som anger sidan med artefaktresultat som ska hämtas.

Global flags

databricks model-registry reject-transition-request

Avvisa en begäran om modellversionsstegövergång.

databricks model-registry reject-transition-request NAME VERSION STAGE [flags]

Arguments

NAME

    Namnet på modellen.

VERSION

    Version av modellen.

STAGE

    Målfasen för övergången. Giltiga värden är:

  • Ingen: Den inledande fasen i en modellversion.
  • Mellanlagring: Mellanlagring eller förproduktionssteg.
  • Produktion: Produktionssteg.
  • Arkiverad: Arkiverad fas.

Värden som stöds: [Arkiverad, Ingen, Produktion, Mellanlagring]

Options

--comment string

    Kommentar från användaren om åtgärden.

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks model-registry rename-model

Byt namn på en registrerad modell.

databricks model-registry rename-model NAME [flags]

Arguments

NAME

    Unik namnidentifierare för registrerad modell.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--new-name string

    Om det anges uppdaterar du namnet på den här registered_model.

Global flags

databricks model-registry search-model-versions

Searche for specific model versions based on the supplied filter.

databricks model-registry search-model-versions [flags]

Arguments

None

Options

--filter string

    Strängfiltervillkor, till exempel "name='my-model-name'".

--max-results int

    Maximalt antal modeller som önskas.

--page-token string

    Sidnumreringstoken för att gå till nästa sida baserat på tidigare sökfråga.

Global flags

databricks model-registry search-models

Search for registered models based on the specified filter.

databricks model-registry search-models [flags]

Arguments

None

Options

--filter string

    Strängfiltervillkor, till exempel "name LIKE 'my-model-name'".

--max-results int

    Maximalt antal modeller som önskas.

--page-token string

    Sidnumreringstoken för att gå till nästa sida baserat på en tidigare sökfråga.

Global flags

databricks model-registry set-model-tag

Ange en tagg för en registrerad modell.

databricks model-registry set-model-tag NAME KEY VALUE [flags]

Arguments

NAME

    Unikt namn på modellen.

KEY

    Namnet på taggen. Maximal storlek beror på lagringsserverdelen. Om det redan finns en tagg med det här namnet ersätts dess befintliga värde med det angivna värdet. Alla lagringsserverdelar har garanterat stöd för nyckelvärden upp till 250 byte i storlek.

VALUE

    Strängvärde för taggen som loggas. Maximal storlek beror på lagringsserverdelen. Alla lagringsserverdelar har garanterat stöd för nyckelvärden upp till 5 000 byte i storlek.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks model-registry set-model-version-tag

Ange en modellversionstagg.

databricks model-registry set-model-version-tag NAME VERSION KEY VALUE [flags]

Arguments

NAME

    Unikt namn på modellen.

VERSION

    Modellversionsnummer.

KEY

    Namnet på taggen. Maximal storlek beror på lagringsserverdelen. Om det redan finns en tagg med det här namnet ersätts dess befintliga värde med det angivna värdet. Alla lagringsserverdelar har garanterat stöd för nyckelvärden upp till 250 byte i storlek.

VALUE

    Strängvärde för taggen som loggas. Maximal storlek beror på lagringsserverdelen. Alla lagringsserverdelar har garanterat stöd för nyckelvärden upp till 5 000 byte i storlek.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks model-registry test-registry-webhook

Note

Det här kommandot finns i offentlig förhandsversion.

Testa en registerwebbhook.

databricks model-registry test-registry-webhook ID [flags]

Arguments

ID

    Webhook ID

Options

--event RegistryWebhookEvent

    Om händelsen anges använder testutlösaren den angivna händelsen. Värden som stöds: [ 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

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks model-registry transition-stage

Övergå till en modellversionssteg. This is a Databricks workspace version of the MLflow endpoint that also accepts a comment associated with the transition to be recorded.

databricks model-registry transition-stage NAME VERSION STAGE ARCHIVE_EXISTING_VERSIONS [flags]

Arguments

NAME

    Namnet på modellen.

VERSION

    Version av modellen.

STAGE

    Målfasen för övergången. Giltiga värden är:

  • Ingen: Den inledande fasen i en modellversion.
  • Mellanlagring: Mellanlagring eller förproduktionssteg.
  • Produktion: Produktionssteg.
  • Arkiverad: Arkiverad fas.

Värden som stöds: [Arkiverad, Ingen, Produktion, Mellanlagring]

ARCHIVE_EXISTING_VERSIONS

    Anger om alla aktuella modellversioner ska arkiveras i målfasen.

Options

--comment string

    Kommentar från användaren om åtgärden.

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks model-registry update-comment

Publicera en redigering till en kommentar om en modellversion.

databricks model-registry update-comment ID COMMENT [flags]

Arguments

ID

    Unik identifierare för en aktivitet

COMMENT

    Kommentar från användaren om åtgärden.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks model-registry update-model

Uppdatera en registrerad modell.

databricks model-registry update-model NAME [flags]

Arguments

NAME

    Unik namnidentifierare för registrerad modell.

Options

--description string

    Om det tillhandahålls uppdaterar du beskrivningen för den här registered_model.

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks model-registry update-model-version

Uppdatera modellversionen.

databricks model-registry update-model-version NAME VERSION [flags]

Arguments

NAME

    Namnet på den registrerade modellen

VERSION

    Modellversionsnummer

Options

--description string

    Om det tillhandahålls uppdaterar du beskrivningen för den här registered_model.

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks model-registry update-webhook

Note

Det här kommandot finns i offentlig förhandsversion.

Uppdatera en registerwebbhook.

databricks model-registry update-webhook ID [flags]

Arguments

ID

    Webhook ID

Options

--description string

    Användardefinerad beskrivning för webhooken.

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

--status RegistryWebhookStatus

    Aktivera eller inaktivera utlösande av webhooken eller placera webhooken i testläge. Värden som stöds: [ACTIVE, DISABLED, TEST_MODE]

Global flags

databricks model-registry get-permission-levels

Hämta behörighetsnivåer för registrerade modeller.

databricks model-registry get-permission-levels REGISTERED_MODEL_ID [flags]

Arguments

REGISTERED_MODEL_ID

    Den registrerade modell för vilken behörigheter ska hämtas eller hanteras.

Options

Global flags

databricks model-registry get-permissions

Hämtar behörigheter för en registrerad modell. Registrerade modeller kan ärva behörigheter från sina rotobjekt.

databricks model-registry get-permissions REGISTERED_MODEL_ID [flags]

Arguments

REGISTERED_MODEL_ID

    Den registrerade modell för vilken behörigheter ska hämtas eller hanteras.

Options

Global flags

databricks model-registry set-permissions

Ange registrerade modellbehörigheter och ersätt befintliga behörigheter om de finns. Tar bort alla direktbehörigheter om inga har angetts. Objekt kan ärva behörigheter från sina rotobjekt.

databricks model-registry set-permissions REGISTERED_MODEL_ID [flags]

Arguments

REGISTERED_MODEL_ID

    Den registrerade modell för vilken behörigheter ska hämtas eller hanteras.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

databricks model-registry update-permissions

Uppdatera behörigheterna för en registrerad modell. Registrerade modeller kan ärva behörigheter från sina rotobjekt.

databricks model-registry update-permissions REGISTERED_MODEL_ID [flags]

Arguments

REGISTERED_MODEL_ID

    Den registrerade modell för vilken behörigheter ska hämtas eller hanteras.

Options

--json JSON

    Den infogade JSON-strängen @path eller till JSON-filen med begärandetexten.

Global flags

Global flags

--debug

  Om felsökningsloggning ska aktiveras.

-h eller --help

    Visa hjälp för Databricks CLI eller den relaterade kommandogruppen eller det relaterade kommandot.

--log-file sträng

    En sträng som representerar filen som utdataloggarna ska skrivas till. Om den här flaggan inte anges är standardvärdet att skriva utdataloggar till stderr.

--log-format format

    Loggformattypen eller textjson. Standardvärdet är text.

--log-level sträng

    En sträng som representerar loggformatnivån. Om det inte anges inaktiveras loggformatnivån.

-o, --output typ

    Kommandots utdatatyp, text eller json. Standardvärdet är text.

-p, --profile sträng

    Namnet på profilen i filen som ~/.databrickscfg ska användas för att köra kommandot. Om den här flaggan inte anges används den namngivna DEFAULT profilen om den finns.

--progress-format format

    Formatet för att visa förloppsloggar: default, append, inplaceeller json

-t, --target sträng

    Om tillämpligt, paketmålet som ska användas