sandbox groupe de commande

Note

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 sandbox groupe de commandes au sein de l’interface CLI Databricks vous aide à créer, configurer et accéder aux environnements Databricks Sandbox.

Important

Databricks Sandbox est en version bêta.

Les environnements Databricks Sandbox sont des environnements de développement accessibles par SSH soutenus par l’isolation de microVM. Chaque bac à sable est un environnement personnel avec des outils préinstallés (Python, Node.js, Rust et Databricks CLI) et un stockage persistant.

Pour démarrer :

databricks auth login --host https://...
databricks sandbox register
databricks sandbox create
databricks sandbox ssh

configuration de bac à sable databricks

Configurez le nom d’un bac à sable et la stratégie d’arrêt automatique.

Les --nameparamètres et --idle-timeout les paramètres --no-autostopsont indépendants et vous pouvez passer n’importe quelle combinaison.

databricks sandbox config <sandbox-id> [flags]

Arguments

<sandbox-id>

    ID du bac à sable à configurer.

Options

--name string

    Étiquette pour le bac à sable (256 octets maximum). --name= Passez à effacer.

--idle-timeout string

    Durée du délai d’inactivité. Définissez cette valeur sur 0 (ou 0s) pour l’effacer et utiliser la valeur par défaut du gestionnaire (10m). Plage valide : 1m à 24h.

--no-autostop

    Lorsque la valeur est true, ce bac à sable ne s’arrête jamais automatiquement en cas d’inactivité. --no-autostop=false Passez à rétablir.

Indicateurs globaux

Exemples

databricks sandbox config my-sandbox-1234 --name my-project
databricks sandbox config my-sandbox-1234 --idle-timeout 15m
databricks sandbox config my-sandbox-1234 --idle-timeout 1h30m
databricks sandbox config my-sandbox-1234 --idle-timeout 0
databricks sandbox config my-sandbox-1234 --no-autostop
databricks sandbox config my-sandbox-1234 --no-autostop=false
databricks sandbox config my-sandbox-1234 --idle-timeout 30m --no-autostop=false

crée des briques de données

Créez un environnement de bac à sable.

Crée un environnement de développement personnel soutenu par une microVM, bloque jusqu’à ce que le bac à sable soit en cours d’exécution et imprime l’ID de bac à sable.

databricks sandbox create [flags]

Options

--json

    Retourne les résultats au format JSON.

--name string

    Étiquette pour le bac à sable (256 octets maximum).

Indicateurs globaux

Exemples

databricks sandbox create
databricks sandbox create --name my-project
databricks sandbox create --json

databricks sandbox par défaut

Définissez le bac à sable par défaut utilisé par databricks sandbox ssh.

La valeur par défaut est stockée localement par ~/.databricks/sandbox.json profil. L’ID de bac à sable est validé sur le serveur avant d’être écrit.

databricks sandbox default <sandbox-id> [flags]

Alias: set-default

Arguments

<sandbox-id>

    ID de bac à sable à définir comme valeur par défaut.

Options

Indicateurs globaux

Exemple

databricks sandbox default my-sandbox-1234

suppression de bac à sable databricks

Supprimez un environnement de bac à sable.

Cette opération se termine définitivement et supprime le bac à sable spécifié. La commande invite à confirmer de façon interactive ; permet --auto-approve d’ignorer l’invite.

databricks sandbox delete <sandbox-id> [flags]

Arguments

<sandbox-id>

    ID de bac à sable à supprimer.

Options

--auto-approve

    Ignorez l’invite de confirmation interactive.

Indicateurs globaux

Exemples

databricks sandbox delete my-sandbox-1234
databricks sandbox delete my-sandbox-1234 --auto-approve

liste de bacs à sable databricks

Répertoriez vos environnements de bac à sable.

Affiche tous les bacs à sable associés à votre compte, y compris leur état et leur ID actuels.

databricks sandbox list [flags]

Options

--json

    Retourne les résultats au format JSON.

Indicateurs globaux

Exemples

databricks sandbox list
databricks sandbox list --json

registre de bac à sable databricks

Générez une clé SSH dédiée pour le bac à sable et inscrivez-la auprès du service.

Cette commande :

  1. Génère une clé SSH Ed25519 à l’emplacement ~/.ssh/sandbox_ed25519 (s’il n’existe pas).
  2. Inscrit la clé publique auprès du service sandbox, étiquetée avec --name.
  3. Si vous le souhaitez, mettez à jour ~/.ssh/config avec une Host sandbox-gw entrée.

