registered-models Befehlsgruppe

Note

Diese Informationen gelten für Databricks CLI-Versionen 0.205 und höher. Die Databricks CLI befindet sich in der öffentlichen Vorschau.

Die Verwendung von Databricks CLI unterliegt der Datenbricks-Lizenz - und Databricks-Datenschutzerklärung, einschließlich der Bestimmungen zu Nutzungsdaten.

Die registered-models Befehlsgruppe in der Databricks CLI enthält Befehle zum Verwalten von Modellen in der Modellregistrierung im Unity-Katalog. Registrierte Modelle bieten zentrale Zugriffssteuerung, Überwachung, Lineage und Ermittlung von ML-Modellen in Databricks-Arbeitsbereichen. Weitere Informationen dazu finden Sie unter Verwalten des Lebenszyklus von Modellen in Unity Catalog.

databricks registered-models create

Erstellen Sie ein neues registriertes Modell im Unity-Katalog.

Dateispeicher für Modellversionen im registrierten Modell befindet sich am Standardspeicherort, der durch das übergeordnete Schema oder den übergeordneten Katalog oder den Metastore angegeben wird.

Damit die Registrierte Modellerstellung erfolgreich ist, muss der Benutzer die folgenden Bedingungen erfüllen:

• Der Aufrufer muss ein Metastore-Administrator sein oder der Besitzer des übergeordneten Katalogs und Schemas sein oder über die USE_CATALOG Berechtigungen für den übergeordneten Katalog und die USE_SCHEMA Berechtigungen für das übergeordnete Schema verfügen.
• Der Aufrufer muss über die CREATE MODEL- oder CREATE FUNCTION-Berechtigung für das übergeordnete Schema verfügen.

databricks registered-models create CATALOG_NAME SCHEMA_NAME NAME [flags]

Arguments

CATALOG_NAME

    Der Name des Katalogs, in dem sich das Schema und das registrierte Modell befinden.

SCHEMA_NAME

    Der Name des Schemas, in dem sich das registrierte Modell befindet.

NAME

    Der Name des registrierten Modells.

Options

--comment string

    Der Kommentar, der dem registrierten Modell zugeordnet ist.

--json JSON

    Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.

--storage-location string

    Der Speicherort in der Cloud, unter dem Modellversionsdatendateien gespeichert werden.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird ein registriertes Modell im angegebenen Katalog und Schema erstellt:

databricks registered-models create main my_schema my_model

Im folgenden Beispiel wird ein registriertes Modell mit einem Kommentar erstellt:

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

databricks registrierte Modelle löschen

Löschen Sie ein registriertes Modell und alle zugehörigen Modellversionen aus dem angegebenen übergeordneten Katalog und Schema.

Der Aufrufer muss ein Metastore-Administrator oder ein Besitzer des registrierten Modells sein. Im letzteren Fall muss der Aufrufer auch der Besitzer sein oder über die USE_CATALOG Berechtigungen für den übergeordneten Katalog und die USE_SCHEMA Berechtigungen für das übergeordnete Schema verfügen.

databricks registered-models delete FULL_NAME [flags]

Arguments

FULL_NAME

    Der dreistufige (vollqualifizierte) Name des registrierten Modells.

Options

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird ein registriertes Modell gelöscht:

databricks registered-models delete main.my_schema.my_model

databricks registrierte-modelle löschen-alias

Löschen eines registrierten Modellalias.

Der Aufrufer muss ein Metastore-Administrator oder ein Besitzer des registrierten Modells sein. Im letzteren Fall muss der Aufrufer auch der Besitzer sein oder über die USE_CATALOG Berechtigungen für den übergeordneten Katalog und die USE_SCHEMA Berechtigungen für das übergeordnete Schema verfügen.

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

Arguments

FULL_NAME

    Der dreistufige (vollqualifizierte) Name des registrierten Modells.

ALIAS

    Der Name des Alias.

Options

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird ein registrierter Modellalias gelöscht:

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

Befehl: databricks registered-models get

Ein registriertes Modell abrufen.

Der Aufrufer muss ein Metastore-Administrator oder ein Besitzer des registrierten Modells sein (oder über die EXECUTE Berechtigung verfügen). Im letzteren Fall muss der Aufrufer auch der Besitzer sein oder über die USE_CATALOG Berechtigungen für den übergeordneten Katalog und die USE_SCHEMA Berechtigungen für das übergeordnete Schema verfügen.

databricks registered-models get FULL_NAME [flags]

Arguments

FULL_NAME

    Der dreistufige (vollqualifizierte) Name des registrierten Modells.

Options

--include-aliases

    Gibt an, ob registrierte Modellalias in die Antwort eingeschlossen werden sollen.

--include-browse

    Ob registrierte Modelle in die Antwort aufgenommen werden sollen, für die der Hauptbenutzer nur auf selektive Metadaten zugreifen kann.

Globale Kennzeichnungen

Examples

Das folgende Beispiel ruft Informationen zu einem registrierten Modell ab:

databricks registered-models get main.my_schema.my_model

Im folgenden Beispiel werden Informationen zu einem registrierten Modell einschließlich Aliasen angezeigt:

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

Verwenden Sie den Befehl `databricks registered-models list`, um die Liste der registrierten Modelle in Databricks anzuzeigen.

