Partager via


model-versions groupe de commande

Note

Ces informations s’appliquent à Databricks CLI versions 0.205 et ultérieures. L’interface CLI Databricks est en préversion publique.

L’utilisation de l’interface CLI Databricks est soumise à la licence Databricks et à la notification de confidentialité Databricks, y compris les dispositions relatives aux données d’utilisation.

Le model-versions groupe de commandes dans l’interface CLI Databricks contient des commandes pour gérer les versions de modèle dans le registre de modèles dans le catalogue Unity. Les modèles du catalogue Unity fournissent un contrôle d’accès centralisé, un audit, une traçabilité et une découverte des modèles ML dans les espaces de travail Databricks. Consultez Gérer le cycle de vie des modèles dans Unity Catalog.

databricks model-versions delete (supprimer les versions de modèle dans Databricks)

Supprime une version de modèle du modèle enregistré spécifié. Tous les alias affectés à la version du modèle seront également supprimés.

L’appelant doit être un administrateur de metastore ou un propriétaire du modèle enregistré parent. Pour ce dernier cas, l’appelant doit également être le propriétaire ou avoir le privilège USE_CATALOG sur le catalogue parent ainsi que le privilège USE_SCHEMA sur le schéma parent.

databricks model-versions delete FULL_NAME VERSION [flags]

Arguments

FULL_NAME

    Le nom qualifié complet (en trois niveaux) de la version du modèle

VERSION

    Numéro de version entier de la version du modèle

Options

Indicateurs globaux

Examples

L’exemple suivant supprime la version 1 d’un modèle :

databricks model-versions delete main.my_schema.my_model 1

databricks model-versions get (obtenir les versions de modèles databricks)

Obtenir une version de modèle.

L’appelant doit être un administrateur de metastore ou un propriétaire de (ou avoir le privilège EXECUTE) sur le modèle enregistré parent. Pour ce dernier cas, l’appelant doit également être le propriétaire ou avoir le privilège USE_CATALOG sur le catalogue parent ainsi que le privilège USE_SCHEMA sur le schéma parent.

databricks model-versions get FULL_NAME VERSION [flags]

Arguments

FULL_NAME

    Le nom qualifié complet (en trois niveaux) de la version du modèle

VERSION

    Numéro de version entier de la version du modèle

Options

--include-aliases

    Indique s’il faut inclure des alias associés à la version du modèle dans la réponse.

--include-browse

    Indique s’il faut inclure des versions de modèle dans la réponse pour laquelle le principal ne peut accéder qu’aux métadonnées sélectives.

Indicateurs globaux

Examples

L’exemple suivant obtient la version 1 d’un modèle :

databricks model-versions get main.my_schema.my_model 1

L’exemple suivant obtient la version 1 d’un modèle avec des alias inclus :

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

databricks model-versions get-by-alias - une commande pour récupérer des versions de modèle par alias dans databricks.

Obtient une version de modèle par alias.

L’appelant doit être un administrateur de Metastore ou un propriétaire de (ou avoir le EXECUTE privilège sur) le modèle enregistré. Pour ce dernier cas, l’appelant doit également être le propriétaire ou avoir le privilège USE_CATALOG sur le catalogue parent ainsi que le privilège USE_SCHEMA sur le schéma parent.

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

Arguments

FULL_NAME

    Le nom qualifié complet (en trois niveaux) du modèle enregistré

ALIAS

    Nom de l’alias

Options

--include-aliases

    Indique s’il faut inclure des alias associés à la version du modèle dans la réponse.

Indicateurs globaux

Examples

Voici comment obtenir une version de modèle à partir d'un alias :

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

L'exemple suivant récupère une version de modèle via son alias, en incluant les données d'alias associées :

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

liste des versions de modèle de Databricks

Liste les versions du modèle. Vous pouvez répertorier les versions de modèle sous un schéma particulier ou répertorier toutes les versions de modèle dans le metastore actuel.

Les modèles retournés sont filtrés en fonction des privilèges de l’utilisateur appelant. Par exemple, l’administrateur du metastore est en mesure de répertorier toutes les versions du modèle. Un utilisateur régulier doit être le propriétaire ou avoir le EXECUTE privilège sur le modèle enregistré parent pour recevoir les versions du modèle dans la réponse. Pour ce dernier cas, l’appelant doit également être le propriétaire ou avoir le privilège USE_CATALOG sur le catalogue parent ainsi que le privilège USE_SCHEMA sur le schéma parent.

Il n’existe aucune garantie d’ordre spécifique des éléments dans la réponse. Les éléments de la réponse ne contiennent pas d’alias ou de balises.

databricks model-versions list FULL_NAME [flags]

Arguments

FULL_NAME

    Nom complet à trois niveaux du modèle enregistré sous lequel répertorier les versions du modèle

Options

--include-browse

    Indique s’il faut inclure des versions de modèle dans la réponse pour laquelle le principal ne peut accéder qu’aux métadonnées sélectives.

--max-results int

    Nombre maximal de versions du modèle à renvoyer.

--page-token string

    Jeton de pagination opaque pour accéder à la page suivante en fonction de la requête précédente.

Indicateurs globaux

Examples

L’exemple suivant répertorie toutes les versions de modèle pour un modèle inscrit :

databricks model-versions list main.my_schema.my_model

L’exemple suivant répertorie les versions de modèle avec pagination :

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

mise à jour des versions de modèle "Databricks"

Mettez à jour la version de modèle spécifiée.

L’appelant doit être un administrateur de metastore ou un propriétaire du modèle enregistré parent. Pour ce dernier cas, l’appelant doit également être le propriétaire ou avoir le privilège USE_CATALOG sur le catalogue parent ainsi que le privilège USE_SCHEMA sur le schéma parent.

Actuellement, seul le commentaire de la version du modèle peut être mis à jour.

databricks model-versions update FULL_NAME VERSION [flags]

Arguments

FULL_NAME

    Le nom qualifié complet (en trois niveaux) de la version du modèle

VERSION

    Numéro de version entier de la version du modèle

Options

--comment string

    Commentaire attaché à la version du modèle.

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête

Indicateurs globaux

Examples

L’exemple suivant met à jour un commentaire de version de modèle :

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

L’exemple suivant met à jour une version de modèle à l’aide d’un fichier JSON :

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

Indicateurs globaux

--debug

  Active la journalisation du débogage.

-h ou --help

    Affiche l’aide pour l’interface CLI de Databricks, le groupe de commandes associé ou la commande concernée.

--log-file chaîne

    Chaîne représentant le fichier dans lequel écrire les journaux de sortie. Si cet indicateur n’est pas défini, les journaux de sortie sont écrits par défaut dans stderr.

--log-format format

    Format des journaux : text ou json. La valeur par défaut est text.

--log-level chaîne

    Chaîne représentant le niveau de journalisation. Si cet indicateur n’est pas défini, le niveau de format de journal est désactivé.

Type -o, --output

    Type de sortie de commande, text ou json. La valeur par défaut est text.

-p, --profile chaîne

    Nom du profil dans le ~/.databrickscfg fichier à utiliser pour exécuter la commande. Si cet indicateur n’est pas spécifié, s’il existe, le profil nommé DEFAULT est utilisé.

--progress-format format

    Format d’affichage des journaux d’activité de progression : default, append, inplace ou json

-t, --target chaîne

    Le cas échéant, la cible d’offre groupée à utiliser