environments 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 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.

Indicateurs globaux

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

Indicateurs globaux

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

Indicateurs globaux

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

Indicateurs globaux

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

Indicateurs globaux

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.

Indicateurs globaux

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.

Indicateurs globaux

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.

Indicateurs globaux

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.

Indicateurs globaux

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