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 account workspaces groupe de commandes dans l’interface CLI Databricks contient des commandes pour gérer les espaces de travail de votre compte. Un espace de travail Databricks est un environnement permettant d’accéder à toutes vos ressources Databricks. L’espace de travail organise des objets (notebooks, bibliothèques et expériences) dans des dossiers et fournit un accès aux données et aux ressources de calcul telles que les clusters et les travaux. Consultez Créer un espace de travail.
Note
Ces commandes sont disponibles si votre compte se trouve sur la version E2 de la plateforme ou sur un plan personnalisé sélectionné qui autorise plusieurs espaces de travail par compte.
databricks account workspaces create
Créez un espace de travail à l’aide d’une configuration d’informations d’identification et d’une configuration de stockage, une configuration réseau facultative (si vous utilisez un VPC géré par le client), une configuration de clé de services managées facultative (si vous utilisez des clés gérées par le client pour le stockage).
Important
Cette opération est asynchrone. Une réponse avec le code d’état HTTP 200 signifie que la requête a été acceptée et est en cours d’exécution, mais ne signifie pas que l’espace de travail a été déployé avec succès et est en cours d’exécution. L’état initial de l’espace de travail est généralement PROVISIONING. Utilisez le champ ID de l’espace de travail (workspace_id) dans la réponse pour identifier le nouvel espace de travail et effectuer des requêtes répétées GET avec l’ID de l’espace de travail et vérifier son état. L’espace de travail devient disponible lorsque l’état passe à RUNNING.
databricks account workspaces create [flags]
Options
--workspace-name string
Nom lisible par l’homme de l’espace de travail.
--deployment-name string
Le nom du déploiement définit une partie du sous-domaine de l’espace de travail.
--aws-region string
Région AWS de l’espace de travail.
--cloud string
Nom du cloud.
--location string
Région Google Cloud du plan de données de l’espace de travail dans votre compte Google (par exemple). us-east4
--credentials-id string
ID de l’objet de configuration des informations d’identification de l’espace de travail.
--storage-configuration-id string
ID de l’objet de configuration de stockage de l’espace de travail.
--network-id string
ID de l’objet de configuration réseau de l’espace de travail.
--managed-services-customer-managed-key-id string
ID de l’objet de configuration de clé de chiffrement des services managés de l’espace de travail.
--storage-customer-managed-key-id string
ID de l’objet de configuration de clé de chiffrement de stockage de l’espace de travail.
--private-access-settings-id string
ID de l’objet de paramètres d’accès privé de l’espace de travail.
--network-connectivity-config-id string
ID d’objet de la configuration de connectivité réseau.
--compute-mode CustomerFacingComputeMode
Si le mode de calcul est SERVERLESS, un espace de travail serverless est créé. Valeurs prises en charge : HYBRID, SERVERLESS.
--pricing-tier PricingTier
Niveau tarifaire de l’espace de travail. Valeurs prises en charge : COMMUNITY_EDITION, , DEDICATEDENTERPRISE, PREMIUMSTANDARD, UNKNOWN.
--no-wait
N’attendez pas d’atteindre l’état RUNNING.
--timeout duration
Durée maximale d’atteindre l’état RUNNING (20m0s par défaut).
--json JSON
Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête
Exemples
L’exemple suivant crée un espace de travail à l’aide de JSON :
databricks account workspaces create --json '{"workspace_name": "my-workspace", "deployment_name": "my-workspace-deployment", "aws_region": "us-west-2", "credentials_id": "cred-abc123", "storage_configuration_id": "storage-xyz789"}'
L’exemple suivant crée un espace de travail à l’aide d’un fichier JSON :
databricks account workspaces create --json @workspace.json
L’exemple suivant crée un espace de travail avec des indicateurs de ligne de commande :
databricks account workspaces create --workspace-name "my-workspace" --deployment-name "my-workspace-deployment" --aws-region "us-west-2" --credentials-id "cred-abc123" --storage-configuration-id "storage-xyz789"
databricks account workspaces delete
Supprimez un espace de travail Databricks, spécifié par ID.
databricks account workspaces delete WORKSPACE_ID [flags]
Arguments
WORKSPACE_ID
ID entier unique de l’espace de travail.
Options
Exemples
L’exemple suivant supprime un espace de travail par ID :
databricks account workspaces delete 123456789
databricks account workspaces get
Obtenez des informations, notamment l’état d’un espace de travail Databricks, spécifié par ID. Dans la réponse, le workspace_status champ indique l’état actuel. Après la création initiale de l’espace de travail (qui est asynchrone), effectuez des requêtes répétées GET avec l’ID de l’espace de travail et vérifiez son état. L’espace de travail devient disponible lorsque l’état passe à RUNNING.
databricks account workspaces get WORKSPACE_ID [flags]
Arguments
WORKSPACE_ID
ID entier unique de l’espace de travail.
Options
Exemples
L’exemple suivant obtient un espace de travail par ID :
databricks account workspaces get 123456789
liste des espaces de travail de compte databricks
Répertorier les espaces de travail Databricks pour un compte.
databricks account workspaces list [flags]
Options
Exemples
L’exemple suivant répertorie tous les espaces de travail :
databricks account workspaces list
mise à jour des espaces de travail de compte databricks
Mettez à jour une configuration d’espace de travail.
databricks account workspaces update WORKSPACE_ID [flags]
Arguments
WORKSPACE_ID
ID entier unique de l’espace de travail.
Options
--workspace-name string
Nom lisible par l’homme de l’espace de travail.
--deployment-name string
Nom du déploiement de l’espace de travail.
--aws-region string
Région AWS de l’espace de travail.
--cloud string
Nom du cloud.
--location string
Région Google Cloud du plan de données de l’espace de travail dans votre compte Google (par exemple). us-east4
--credentials-id string
ID de l’objet de configuration des informations d’identification de l’espace de travail.
--storage-configuration-id string
ID de l’objet de configuration de stockage de l’espace de travail.
--network-id string
Si cet espace de travail est BYO VPC, le network_id est renseigné.
--managed-services-customer-managed-key-id string
ID de la configuration de clé pour le chiffrement des services managés.
--storage-customer-managed-key-id string
ID de la configuration de clé pour le chiffrement du stockage de l’espace de travail.
--private-access-settings-id string
ID de l’objet de paramètres d’accès privé de l’espace de travail.
--network-connectivity-config-id string
ID d’objet de la configuration de connectivité réseau.
--expected-workspace-status WorkspaceStatus
Champ appartenant au client utilisé pour indiquer l’état de l’espace de travail dans lequel le client s’attend. Valeurs prises en charge : BANNED, , CANCELLINGFAILED, NOT_PROVISIONEDPROVISIONING, RUNNING.
--update-mask string
Le masque de champ doit être une seule chaîne, avec plusieurs champs séparés par des virgules (aucun espace).
--no-wait
N’attendez pas d’atteindre l’état RUNNING.
--timeout duration
Durée maximale d’atteindre l’état RUNNING (20m0s par défaut).
--json JSON
Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête
Exemples
L’exemple suivant met à jour un nom d’espace de travail :
databricks account workspaces update 123456789 --workspace-name "updated-workspace-name"
L’exemple suivant met à jour un espace de travail à l’aide de JSON :
databricks account workspaces update 123456789 --json '{"workspace_name": "updated-workspace-name", "credentials_id": "cred-new123"}'
L’exemple suivant met à jour un espace de travail à l’aide d’un fichier JSON :
databricks account workspaces update 123456789 --json @update-workspace.json
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