Dela via

registered-models kommandogrupp

Note

Den här informationen gäller för Databricks CLI-versionerna 0.205 och senare. Databricks CLI finns i offentlig förhandsversion.

Databricks CLI-användning omfattas av Databricks-licensen och Databricks sekretessmeddelande, inklusive eventuella användningsdatabestämmelser.

Kommandogruppen registered-models i Databricks CLI innehåller kommandon för att hantera modeller i modellregistret i Unity Catalog. Registrerade modeller ger centraliserad åtkomstkontroll, granskning, ursprung och identifiering av ML-modeller på Databricks-arbetsytor. Se Hantera modelllivscykel i Unity Catalog.

databricks registered-modeller skapa

Skapa en ny registrerad modell i Unity Catalog.

Fillagring för modellversioner i den registrerade modellen finns på standardplatsen som anges av det överordnade schemat, den överordnade katalogen eller metaarkivet.

För att den registrerade modellen ska kunna skapas måste användaren uppfylla följande villkor:

  • Anroparen måste vara administratör för metaarkivet eller vara ägare till den överordnade katalogen och schemat, eller ha behörigheten USE_CATALOG för den överordnade katalogen och behörigheten USE_SCHEMA för det överordnade schemat.
  • Anroparen måste ha behörigheten CREATE MODEL eller CREATE FUNCTION för det överordnade schemat.
databricks registered-models create CATALOG_NAME SCHEMA_NAME NAME [flags]

Arguments

CATALOG_NAME

    Namnet på katalogen där schemat och den registrerade modellen finns.

SCHEMA_NAME

    Namnet på schemat där den registrerade modellen finns.

NAME

    Namnet på den registrerade modellen.

Options

--comment string

    Kommentaren som är kopplad till den registrerade modellen.

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

--storage-location string

    Lagringsplatsen i molnet under vilken modellversionsdatafiler lagras.

Globala flaggor

Examples

I följande exempel skapas en registrerad modell i den angivna katalogen och schemat:

databricks registered-models create main my_schema my_model

I följande exempel skapas en registrerad modell med en kommentar:

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

Databricks registered-models radera

Ta bort en registrerad modell och alla dess modellversioner från den angivna överordnade katalogen och schemat.

Anroparen måste vara metaarkivadministratör eller ägare till den registrerade modellen. I det senare fallet måste anroparen också vara ägare eller ha behörigheten USE_CATALOG för den överordnade katalogen och behörigheten USE_SCHEMA för det överordnade schemat.

databricks registered-models delete FULL_NAME [flags]

Arguments

FULL_NAME

    Namnet på den registrerade modellen på tre nivåer (fullständigt kvalificerat).

Options

Globala flaggor

Examples

I följande exempel tas en registrerad modell bort:

databricks registered-models delete main.my_schema.my_model

databricks registrerade-modeller ta-bort-alias

Ta bort ett registrerat modellalias.

Anroparen måste vara metaarkivadministratör eller ägare till den registrerade modellen. I det senare fallet måste anroparen också vara ägare eller ha behörigheten USE_CATALOG för den överordnade katalogen och behörigheten USE_SCHEMA för det överordnade schemat.

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

Arguments

FULL_NAME

    Namnet på den registrerade modellen på tre nivåer (fullständigt kvalificerat).

ALIAS

    Namnet på aliaset.

Options

Globala flaggor

Examples

I följande exempel tas ett registrerat modellalias bort:

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

databricks registrerade modeller hämta

Hämta en registrerad modell.

Anroparen måste vara metaarkivadministratör eller ägare till (eller ha behörigheten EXECUTE på) den registrerade modellen. I det senare fallet måste anroparen också vara ägare eller ha behörigheten USE_CATALOG för den överordnade katalogen och behörigheten USE_SCHEMA för det överordnade schemat.

databricks registered-models get FULL_NAME [flags]

Arguments

FULL_NAME

    Namnet på den registrerade modellen på tre nivåer (fullständigt kvalificerat).

