Sdílet prostřednictvím


model-registry skupina příkazů

Note

Tyto informace platí pro Databricks CLI verze 0.205 a vyšší. Rozhraní příkazového řádku Databricks je ve veřejné ukázce.

Použití rozhraní příkazového řádku Databricks podléhá licenci Databricks a oznámení o ochraně osobních údajů Databricks, včetně všech ustanovení o využití.

Note

Dokumentace tohoto rozhraní API obsahuje rozhraní API pro registr modelů pracovního prostoru. Databricks místo toho doporučuje používat modely v katalogu Unity . Modely v katalogu Unity poskytují centralizované zásady správného řízení modelu, přístup mezi pracovními prostory, rodokmen a nasazení. Registr modelů pracovního prostoru bude v budoucnu zastaralý.

Skupina model-registry příkazů v rozhraní příkazového řádku Databricks umožňuje spravovat celý životní cyklus modelů MLflow. Registr modelů pracovního prostoru je centralizované úložiště modelů a uživatelské rozhraní a sada rozhraní API, která umožňují spravovat celý životní cyklus modelů MLflow.

databricks model-registry approve-transition-request (požadavek na schválení přechodu)

Schválení žádosti o přechod fáze verze modelu.

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

Arguments

NAME

    Název modelu

VERSION

    Verze modelu

STAGE

    Cílová fáze přechodu. Podporované hodnoty: Archived, None, Production, Staging

ARCHIVE_EXISTING_VERSIONS

    Určuje, jestli se mají archivovat všechny aktuální verze modelu v cílové fázi.

Možnosti

--comment string

    Komentář k akci poskytnutý uživatelem

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

databricks model-registry vytvořit-komentář

Publikujte komentář k verzi modelu. Komentář může odeslat uživatel nebo programově, aby se zobrazily relevantní informace o modelu. Například výsledky testů nebo chyby nasazení.

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

Arguments

NAME

    Název modelu

VERSION

    Verze modelu

COMMENT

    Komentář k akci poskytnutý uživatelem

Možnosti

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

databricks model-registr create-model

Vytvořte nový zaregistrovaný model s názvem zadaným v textu požadavku.

Vyvolá RESOURCE_ALREADY_EXISTS, pokud existuje registrovaný model s daným názvem.

databricks model-registry create-model NAME [flags]

Arguments

NAME

    Registrace modelů pod tímto názvem

Možnosti

--description string

    Volitelný popis registrovaného modelu

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

Vytvoření verze modelu v Databricks model-registry

Vytvořte verzi modelu.

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

Arguments

NAME

    Zaregistrovat model pod tímto názvem

SOURCE

    Identifikátor URI označující umístění artefaktů modelu.

Možnosti

--description string

    Volitelný popis verze modelu

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

--run-id string

    ID běhu MLflow pro korelaci, pokud byl zdroj vygenerován experimentem na sledovacím serveru MLflow.

--run-link string

    Odkaz na spuštění MLflow – jedná se o přesný odkaz na spuštění, které vygenerovalo tuto verzi modelu, potenciálně hostované v jiné instanci MLflow.

Globální příznaky

databricks registr modelů vytvořit-požadavek-na-přechod

Vytvořte požadavek na přechod fáze verze modelu.

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

Arguments

NAME

    Název modelu

VERSION

    Verze modelu

STAGE

    Cílová fáze přechodu. Platné hodnoty jsou:

  • Žádné: Počáteční fáze verze modelu.
  • Příprava: Přípravná nebo předprodukční fáze.
  • Produkce: Produkční fáze.
  • Archivováno: Archivovaná fáze.

Podporované hodnoty: [Archivované, Žádné, Produkce, Testovací]

Možnosti

--comment string

    Komentář k akci poskytnutý uživatelem

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

databricks model-registry create-webhook

Note

Tento příkaz je ve verzi Public Preview.

Vytvořte webhook registru.

databricks model-registry create-webhook [flags]

Arguments

None

Možnosti

--description string

    Popis webhooku zadaný uživatelem

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

--model-name string

    Název modelu, jehož události by aktivovaly tento webhook.

--status RegistryWebhookStatus

    Povolte nebo zakažte aktivaci webhooku nebo vložte webhook do testovacího režimu. Podporované hodnoty: [ACTIVE, DISABLED, TEST_MODE]

Globální příznaky

Databricks registr modelu odstranit komentář

Odstraňte komentář k verzi modelu.

databricks model-registry delete-comment ID [flags]

Arguments

ID

    Jedinečný identifikátor komentáře, který chcete odstranit.

