registered-models 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í.

Skupina registered-models příkazů v rozhraní příkazového řádku Databricks obsahuje příkazy pro správu modelů v registru modelů v katalogu Unity. Registrované modely poskytují centralizované řízení přístupu, auditování, rodokmen a zjišťování modelů ML v pracovních prostorech Databricks. Viz Správa životního cyklu modelu v katalogu Unity.

Vytvořit registrované modely Databricks

Vytvořte nový zaregistrovaný model v katalogu Unity.

Úložiště souborů pro verze modelu v registrovaném modelu bude umístěné ve výchozím umístění určeném nadřazeným schématem nebo nadřazeným katalogem nebo metastorem.

Aby bylo vytvoření registrovaného modelu úspěšné, musí uživatel splňovat následující podmínky:

• Volající musí být správcem metastoru nebo vlastníkem nadřazeného katalogu a schématu nebo musí mít USE_CATALOG oprávnění pro nadřazený katalog a USE_SCHEMA oprávnění nadřazeného schématu.
• Volající musí mít oprávnění CREATE MODEL nebo CREATE FUNCTION u nadřazeného schématu.

databricks registered-models create CATALOG_NAME SCHEMA_NAME NAME [flags]

Arguments

CATALOG_NAME

    Název katalogu, ve kterém se nachází schéma a zaregistrovaný model.

SCHEMA_NAME

    Název schématu, ve kterém se nachází zaregistrovaný model.

NAME

    Název registrovaného modelu.

Možnosti

--comment string

    Komentář připojený k registrovanému modelu.

--json JSON

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

--storage-location string

    Umístění úložiště v cloudu, ve kterém jsou uložené datové soubory verze modelu.

Globální příznaky

Examples

Následující příklad vytvoří registrovaný model v zadaném katalogu a schématu:

databricks registered-models create main my_schema my_model

Následující příklad vytvoří registrovaný model s komentářem:

databricks registered-models create main my_schema my_model --comment "My model description"

Odstranění registrovaných modelů Databricks

Odstraňte registrovaný model a všechny jeho verze modelu ze zadaného nadřazeného katalogu a schématu.

Volající musí být správcem metastoru nebo vlastníkem registrovaného modelu. V druhém případě musí být volající také vlastníkem nebo mít USE_CATALOG oprávnění na nadřazený katalog a USE_SCHEMA oprávnění v nadřazeném schématu.

databricks registered-models delete FULL_NAME [flags]

Arguments

FULL_NAME

    Tříúrovňový (plně kvalifikovaný) název registrovaného modelu.

Možnosti

Globální příznaky

Examples

Následující příklad odstraní registrovaný model:

databricks registered-models delete main.my_schema.my_model

Odstranit aliasy registrovaných modelů v databricks

Odstranění registrovaného aliasu modelu

Volající musí být správcem metastoru nebo vlastníkem registrovaného modelu. V druhém případě musí být volající také vlastníkem nebo mít USE_CATALOG oprávnění na nadřazený katalog a USE_SCHEMA oprávnění v nadřazeném schématu.

databricks registered-models delete-alias FULL_NAME ALIAS [flags]

Arguments

FULL_NAME

    Tříúrovňový (plně kvalifikovaný) název registrovaného modelu.

ALIAS

    Název aliasu.

Možnosti

Globální příznaky

Examples

Následující příklad odstraní registrovaný alias modelu:

databricks registered-models delete-alias main.my_schema.my_model production

Získejte registrované modely Databricks

Získejte registrovaný model.

Volající musí být správcem metastoru nebo vlastníkem registrovaného modelu (nebo k tomu mít EXECUTE oprávnění). V druhém případě musí být volající také vlastníkem nebo mít USE_CATALOG oprávnění na nadřazený katalog a USE_SCHEMA oprávnění v nadřazeném schématu.

databricks registered-models get FULL_NAME [flags]

Arguments

FULL_NAME

    Tříúrovňový (plně kvalifikovaný) název registrovaného modelu.

Možnosti

--include-aliases

    Určuje, jestli se mají do odpovědi zahrnout registrované aliasy modelu.

