Delen via


model-versions opdrachtgroep

Note

Deze informatie is van toepassing op Databricks CLI-versies 0.205 en hoger. De Databricks CLI bevindt zich in openbare preview.

Databricks CLI-gebruik is onderhevig aan de Databricks-licentie en de privacyverklaring van Databricks, met inbegrip van alle bepalingen voor gebruiksgegevens.

De model-versions opdrachtgroep in de Databricks CLI bevat opdrachten voor het beheren van modelversies in het modelregister in Unity Catalog. Modellen in Unity Catalog bieden gecentraliseerd toegangsbeheer, controle, herkomst en detectie van ML-modellen in Databricks-werkruimten. Zie De levenscyclus van het model beheren in Unity Catalog.

Databricks-modelversies verwijderen

Een modelversie verwijderen uit het opgegeven geregistreerde model. Alle aliassen die zijn toegewezen aan de modelversie, worden ook verwijderd.

De aanroeper moet een metastore-beheerder of een eigenaar van het bovenliggende geregistreerde model zijn. In het laatste geval moet de aanroeper ook de eigenaar zijn of het USE_CATALOG privilege hebben voor de bovenliggende catalogus en het USE_SCHEMA privilege voor het bovenliggende schema.

databricks model-versions delete FULL_NAME VERSION [flags]

Arguments

FULL_NAME

    De volledig gekwalificeerde naam van de modelversie met drie niveaus

VERSION

    Het gehele versienummer van de modelversie

Options

Globale vlaggen

Examples

In het volgende voorbeeld wordt versie 1 van een model verwijderd:

databricks model-versions delete main.my_schema.my_model 1

databricks modelversies ophalen

Haal een modelversie op.

De aanroeper moet een metastore-beheerder of eigenaar zijn van het bovenliggende geregistreerde model (of over de EXECUTE bevoegdheid beschikken). In het laatste geval moet de aanroeper ook de eigenaar zijn of het USE_CATALOG privilege hebben voor de bovenliggende catalogus en het USE_SCHEMA privilege voor het bovenliggende schema.

databricks model-versions get FULL_NAME VERSION [flags]

Arguments

FULL_NAME

    De volledig gekwalificeerde naam van de modelversie met drie niveaus

VERSION

    Het gehele versienummer van de modelversie

Options

--include-aliases

    Of aliassen die aan de modelversie zijn gekoppeld moeten worden opgenomen in de respons.

--include-browse

    Of modelversies moeten worden opgenomen in het antwoord waarvoor de principal alleen toegang heeft tot selectieve metagegevens.

Globale vlaggen

Examples

In het volgende voorbeeld wordt versie 1 van een model opgehaald.

databricks model-versions get main.my_schema.my_model 1

In het volgende voorbeeld wordt versie 1 van een model met aliassen opgenomen:

databricks model-versions get main.my_schema.my_model 1 --include-aliases

get-by-alias voor databricks-modelversies

Verkrijg een modelversie via alias.

De beller moet een metastore-beheerder of eigenaar van het geregistreerde model zijn (of de EXECUTE bevoegdheid hebben voor) het geregistreerde model. In het laatste geval moet de aanroeper ook de eigenaar zijn of het USE_CATALOG privilege hebben voor de bovenliggende catalogus en het USE_SCHEMA privilege voor het bovenliggende schema.

databricks model-versions get-by-alias FULL_NAME ALIAS [flags]

Arguments

FULL_NAME

    De volledig gekwalificeerde drie-niveau naam voor het geregistreerde model

ALIAS

    De naam van de alias

Options

--include-aliases

    Of aliassen die aan de modelversie zijn gekoppeld moeten worden opgenomen in de respons.

Globale vlaggen

Examples

In het volgende voorbeeld wordt een modelversie via een alias opgehaald.

databricks model-versions get-by-alias main.my_schema.my_model production

In het volgende voorbeeld wordt een modelversie verkregen met behulp van een alias waarbij de aliassen zijn inbegrepen.

databricks model-versions get-by-alias main.my_schema.my_model production --include-aliases

Lijst van Databricks-modelversies

Modelversies weergeven. U kunt modelversies onder een bepaald schema weergeven of alle modelversies weergeven in de huidige metastore.