Registrierte Modelle auflisten. Sie können registrierte Modelle unter einem bestimmten Schema auflisten oder alle registrierten Modelle im aktuellen Metastore auflisten.

Die zurückgegebenen Modelle werden basierend auf den Berechtigungen des aufrufenden Benutzers gefiltert. Beispielsweise kann der Metastore-Administrator alle registrierten Modelle auflisten. Ein normaler Benutzer muss der Besitzer sein oder über die EXECUTE Berechtigungen für das registrierte Modell verfügen, um die registrierten Modelle in der Antwort zu erhalten. Im letzteren Fall muss der Aufrufer auch der Besitzer sein oder über die USE_CATALOG Berechtigungen für den übergeordneten Katalog und die USE_SCHEMA Berechtigungen für das übergeordnete Schema verfügen.

Es gibt keine Garantie für eine bestimmte Reihenfolge der Elemente in der Antwort.

databricks registered-models list [flags]

Options

--catalog-name string

    Der Bezeichner des Katalogs, unter dem registrierte Modelle aufgeführt werden sollen.

--include-browse

    Ob registrierte Modelle in die Antwort aufgenommen werden sollen, für die der Hauptbenutzer nur auf selektive Metadaten zugreifen kann.

--max-results int

    Maximale Anzahl registrierter Modelle, die zurückgegeben werden sollen.

--page-token string

    Undurchsichtiges Token, das für die nächste Seite der Ergebnisse (Paginierung) gesendet werden soll.

--schema-name string

    Der Bezeichner des Schemas, unter dem registrierte Modelle aufgeführt werden sollen.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel werden alle registrierten Modelle im aktuellen Metastore aufgelistet:

databricks registered-models list

Im folgenden Beispiel werden registrierte Modelle in einem bestimmten Katalog aufgelistet:

databricks registered-models list --catalog-name main

Im folgenden Beispiel werden registrierte Modelle in einem bestimmten Schema aufgelistet:

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

databricks registered-models set-alias

Legen Sie einen Alias für das angegebene registrierte Modell fest.

Der Aufrufer muss ein Metastore-Administrator oder ein Besitzer des registrierten Modells sein. Im letzteren Fall muss der Aufrufer auch der Besitzer sein oder über die USE_CATALOG Berechtigungen für den übergeordneten Katalog und die USE_SCHEMA Berechtigungen für das übergeordnete Schema verfügen.

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

Arguments

FULL_NAME

    Vollständiger Name des registrierten Modells.

ALIAS

    Der Name des Alias.

VERSION_NUM

    Die Versionsnummer der Modellversion, auf die der Alias verweist.

Options

--json JSON

    Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird ein Alias für ein registriertes Modell festgelegt:

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

databricks registered-models Aktualisierung

Aktualisieren Sie das angegebene registrierte Modell.

Der Aufrufer muss ein Metastore-Administrator oder ein Besitzer des registrierten Modells sein. Im letzteren Fall muss der Aufrufer auch der Besitzer sein oder über die USE_CATALOG Berechtigungen für den übergeordneten Katalog und die USE_SCHEMA Berechtigungen für das übergeordnete Schema verfügen.

Derzeit kann nur der Name, der Besitzer oder der Kommentar des registrierten Modells aktualisiert werden.

databricks registered-models update FULL_NAME [flags]

Arguments

FULL_NAME

    Der dreistufige (vollqualifizierte) Name des registrierten Modells.

Options

--comment string

    Der Kommentar, der dem registrierten Modell zugeordnet ist.

--json JSON

    Die inlinefähige JSON-Zeichenfolge oder die @path zur JSON-Datei mit dem Body der Anfrage.

''--new-name string'**

    Neuer Name für das registrierte Modell.

--owner string

    Der Bezeichner des Benutzers, der das registrierte Modell besitzt.

Globale Kennzeichnungen

Examples

Im folgenden Beispiel wird der Kommentar eines registrierten Modells aktualisiert:

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

Im folgenden Beispiel wird der Name eines registrierten Modells aktualisiert:

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

Globale Kennzeichnungen

--debug

  Gibt an, ob die Debugprotokollierung aktiviert werden soll.

-h oder --help

    Hilfe für die Databricks CLI oder die zugehörige Befehlsgruppe oder den zugehörigen Befehl anzeigen.

--log-file Schnur

    Eine Zeichenfolge, die die Datei darstellt, in die Ausgabeprotokolle geschrieben werden sollen. Wenn dieses Flag nicht angegeben ist, werden Ausgabeprotokolle standardmäßig in stderr geschrieben.

--log-format Format

    Der Protokollformattyp text oder json. Der Standardwert ist text.

--log-level Schnur

    Eine Zeichenfolge, die die Protokollformatebene darstellt. Wenn nicht angegeben, ist die Protokollformatebene deaktiviert.

-o, --output Typ

    Der Befehlsausgabetyp text oder json. Der Standardwert ist text.

-p, --profile Schnur

    Der Name des Profils in der ~/.databrickscfg Datei, das zum Ausführen des Befehls verwendet werden soll. Wenn dieses Flag nicht angegeben wird, wird, falls vorhanden, das Profil mit dem Namen DEFAULT verwendet.

--progress-format Format

    Das Format zum Anzeigen von Statusprotokollen: default, , append, inplaceoder json

-t, --target Schnur

    Falls zutreffend, das zu verwendende Bündelziel