groupe de commandesmodel-versions
L'utilisation de Databricks CLI est soumise à la licence Databricks et à la politique de confidentialité Databricks, y compris toutes les dispositions relatives aux données d'utilisation.
Le groupe de commandes model-versions au sein du Databricks CLI contient des commandes pour gérer les versions de modèles dans le registre de modèles dans Unity Catalog. Les modèles dans Unity Catalog offrent un contrôle d'accès centralisé, un audit, une traçabilité et la découverte de modèles ML dans les Databricks Workspace. Consultez Gérer le cycle de vie des modèles dans Unity Catalog.
databricks model-versions delete
Supprimer une version de modèle du modèle enregistré spécifié. Tous les alias attribués à la version du modèle seront également supprimés.
L'appelant doit être administrateur du métastore ou propriétaire du modèle enregistré parent. Dans ce dernier cas, l'appelant doit également être le propriétaire ou avoir le privilège USE_CATALOG sur le catalogue parent et le privilège USE_SCHEMA sur le schéma parent.
databricks model-versions delete FULL_NAME VERSION [flags]
Arguments
FULL_NAME
Nom de la version du modèle à trois niveaux (entièrement qualifié)
VERSION
Le numéro de version entier de la version du modèle
Options
Exemples
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 une version de modèle.
L'appelant doit être un administrateur de métastore ou un propriétaire (ou avoir le privilège EXECUTE sur) le modèle enregistré parent. Dans ce dernier cas, l'appelant doit également être le propriétaire ou avoir le privilège USE_CATALOG sur le catalogue parent et le privilège USE_SCHEMA sur le schéma parent.
databricks model-versions get FULL_NAME VERSION [flags]
Arguments
FULL_NAME
Nom de la version du modèle à trois niveaux (entièrement qualifié)
VERSION
Le numéro de version entier de la version du modèle
Options
--include-aliases
Indique s’il faut inclure les alias associés à la version du modèle dans la réponse.
--include-browse
Indique s'il faut inclure les versions de modèle dans la réponse pour lesquelles le principal ne peut accéder qu'à des métadonnées sélectives.
Exemples
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 les alias inclus :
databricks model-versions get main.my_schema.my_model 1 --include-aliases
databricks model-versions get-by-alias
Obtenir une version de modèle par alias.
L’appelant doit être un administrateur du métastore ou un propriétaire (ou disposer du privilège EXECUTE) du modèle enregistré. Dans ce dernier cas, l'appelant doit également être le propriétaire ou avoir le privilège USE_CATALOG sur le catalogue parent et 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 à trois niveaux (entièrement qualifié) du modèle enregistré
ALIAS
Le nom de l'alias
Options
--include-aliases
Indique s’il faut inclure les alias associés à la version du modèle dans la réponse.
Exemples
L'exemple suivant obtient une version de modèle par alias :
databricks model-versions get-by-alias main.my_schema.my_model production
L'exemple suivant obtient une version de modèle par alias avec les alias inclus :
databricks model-versions get-by-alias main.my_schema.my_model production --include-aliases
liste des versions de modèles Databricks
Lister les versions de modèle. Vous pouvez lister les versions de modèle sous un schéma particulier ou lister toutes les versions de modèle dans le metastore actuel.
Les modèles renvoyés sont filtrés en fonction des privilèges de l'utilisateur appelant. Par exemple, l'administrateur du métastore peut lister toutes les versions de modèle. Un utilisateur ordinaire doit être le propriétaire ou avoir le privilège EXECUTE sur le modèle enregistré parent pour recevoir les versions du modèle dans la réponse. Dans ce dernier cas, l'appelant doit également être le propriétaire ou avoir le privilège USE_CATALOG sur le catalogue parent et le privilège USE_SCHEMA sur le schéma parent.
Il n'y a aucune garantie concernant l'ordre spécifique des éléments dans la réponse. Les éléments de la réponse ne contiendront aucun alias ni aucune balise.
databricks model-versions list FULL_NAME [flags]
Arguments
FULL_NAME
Le nom complet à trois niveaux du modèle enregistré sous lequel lister les versions du modèle
Options
--include-browse
Indique s'il faut inclure les versions de modèle dans la réponse pour lesquelles le principal ne peut accéder qu'à des métadonnées sélectives.
--max-results int
Nombre maximal de versions de modèles à retourner.
--page-token string
Jeton de pagination opaque pour aller à la page suivante basé sur la query précédente.
Exemples
L'exemple suivant répertorie toutes les versions de modèle pour un modèle enregistré :
databricks model-versions list main.my_schema.my_model
L'exemple suivant liste les versions de modèle avec pagination :
databricks model-versions list main.my_schema.my_model --max-results 10 --page-token abc123token
databricks model-versions update
Mettre à jour la version du modèle spécifiée.
L'appelant doit être administrateur du métastore ou propriétaire du modèle enregistré parent. Dans ce dernier cas, l'appelant doit également être le propriétaire ou avoir le privilège USE_CATALOG sur le catalogue parent et 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
Nom de la version du modèle à trois niveaux (entièrement qualifié)
VERSION
Le numéro de version entier de la version du modèle
Options
--comment string
Le commentaire associé à la version du modèle.
--json JSON
La chaîne JSON en ligne ou le @path vers le fichier JSON avec le corps de la requête
Exemples
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
Drapeaux globaux
--debug
Activer ou non la journalisation de débogage.
-h OU --help
Afficher l'aide de Databricks CLI ou du groupe de commandes associé ou de la commande associée.
--log-file chaîne
Une chaîne représentant le fichier dans lequel écrire les logs de sortie. Si cet indicateur n'est pas spécifié, la default est d'écrire les logs de sortie dans stderr.
--log-format Format
Le type de format de log, text ou json. La valeur par default est text.
--log-level chaîne
Une chaîne représentant le niveau de format du log. S'il n'est pas spécifié, le niveau de format du log est désactivé.
-o, --output Type
Le type de sortie de commande, text ou json. La valeur par default est text.
-p, --profile chaîne
Nom du profil dans le fichier ~/.databrickscfg à utiliser pour exécuter la commande. Si cet indicateur n'est pas spécifié, alors s'il existe, le profil nommé DEFAULT est utilisé.
--progress-format Format
Le format pour afficher les logs de progression : default, append, inplace ou json
-t, --target chaîne
Le cas échéant, la cible de bundle à utiliser