Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 environments groupe de commandes au sein de l’interface CLI Databricks vous permet de gérer les ressources d’environnement. L’API Environnements fournit des fonctionnalités de gestion pour différents types d’environnements, notamment les environnements de base au niveau de l’espace de travail qui définissent la version et les dépendances de l’environnement à utiliser dans les notebooks et travaux serverless.
environnements databricks create-workspace-base-environment
Créez un environnement de base d’espace de travail. Il s’agit d’une opération de longue durée qui génère de façon asynchrone un environnement matérialisé pour optimiser la résolution des dépendances.
databricks environments create-workspace-base-environment DISPLAY_NAME [flags]
Arguments
DISPLAY_NAME
Nom d’affichage lisible par l’homme pour l’environnement de base de l’espace de travail.
Options
--base-environment-type BaseEnvironmentType
Type d’environnement de base (PROCESSEUR ou GPU). Valeurs prises en charge : CPU, GPU
--filepath string
Les fichiers d’espace de travail ou le chemin des volumes du catalogue Unity vers le fichier YAML de l’environnement.
--json JSON
Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.
--name string
Nom de la ressource de l’environnement de base de l’espace de travail.
--no-wait
N’attendez pas d’atteindre DONE l’état.
--request-id string
Identificateur unique pour cette requête.
--timeout duration
Durée maximale d’accès DONE à l’état.
--workspace-base-environment-id string
ID à utiliser pour l’environnement de base de l’espace de travail, qui deviendra le composant final du nom de la ressource.
Examples
L’exemple suivant crée un environnement de base d’espace de travail processeur :
databricks environments create-workspace-base-environment "My Python Env" --base-environment-type CPU --filepath /Workspace/environments/env.yaml
environnements databricks delete-workspace-base-environment
Supprimez un environnement de base d’espace de travail. La suppression d’un environnement de base peut avoir un impact sur les blocs-notes et les travaux liés. Cette action est irréversible.
databricks environments delete-workspace-base-environment NAME [flags]
Arguments
NAME
Obligatoire. Nom de la ressource de l’environnement de base de l’espace de travail à supprimer. Format : workspace-base-environments/{workspace_base_environment}.
Options
Examples
L’exemple suivant supprime un environnement de base d’espace de travail :
databricks environments delete-workspace-base-environment workspace-base-environments/my-env-id
environnements databricks get-default-workspace-base-environment
Obtenez la configuration de l’environnement de base de l’espace de travail par défaut. Retourne les paramètres d’environnement de base par défaut actuels pour le calcul processeur et GPU.
databricks environments get-default-workspace-base-environment NAME [flags]
Arguments
NAME
Nom de ressource statique de l’environnement de base de l’espace de travail par défaut. Format : default-workspace-base-environment.
Options
Examples
L’exemple suivant obtient l’environnement de base de l’espace de travail par défaut :
databricks environments get-default-workspace-base-environment default-workspace-base-environment
databricks environnements get-operation
Obtenez l’état d’une opération de longue durée. Les clients peuvent utiliser cette méthode pour interroger le résultat de l’opération.
databricks environments get-operation NAME [flags]
Arguments
NAME
Nom de la ressource d’opération.
Options
Examples
L’exemple suivant obtient l’état d’une opération de longue durée :
databricks environments get-operation operations/1234567890
environnements databricks get-workspace-base-environment
Obtenez un environnement de base d’espace de travail par son nom.
databricks environments get-workspace-base-environment NAME [flags]
Arguments
NAME
Obligatoire. Nom de la ressource de l’environnement de base de l’espace de travail à récupérer. Format : workspace-base-environments/{workspace_base_environment}.
Options
Examples
L’exemple suivant obtient un environnement de base d’espace de travail :
databricks environments get-workspace-base-environment workspace-base-environments/my-env-id
databricks environment list-workspace-base-environments
Répertoriez tous les environnements de base de l’espace de travail dans l’espace de travail.
databricks environments list-workspace-base-environments [flags]
Arguments
None
Options
--page-size int
Nombre maximal d’environnements à retourner par page.
--page-token string
Jeton de page pour la pagination.
Examples
L’exemple suivant répertorie tous les environnements de base de l’espace de travail :
databricks environments list-workspace-base-environments
environnements databricks refresh-workspace-base-environment
Actualisez l’environnement matérialisé pour un environnement de base d’espace de travail. Il s’agit d’une opération de longue durée qui régénère de façon asynchrone l’environnement matérialisé. L’environnement matérialisé existant reste disponible jusqu’à son expiration.
databricks environments refresh-workspace-base-environment NAME [flags]
Arguments
NAME
Obligatoire. Nom de la ressource de l’environnement de base de l’espace de travail à actualiser. Format : workspace-base-environments/{workspace_base_environment}.
Options
--no-wait
N’attendez pas d’atteindre DONE l’état.
--timeout duration
Durée maximale d’accès DONE à l’état.
Examples
L’exemple suivant actualise un environnement de base d’espace de travail :
databricks environments refresh-workspace-base-environment workspace-base-environments/my-env-id
environnements databricks update-default-workspace-base-environment
Mettez à jour la configuration de l’environnement de base de l’espace de travail par défaut. Définit les environnements de base spécifiés comme paramètres par défaut de l’espace de travail pour le calcul processeur et/ou GPU.
databricks environments update-default-workspace-base-environment NAME UPDATE_MASK [flags]
Arguments
NAME
Nom de la ressource de cette ressource singleton. Format : default-workspace-base-environment.
UPDATE_MASK
Masque de champ spécifiant les champs à mettre à jour. Chemins de champ valides : cpu_workspace_base_environment, gpu_workspace_base_environment. Permet * de mettre à jour tous les champs.
Options
--cpu-workspace-base-environment string
Environnement de base d’espace de travail par défaut pour le calcul du processeur.
--gpu-workspace-base-environment string
Environnement de base d’espace de travail par défaut pour le calcul GPU.
--json JSON
Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.
--name string
Nom de la ressource de cette ressource singleton.
Examples
L’exemple suivant définit l’environnement de base de l’espace de travail processeur par défaut :
databricks environments update-default-workspace-base-environment default-workspace-base-environment cpu_workspace_base_environment --cpu-workspace-base-environment workspace-base-environments/my-cpu-env
environnements databricks update-workspace-base-environment
Mettez à jour un environnement de base d’espace de travail existant. Il s’agit d’une opération de longue durée qui régénère de façon asynchrone l’environnement matérialisé. L’environnement matérialisé existant reste disponible jusqu’à son expiration.
databricks environments update-workspace-base-environment NAME DISPLAY_NAME [flags]
Arguments
NAME
Nom de la ressource de l’environnement de base de l’espace de travail. Format : workspace-base-environments/{workspace_base_environment}.
DISPLAY_NAME
Nom d’affichage lisible par l’homme pour l’environnement de base de l’espace de travail.
Options
--base-environment-type BaseEnvironmentType
Type d’environnement de base (PROCESSEUR ou GPU). Valeurs prises en charge : CPU, GPU
--filepath string
Les fichiers d’espace de travail ou le chemin des volumes de catalogue Unity vers le fichier YAML de l’environnement.
--json JSON
Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.
--name string
Nom de la ressource de l’environnement de base de l’espace de travail.
--no-wait
N’attendez pas d’atteindre DONE l’état.
--timeout duration
Durée maximale d’accès DONE à l’état.
Examples
L’exemple suivant met à jour un environnement de base d’espace de travail :
databricks environments update-workspace-base-environment workspace-base-environments/my-env-id "Updated Python Env" --filepath /Workspace/environments/updated-env.yaml
Indicateurs globaux
--debug
Faut-il activer 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 de caractères
Chaîne représentant le fichier utilisé pour écrire les logs de sortie. Si cet indicateur n’est pas défini, les journaux de sortie sont écrits par défaut dans stderr.
--log-format Format
Type de format de journal : text ou json. La valeur par défaut est text.
--log-level chaîne de caractères
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 de caractères
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 permettant d’afficher les journaux de progression : default, append, inplace ou json
-t, --target chaîne de caractères
Le cas échéant, la cible d'ensemble à utiliser