Možnosti

Globální příznaky

Příkaz "Databricks model-registry delete-model"

Odstranění registrovaného modelu

databricks model-registry delete-model NAME [flags]

Arguments

NAME

    Identifikátor jedinečného názvu registrovaného modelu

Možnosti

Globální příznaky

databricks model-registry delete-model-tag

Odstraňte značku registrovaného modelu.

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

Arguments

NAME

    Název registrovaného modelu, pod kterým byla značka zaznamenána.

KEY

    Název značky Název musí být přesnou shodou. Odstranění zástupných znaků není podporováno. Maximální velikost je 250 bajtů.

Možnosti

Globální příznaky

databricks model-registry delete-model-version

Smazat verzi modelu

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

Arguments

NAME

    Název registrovaného modelu

VERSION

    Číslo verze modelu

Možnosti

Globální příznaky

databricks model-registry příkaz pro odstranění štítku verze modelu

Odstraňte značku verze modelu.

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

Arguments

NAME

    Název registrovaného modelu, pod kterým byla značka zaznamenána.

VERSION

    Číslo verze modelu, pod kterým byla značka zaznamenána.

KEY

    Název značky Název musí být přesnou shodou. Odstranění zástupných znaků není podporováno. Maximální velikost je 250 bajtů.

Možnosti

Globální příznaky

Databricks registr modelů - žádost o odstranění přechodu

Zrušit žádost o přechod fáze verze modelu.

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

Arguments

NAME

    Název modelu

VERSION

    Verze modelu

STAGE

    Cílová fáze žádosti o přechod Platné hodnoty jsou:

  • Žádné: Počáteční fáze verze modelu.
  • Příprava: Přípravná nebo předprodukční fáze.
  • Produkce: Produkční fáze.
  • Archivováno: Archivovaná fáze.

Podporované hodnoty: [Archivované, Žádné, Produkce, Testovací]

CREATOR

    Uživatelské jméno uživatele, který vytvořil tento požadavek. Z žádostí o přechod odpovídajících zadaným podrobnostem se odstraní pouze jeden přechod vytvořený tímto uživatelem.

Možnosti

--comment string

    Komentář k akci poskytnutý uživatelem

Globální příznaky

Příkaz 'databricks model-registry delete-webhook' slouží k odstranění webhooku z registru modelů v systému Databricks.

Note

Tento příkaz je ve verzi Public Preview.

Odstraní webhook registru.

databricks model-registry delete-webhook [flags]

Arguments

None

Možnosti

--id string

    Webhook ID je potřebné k odstranění webhooku registru.

Globální příznaky

databricks model-registry get-latest-versions

Získejte nejnovější verzi registrovaného modelu.

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

Arguments

NAME

    Identifikátor jedinečného názvu registrovaného modelu

Možnosti

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

databricks model-registry get-model

Získejte podrobnosti o modelu. Toto je verze pracovního prostoru Databricks koncového bodu MLflow , která také vrací ID pracovního prostoru Databricks modelu a úroveň oprávnění žádajícího uživatele v modelu.

databricks model-registry get-model NAME [flags]

Arguments

NAME

    Identifikátor jedinečného názvu registrovaného modelu

Možnosti

Globální příznaky

databricks model-registry get-model-version

Získejte verzi modelu.

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

Arguments

NAME

    Název registrovaného modelu

VERSION

    Číslo verze modelu

Možnosti

Globální příznaky

Databricks model-registry get-model-version-download-uri

Získejte identifikátor URI pro stažení verze modelu.

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

Arguments

NAME

    Název registrovaného modelu

VERSION

    Číslo verze modelu

Možnosti

Globální příznaky

Databricks model-registry list-models

Zobrazí seznam všech dostupných registrovaných modelů až do limitu zadaného v max_results.

databricks model-registry list-models [flags]

Arguments

None

Možnosti

--max-results int

    Maximální požadovaný počet registrovaných modelů

--page-token string

    Token pro stránkování, která slouží k přechodu na další stránku na základě předchozího dotazu.

Globální příznaky

databricks registr modelu seznam požadavků na přechod

Získejte seznam všech žádostí o přechod otevřené fáze pro verzi modelu.

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

Arguments

NAME

    Název modelu

VERSION

    Verze modelu

Možnosti

Globální příznaky

databricks model-registry list-webhooks

Note

Tento příkaz je ve verzi Public Preview.

Zobrazí seznam všech webhooků registru.

databricks model-registry list-webhooks [flags]

Arguments

None

Možnosti