Options

--include-aliases

    Om du vill inkludera registrerade modellalias i svaret.

--include-browse

    Om registrerade modeller ska inkluderas i svaret, där användaren endast kan få åtkomst till viss metadata.

Globala flaggor

Examples

I följande exempel hämtas information om en registrerad modell:

databricks registered-models get main.my_schema.my_model

I följande exempel hämtas information om en registrerad modell, inklusive alias:

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

lista över registrerade databricks-modeller

Lista registrerade modeller. Du kan lista registrerade modeller under ett visst schema eller visa en lista över alla registrerade modeller i det aktuella metaarkivet.

De returnerade modellerna filtreras baserat på den anropande användarens behörigheter. Till exempel kan metaarkivadministratören visa en lista över alla registrerade modeller. En vanlig användare måste vara ägare eller ha behörigheten EXECUTE för den registrerade modellen för att ta emot de registrerade modellerna i svaret. I det senare fallet måste anroparen också vara ägare eller ha behörigheten USE_CATALOG för den överordnade katalogen och behörigheten USE_SCHEMA för det överordnade schemat.

Det finns ingen garanti för en specifik ordning på elementen i svaret.

databricks registered-models list [flags]

Options

--catalog-name string

    Identifieraren för katalogen som registrerade modeller ska listas under.

--include-browse

    Om registrerade modeller ska inkluderas i svaret, där användaren endast kan få åtkomst till viss metadata.

--max-results int

    Maximalt antal registrerade modeller som ska returneras.

--page-token string

    Ogenomskinlig token som ska skickas för nästa sida med resultat (sidnumrering).

--schema-name string

    Identifieraren för schemat som registrerade modeller ska listas under.

Globala flaggor

Examples

I följande exempel visas alla registrerade modeller i det aktuella metaarkivet:

databricks registered-models list

I följande exempel visas registrerade modeller i en specifik katalog:

databricks registered-models list --catalog-name main

I följande exempel visas registrerade modeller i ett specifikt schema:

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

databricks registered-models set-alias

Ange ett alias för den angivna registrerade modellen.

Anroparen måste vara metaarkivadministratör eller ägare till den registrerade modellen. I det senare fallet måste anroparen också vara ägare eller ha behörigheten USE_CATALOG för den överordnade katalogen och behörigheten USE_SCHEMA för det överordnade schemat.

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

Arguments

FULL_NAME

    Fullständigt namn på den registrerade modellen.

ALIAS

    Namnet på aliaset.

VERSION_NUM

    Versionsnumret för den modellversion som aliaset pekar på.

Options

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

Globala flaggor

Examples

I följande exempel anges ett alias för en registrerad modell:

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

uppdatering av Databricks registered-models

Uppdatera den angivna registrerade modellen.

Anroparen måste vara metaarkivadministratör eller ägare till den registrerade modellen. I det senare fallet måste anroparen också vara ägare eller ha behörigheten USE_CATALOG för den överordnade katalogen och behörigheten USE_SCHEMA för det överordnade schemat.

För närvarande kan endast namnet, ägaren eller kommentaren för den registrerade modellen uppdateras.

databricks registered-models update FULL_NAME [flags]

Arguments

FULL_NAME

    Namnet på den registrerade modellen på tre nivåer (fullständigt kvalificerat).

Options

--comment string

    Kommentaren som är kopplad till den registrerade modellen.

--json JSON

    Den inbäddade JSON-strängen eller @path till JSON-filen med begärandekroppen.

''--new-name string'**

    Nytt namn på den registrerade modellen.

--owner string

    Identifieraren för den användare som äger den registrerade modellen.

Globala flaggor

Examples

I följande exempel uppdateras en registrerad modells kommentar:

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

I följande exempel uppdateras namnet på en registrerad modell:

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

Globala flaggor

--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, text eller json. 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 ~/.databrickscfg-filen som 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

  • Last updated on