registered-models 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 registered-models opdrachtgroep in de Databricks CLI bevat opdrachten voor het beheren van modellen in het modelregister in Unity Catalog. Geregistreerde modellen bieden gecentraliseerd toegangsbeheer, controle, herkomst en detectie van ML-modellen in Databricks-werkruimten. Zie De levenscyclus van het model beheren in Unity Catalog.

databricks-geregistreerde modellen maken

Maak een nieuw geregistreerd model in Unity Catalog.

Bestandsopslag voor modelversies in het geregistreerde model bevindt zich op de standaardlocatie die is opgegeven door het bovenliggende schema, de bovenliggende catalogus of de Metastore.

Als het maken van een geregistreerd model is voltooid, moet de gebruiker aan de volgende voorwaarden voldoen:

• De aanroeper moet een metastore-beheerder zijn, of de eigenaar van de bovenliggende catalogus en het schema zijn, of de USE_CATALOG bevoegdheid hebben voor de bovenliggende catalogus en de USE_SCHEMA bevoegdheid voor het bovenliggende schema.
• De aanroeper moet de CREATE MODEL of CREATE FUNCTION bevoegdheid hebben voor het ouder-schema.

databricks registered-models create CATALOG_NAME SCHEMA_NAME NAME [flags]

Arguments

CATALOG_NAME

    De naam van de catalogus waarin het schema en het geregistreerde model zich bevinden.

SCHEMA_NAME

    De naam van het schema waarin het geregistreerde model zich bevindt.

NAME

    De naam van het geregistreerde model.

Options

--comment string

    De opmerking die is gekoppeld aan het geregistreerde model.

--json JSON

    De inline JSON-tekenreeks of de link @path naar het JSON-bestand met de body van het verzoek.

--storage-location string

    De opslaglocatie in de cloud waaronder modelversiegegevensbestanden worden opgeslagen.

Globale vlaggen

Examples

In het volgende voorbeeld wordt een geregistreerd model gemaakt in de opgegeven catalogus en het opgegeven schema:

databricks registered-models create main my_schema my_model

In het volgende voorbeeld wordt een geregistreerd model gemaakt met een opmerking:

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

Databricks-geregistreerde modellen verwijderen

Verwijder een geregistreerd model en alle bijbehorende modelversies uit de opgegeven bovenliggende catalogus en het opgegeven schema.

De beller moet een metastore-beheerder of een eigenaar van het 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 registered-models delete FULL_NAME [flags]

Arguments

FULL_NAME

    De volledig gekwalificeerde drie-niveaus naam van het geregistreerde model.

Options

Globale vlaggen

Examples

In het volgende voorbeeld wordt een geregistreerd model verwijderd:

databricks registered-models delete main.my_schema.my_model

databricks geregistreerde-modellen verwijder-alias

Verwijder een geregistreerde modelalias.

De beller moet een metastore-beheerder of een eigenaar van het 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 registered-models delete-alias FULL_NAME ALIAS [flags]

Arguments

FULL_NAME

    De volledig gekwalificeerde drie-niveaus naam van het geregistreerde model.

ALIAS

    De naam van de alias.

Options

Globale vlaggen

Examples

In het volgende voorbeeld wordt een geregistreerde modelalias verwijderd:

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

Databricks-geregistreerde modellen krijgen

Een geregistreerd model ophalen.

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 registered-models get FULL_NAME [flags]

Arguments

FULL_NAME

    De volledig gekwalificeerde drie-niveaus naam van het geregistreerde model.

Options

--include-aliases

    Of u geregistreerde modelaliassen wilt opnemen in het antwoord.

--include-browse

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

Globale vlaggen

Examples

In het volgende voorbeeld wordt informatie opgehaald over een geregistreerd model:

databricks registered-models get main.my_schema.my_model

In het volgende voorbeeld wordt informatie opgehaald over een geregistreerd model, inclusief aliassen:

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

Lijst met geregistreerde databricks-modellen

Geregistreerde modellen weergeven. U kunt geregistreerde modellen onder een bepaald schema weergeven of alle geregistreerde modellen 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 geregistreerde modellen weergeven. Een gewone gebruiker moet de eigenaar zijn of de EXECUTE bevoegdheid voor het geregistreerde model hebben om de geregistreerde modellen 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.

databricks registered-models list [flags]

Options

--catalog-name string

    De identificatiecode van de catalogus waaraan de geregistreerde modellen zijn gekoppeld.

--include-browse

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

--max-results int

    Maximum aantal geregistreerde modellen dat moet worden geretourneerd.

--page-token string

    Ondoorzichtig token dat moet worden verzonden voor de volgende pagina met resultaten (paginering).

--schema-name string

    De identificatie van het schema waaronder geregistreerde modellen worden vermeld.

Globale vlaggen

Examples

In het volgende voorbeeld ziet u alle geregistreerde modellen in de huidige metastore:

databricks registered-models list

In het volgende voorbeeld ziet u geregistreerde modellen in een specifieke catalogus:

databricks registered-models list --catalog-name main

In het volgende voorbeeld ziet u geregistreerde modellen in een specifiek schema:

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

"databricks geregistreerde-modellen stel-alias in"

Stel een alias in op het opgegeven geregistreerde model.

De beller moet een metastore-beheerder of een eigenaar van het 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 registered-models set-alias FULL_NAME ALIAS VERSION_NUM [flags]

Arguments

FULL_NAME

    Volledige naam van het geregistreerde model.

ALIAS

    De naam van de alias.

VERSION_NUM

    Het versienummer van de modelversie waarnaar de alias verwijst.

Options

--json JSON

    De inline JSON-tekenreeks of de link @path naar het JSON-bestand met de body van het verzoek.

Globale vlaggen

Examples

In het volgende voorbeeld wordt een alias ingesteld op een geregistreerd model:

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

Databricks-update voor geregistreerde modellen

Werk het opgegeven geregistreerde model bij.

De beller moet een metastore-beheerder of een eigenaar van het 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 kunnen alleen de naam, de eigenaar of de opmerking van het geregistreerde model worden bijgewerkt.

databricks registered-models update FULL_NAME [flags]

Arguments

FULL_NAME

    De volledig gekwalificeerde drie-niveaus naam van het geregistreerde model.

Options

--comment string

    De opmerking die is gekoppeld aan het geregistreerde model.

--json JSON

    De inline JSON-tekenreeks of de link @path naar het JSON-bestand met de body van het verzoek.

'---nieuwe-naamtekenreeks'**

    Nieuwe naam voor het geregistreerde model.

--owner string

    De id van de gebruiker die eigenaar is van het geregistreerde model.

Globale vlaggen

Examples

In het volgende voorbeeld wordt de opmerking van een geregistreerd model bijgewerkt:

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

In het volgende voorbeeld wordt de naam van een geregistreerd model bijgewerkt:

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

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