--model-name string

    Pokud není zadaný, zobrazí se všechny webhooky přidružené k zadaným událostem bez ohledu na jejich přidružený model.

--page-token string

    Token označující stránku výsledků artefaktů, které se mají načíst.

Globální příznaky

databricks model-registry odmítnout-požadavek-na-přechod

Zamítnout požadavek na přechod verze modelu na další fázi.

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

Arguments

NAME

    Název modelu

VERSION

    Verze modelu

STAGE

    Cílová fáze přechodu. Platné hodnoty jsou:

  • Žádné: Počáteční fáze verze modelu.
  • Příprava: Přípravná nebo předprodukční fáze.
  • Produkce: Produkční fáze.
  • Archivováno: Archivovaná fáze.

Podporované hodnoty: [Archivované, Žádné, Produkce, Testovací]

Možnosti

--comment string

    Komentář k akci poskytnutý uživatelem

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

Databricks model-registry rename-model

Přejmenování registrovaného modelu

databricks model-registry rename-model NAME [flags]

Arguments

NAME

    Identifikátor jedinečného názvu registrovaného modelu

Možnosti

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

--new-name string

    V případě potřeby aktualizuje název tohoto registered_modelu.

Globální příznaky

registr modelů Databricks vyhledat verze modelu

Vyhledá konkrétní verze modelu na základě zadaného filtru.

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

Arguments

None

Možnosti

--filter string

    Podmínka řetězcového filtru (například name='my-model-name').

--max-results int

    Maximální požadovaný počet modelů

--page-token string

    Token stránkování, který přejde na další stránku na základě předchozího vyhledávacího dotazu.

Globální příznaky

Vyhledávání modelů v registru modelů Databricks

Vyhledejte registrované modely na základě zadaného filtru.

databricks model-registry search-models [flags]

Arguments

None

Možnosti

--filter string

    Podmínka filtru řetězců, například "name LIKE "my-model-name".

--max-results int

    Maximální požadovaný počet modelů

--page-token string

    Token stránkování, který přejde na další stránku na základě předchozího vyhledávacího dotazu.

Globální příznaky

Databricks registrace modelu nastavit tag modelu

Nastavte značku u registrovaného modelu.

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

Arguments

NAME

    Jedinečný název modelu

KEY

    Název značky Maximální velikost závisí na back-endu úložiště. Pokud značka s tímto názvem již existuje, její předexistující hodnota bude nahrazena zadanou hodnotou. U všech back-endů úložiště je zaručeno, že budou podporovat hodnoty klíčů o velikosti až 250 bajtů.

VALUE

    Řetězcová hodnota značky, která se protokoluje. Maximální velikost závisí na back-endu úložiště. U všech back-endů úložiště je zaručeno, že podporují hodnoty klíčů o velikosti až 5 000 bajtů.

Možnosti

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

databricks model-registry set-model-version-tag

Nastavte značku verze modelu.

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

Arguments

NAME

    Jedinečný název modelu

VERSION

    Číslo verze modelu

KEY

    Název značky Maximální velikost závisí na back-endu úložiště. Pokud značka s tímto názvem již existuje, její předexistující hodnota bude nahrazena zadanou hodnotou. U všech back-endů úložiště je zaručeno, že budou podporovat hodnoty klíčů o velikosti až 250 bajtů.

VALUE

    Řetězcová hodnota značky, která se protokoluje. Maximální velikost závisí na back-endu úložiště. U všech back-endů úložiště je zaručeno, že podporují hodnoty klíčů o velikosti až 5 000 bajtů.

Možnosti

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

Databricks model-registry test-registry-webhook

Note

Tento příkaz je ve verzi Public Preview.

Otestujte webhook registru.

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

Arguments

ID

    ID webhooku

Možnosti