--include-browse

    Zda zahrnout registrované modely do odpovědi, pro kterou může uživatel přistupovat pouze k vybraným metadatům.

Globální příznaky

Examples

Následující příklad získá informace o registrovaném modelu:

databricks registered-models get main.my_schema.my_model

Následující příklad získá informace o registrovaném modelu včetně aliasů:

databricks registered-models get main.my_schema.my_model --include-aliases

Seznam registrovaných modelů databricks

Výpis registrovaných modelů Registrované modely můžete vypsat pod určitým schématem nebo zobrazit seznam všech registrovaných modelů v aktuálním metastoru.

Vrácené modely se filtrují na základě oprávnění volajícího uživatele. Správce metastoru může například zobrazit seznam všech registrovaných modelů. Běžný uživatel musí být vlastníkem registrovaného modelu nebo mít EXECUTE oprávnění, aby mohl obdržet registrované modely v odpovědi. V druhém případě musí být volající také vlastníkem nebo mít USE_CATALOG oprávnění na nadřazený katalog a USE_SCHEMA oprávnění v nadřazeném schématu.

Neexistuje žádná záruka konkrétního pořadí prvků v odpovědi.

databricks registered-models list [flags]

Možnosti

--catalog-name string

    Identifikátor katalogu, pod kterým chcete zobrazit seznam registrovaných modelů.

--include-browse

    Zda zahrnout registrované modely do odpovědi, pro kterou může uživatel přistupovat pouze k vybraným metadatům.

--max-results int

    Maximální počet registrovaných modelů, které se mají vrátit.

--page-token string

    Netransparentní token, který se má odeslat na další stránku výsledků (stránkování).

--schema-name string

    Identifikátor schématu, pod kterým chcete zobrazit seznam registrovaných modelů.

Globální příznaky

Examples

Následující příklad uvádí všechny registrované modely v aktuálním metastoru:

databricks registered-models list

Následující příklad uvádí zaregistrované modely v konkrétním katalogu:

databricks registered-models list --catalog-name main

Následující příklad uvádí zaregistrované modely v určitém schématu:

databricks registered-models list --catalog-name main --schema-name my_schema

Nastavení aliasu pro registrované modely v Databricks

Nastavte alias u zadaného registrovaného modelu.

Volající musí být správcem metastoru nebo vlastníkem registrovaného modelu. V druhém případě musí být volající také vlastníkem nebo mít USE_CATALOG oprávnění na nadřazený katalog a USE_SCHEMA oprávnění v nadřazeném schématu.

databricks registered-models set-alias FULL_NAME ALIAS VERSION_NUM [flags]

Arguments

FULL_NAME

    Úplný název registrovaného modelu.

ALIAS

    Název aliasu.

VERSION_NUM

    Číslo verze modelu, na kterou alias odkazuje.

Možnosti

--json JSON

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

Globální příznaky

Examples

Následující příklad nastaví alias registrovaného modelu:

databricks registered-models set-alias main.my_schema.my_model production 1

Aktualizace registrovaných modelů Databricks

Aktualizujte zadaný zaregistrovaný model.

Volající musí být správcem metastoru nebo vlastníkem registrovaného modelu. V druhém případě musí být volající také vlastníkem nebo mít USE_CATALOG oprávnění na nadřazený katalog a USE_SCHEMA oprávnění v nadřazeném schématu.

V současné době je možné aktualizovat pouze jméno, vlastník nebo komentář registrovaného modelu.

databricks registered-models update FULL_NAME [flags]

Arguments

FULL_NAME

    Tříúrovňový (plně kvalifikovaný) název registrovaného modelu.

Možnosti

--comment string

    Komentář připojený k registrovanému modelu.

--json JSON

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

''--new-name string'**

    Nový název registrovaného modelu

--owner string

    Identifikátor uživatele, který vlastní registrovaný model.

Globální příznaky

Examples

Následující příklad aktualizuje komentář zaregistrovaného modelu:

databricks registered-models update main.my_schema.my_model --comment "Updated model description"

Následující příklad aktualizuje název registrovaného modelu:

databricks registered-models update main.my_schema.my_model --new-name my_new_model

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