Après l’inscription, databricks sandbox ssh utilise cette clé automatiquement.

databricks sandbox register [flags]

Options

--name string

    Étiquette de la clé inscrite (valeur par défaut du nom d’hôte de cette machine). --name= Passez à inscrire sans étiquette.

Indicateurs globaux

Exemples

databricks sandbox register
databricks sandbox register --name my-laptop

Databricks Sandbox SSH

SSH vers votre environnement de bac à sable par défaut ou spécifique. Arguments supplémentaires après -- avoir été passés directement à ssh.

databricks sandbox ssh [sandbox-id] [-- <ssh-args-or-command>...] [flags]

Arguments

[sandbox-id]

    ID de bac à sable facultatif. S’il est omis, utilise votre bac à sable par défaut.

Options

--gateway string

    Nom d’hôte de la passerelle de bac à sable (détecté automatiquement à partir du profil s’il est vide).

--port string

    Port SSH de passerelle bac à sable. Valeur par défaut : 2222.

Indicateurs globaux

Exemples

databricks sandbox ssh
databricks sandbox ssh my-sandbox-1234
databricks sandbox ssh -- ls -la /home
databricks sandbox ssh my-sandbox-1234 -- cat /etc/os-release
databricks sandbox ssh -- -L 8080:localhost:8080

Databricks Sandbox SSH-Key

Gérez les clés SSH inscrites auprès du service de bac à sable.

databricks sandbox ssh-key [command]

Commandes disponibles

Options

Indicateurs globaux

Liste des clés ssh de Databricks Sandbox

Répertoriez les clés SSH inscrites auprès du service de bac à sable.

Chaque ligne affiche le hachage de clé affectée par le serveur (utilisé pour supprimer la clé), le nom fourni par l’utilisateur et créer et utiliser des horodatages de dernière utilisation. La clé inscrite localement (de databricks sandbox register) est marquée lorsque son hachage correspond à l’une des entrées répertoriées.

databricks sandbox ssh-key list [flags]

Options

--json

    Retourne les résultats au format JSON.

Indicateurs globaux

Exemples

databricks sandbox ssh-key list
databricks sandbox ssh-key list --json

Databricks Boîte à sable Suppression de la clé SSH

Supprimez une clé SSH inscrite auprès du service sandbox.

Le hachage de clé est l’identificateur retourné par databricks sandbox ssh-key list. Après la suppression, les tentatives SSH qui utilisent la clé privée correspondante ne réussissent pas tant que vous n’avez pas réinscrire la clé.

databricks sandbox ssh-key delete <key-hash> [flags]

Arguments

<key-hash>

    Hachage de clé à supprimer.

Options

Indicateurs globaux

Exemple

databricks sandbox ssh-key delete a1b2c3d4e5f6...

démarrage du bac à sable databricks

Activez un environnement de bac à sable arrêté.

Démarre la microVM de stockage et bloque jusqu’à ce que le bac à sable atteigne l’exécution (ou jusqu’à 10 minutes). L’exécution de cette commande sur un bac à sable en cours d’exécution est un no-op.

databricks sandbox start <sandbox-id> [flags]

Arguments

<sandbox-id>

    ID de bac à sable à activer.

Options

Indicateurs globaux

Exemple

databricks sandbox start my-sandbox-1234

état du bac à sable databricks

Afficher l’état détaillé d’un environnement de bac à sable.

databricks sandbox status <sandbox-id> [flags]

Arguments

<sandbox-id>

    ID de bac à sable à inspecter.

Options

--json

    Retourne les résultats au format JSON.

Indicateurs globaux

Exemples

databricks sandbox status my-sandbox-1234
databricks sandbox status my-sandbox-1234 --json

Databricks arrêt bac à sable

Arrêtez un environnement de bac à sable en cours d’exécution.

Met fin à la microVM de stockage, mais conserve l’enregistrement de bac à sable et son stockage persistant. L’arrêt d’un bac à sable déjà arrêté est une no-op.

databricks sandbox stop <sandbox-id> [flags]

Arguments

<sandbox-id>

    ID de bac à sable à arrêter.

Options

Indicateurs globaux

Exemple

databricks sandbox stop my-sandbox-1234

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 dans lequel écrire les logs de sortie. Si cet indicateur n’est pas spécifié, la valeur par défaut consiste à écrire les logs de sortie 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 format du journal. 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