--event RegistryWebhookEvent

    Pokud je zadána událost, trigger testu použije zadanou událost. Podporované hodnoty: [ 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

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

přechodová fáze v registru modelů Databricks

Přechod fáze verze modelu Toto je verze pracovního prostoru Databricks koncového bodu MLflow která také přijímá komentář přidružený k přechodu, který se má zaznamenat.

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

Arguments

NAME

    Název modelu

VERSION

    Verze modelu

STAGE

    Cílová fáze přechodu. Platné hodnoty jsou:

  • Žádné: Počáteční fáze verze modelu.
  • Příprava: Přípravná nebo předprodukční fáze.
  • Produkce: Produkční fáze.
  • Archivováno: Archivovaná fáze.

Podporované hodnoty: [Archivované, Žádné, Produkce, Testovací]

ARCHIVE_EXISTING_VERSIONS

    Určuje, jestli se mají archivovat všechny aktuální verze modelu v cílové fázi.

Možnosti

--comment string

    Komentář k akci poskytnutý uživatelem

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

databricks model-registry aktualizovat-komentář

Upravte komentář k verzi modelu.

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

Arguments

ID

    Jedinečný identifikátor aktivity

COMMENT

    Komentář k akci poskytnutý uživatelem

Možnosti

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

databricks model-registry update-model (aktualizace modelu v registru modelů)

Aktualizace registrovaného modelu

databricks model-registry update-model NAME [flags]

Arguments

NAME

    Identifikátor jedinečného názvu registrovaného modelu

Možnosti

--description string

    Pokud je uvedeno, aktualizuje popis tohoto registrovaného modelu.

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

databricks registr modelu aktualizace verze modelu

Aktualizujte verzi modelu.

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

Arguments

NAME

    Název registrovaného modelu

VERSION

    Číslo verze modelu

Možnosti

--description string

    Pokud je uvedeno, aktualizuje popis tohoto registrovaného modelu.

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

databricks model-registry update-webhook

Note

Tento příkaz je ve verzi Public Preview.

Aktualizace webhooku registru

databricks model-registry update-webhook ID [flags]

Arguments

ID

    ID webhooku

Možnosti

--description string

    Popis webhooku zadaný uživatelem

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

--status RegistryWebhookStatus

    Povolte nebo zakažte aktivaci webhooku nebo vložte webhook do testovacího režimu. Podporované hodnoty: [ACTIVE, DISABLED, TEST_MODE]

Globální příznaky

Databricks model-registry získat-úrovně-oprávnění

Získejte úrovně oprávnění registrovaného modelu.

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

Arguments

REGISTERED_MODEL_ID

    Registrovaný model, pro který se mají získat nebo spravovat oprávnění.

Možnosti

Globální příznaky

databricks model-registry get-permissions

Získá oprávnění k registrovanému modelu. Registrované modely mohou dědit oprávnění z kořenového objektu.

databricks model-registry get-permissions REGISTERED_MODEL_ID [flags]

Arguments

REGISTERED_MODEL_ID

    Registrovaný model, pro který se mají získat nebo spravovat oprávnění.

Možnosti

Globální příznaky

databricks model-registry nastavit oprávnění

Nastavte zaregistrovaná oprávnění modelu a nahraďte stávající oprávnění, pokud existují. Odstraní všechna přímá oprávnění, pokud nejsou zadána žádná. Objekty mohou dědit oprávnění z kořenového objektu.

databricks model-registry set-permissions REGISTERED_MODEL_ID [flags]

Arguments

REGISTERED_MODEL_ID

    Registrovaný model, pro který se mají získat nebo spravovat oprávnění.

Možnosti

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

databricks model-registry aktualizovat oprávnění

Aktualizujte oprávnění k registrovanému modelu. Registrované modely mohou dědit oprávnění z kořenového objektu.

databricks model-registry update-permissions REGISTERED_MODEL_ID [flags]

Arguments

REGISTERED_MODEL_ID

    Registrovaný model, pro který se mají získat nebo spravovat oprávnění.

Možnosti

--json JSON

    Vložený řetězec JSON nebo @path do souboru JSON s textem požadavku.

Globální příznaky

Globální příznaky

--debug

  Zda povolit protokolování ladění.

-h nebo --help

    Zobrazení nápovědy k rozhraní příkazového řádku Databricks nebo související skupině příkazů nebo souvisejícímu příkazu

--log-file řetězec

    Řetězec představující soubor, do kterého se zapisují výstupní protokoly. Pokud tento příznak není zadaný, výchozí hodnota je zápis výstupních protokolů do stderru.

--log-format formát

    Typ formátu protokolu, text nebo json. Výchozí hodnota je text.

--log-level řetězec

    Řetězec představující úroveň formátu protokolu. Pokud není zadána, je úroveň formátu protokolu zakázaná.

-o, --output typ

    Typ výstupu příkazu, text nebo json. Výchozí hodnota je text.

-p, --profile řetězec

    Název profilu v ~/.databrickscfg souboru, který se má použít ke spuštění příkazu. Pokud tento příznak není zadán, použije se profil s názvem DEFAULT, pokud existuje.

--progress-format formát

    Formát pro zobrazení protokolů průběhu: default, append, inplacenebo json

-t, --target řetězec

    Pokud je to relevantní, cílový balíček, který se má použít