De geretourneerde modellen worden gefilterd op basis van de bevoegdheden van de aanroepende gebruiker. De metastore-beheerder kan bijvoorbeeld alle modelversies weergeven. Een reguliere gebruiker moet de eigenaar zijn of de EXECUTE bevoegdheid hebben voor het bovenliggende geregistreerde model om de modelversies in het antwoord te ontvangen. In het laatste geval moet de aanroeper ook de eigenaar zijn of het USE_CATALOG privilege hebben voor de bovenliggende catalogus en het USE_SCHEMA privilege voor het bovenliggende schema.

Er is geen garantie voor een specifieke volgorde van de elementen in het antwoord. De elementen in het antwoord bevatten geen aliassen of tags.

databricks model-versions list FULL_NAME [flags]

Arguments

FULL_NAME

    De volledige drie-niveau naam van het geregistreerde model waaronder modelversies worden vermeld

Options

--include-browse

    Of modelversies moeten worden opgenomen in het antwoord waarvoor de principal alleen toegang heeft tot selectieve metagegevens.

--max-results int

    Maximum aantal modelversies dat moet worden geretourneerd.

--page-token string

    Ondoorzichtig pagineringstoken om naar de volgende pagina te gaan op basis van de vorige query.

Globale vlaggen

Examples

In het volgende voorbeeld ziet u alle modelversies voor een geregistreerd model:

databricks model-versions list main.my_schema.my_model

In het volgende voorbeeld ziet u modelversies met paginering:

databricks model-versions list main.my_schema.my_model --max-results 10 --page-token abc123token

Databricks-modelversies bijwerken

Werk de opgegeven modelversie bij.

De aanroeper moet een metastore-beheerder of een eigenaar van het bovenliggende geregistreerde model zijn. In het laatste geval moet de aanroeper ook de eigenaar zijn of het USE_CATALOG privilege hebben voor de bovenliggende catalogus en het USE_SCHEMA privilege voor het bovenliggende schema.

Momenteel kan alleen de opmerking van de modelversie worden bijgewerkt.

databricks model-versions update FULL_NAME VERSION [flags]

Arguments

FULL_NAME

    De volledig gekwalificeerde naam van de modelversie met drie niveaus

VERSION

    Het gehele versienummer van de modelversie

Options

--comment string

    De opmerking die is gekoppeld aan de modelversie.

--json JSON

    De inline JSON-tekenreeks of het @path naar het JSON-bestand met de aanvraagbody

Globale vlaggen

Examples

In het volgende voorbeeld wordt een opmerking bij de modelversie bijgewerkt:

databricks model-versions update main.my_schema.my_model 1 --comment "Updated model with improved accuracy"

In het volgende voorbeeld wordt een modelversie bijgewerkt met behulp van een JSON-bestand:

databricks model-versions update main.my_schema.my_model 1 --json @model-version-update.json

Globale vlaggen

--debug

  Of u logboekregistratie voor foutopsporing wilt inschakelen.

-h of --help

    Help weergeven voor de Databricks CLI, de bijbehorende opdrachtgroep of de bijbehorende opdracht.

--log-file snaar

    Een tekenreeks die het bestand aangeeft waar uitvoerlogboeken naar moeten worden geschreven. Als deze vlag niet is opgegeven, is het standaardinstelling om uitvoerlogboeken naar stderr te schrijven.

--log-format formatteren

    Het logformaat type, text of json. De standaardwaarde is text.

--log-level snaar

    Een tekenreeks die het niveau van de logboekindeling vertegenwoordigt. Als dit niet is opgegeven, wordt het niveau van de logboekindeling uitgeschakeld.

-o, --output type

    Het type uitvoer van de opdracht, text of json. De standaardwaarde is text.

-p, --profile snaar

    De naam van het profiel in het ~/.databrickscfg bestand dat moet worden gebruikt om de opdracht uit te voeren. Als deze vlag niet is opgegeven en hij bestaat, wordt het profiel met de naam DEFAULT gebruikt.

--progress-format formatteren

    De indeling voor het weergeven van voortgangslogboeken: default, append, inplaceof json

-t, --target snaar

    Indien van toepassing, het bundeldoel dat moet worden gebruikt