Partager via


Interface CLI DBFS (héritée)

Important

Cette documentation a été mise hors service et peut ne pas être mise à jour.

Ces informations s’appliquent aux anciennes versions Databricks CLI 0,18 et inférieures. Databricks vous recommande d’utiliser à la place la nouvelle version 0.205 ou supérieure de l’interface CLI Databricks. Consultez Qu’est-ce que l’interface CLI Databricks ?. Pour trouver votre version de l’interface CLI Databricks, exécutez databricks -v.

Pour migrer de Databricks CLI version 0,18 ou inférieure vers Databricks CLI version 0,205 ou supérieure, consultez Migration Databricks CLI.

Vous exécutez les sous-commandes CLI Databricks DBFS en les ajoutant à databricks fs (ou à l’alias dbfs), en préfixant tous les chemins DBFS avec dbfs:/. Ces sous-commandes appellent l’API DBFS.

databricks fs -h
Usage: databricks fs [OPTIONS] COMMAND [ARGS]...

  Utility to interact with DBFS. DBFS paths are all prefixed
  with dbfs:/. Local paths can be absolute or local.

Options:
  -v, --version
  -h, --help     Show this message and exit.

Commands:
  cat        Shows the contents of a file. Does not work for directories.
  configure
  cp         Copies files to and from DBFS.
    Options:
      -r, --recursive
      --overwrite     Overwrites files that exist already.
  ls         Lists files in DBFS.
    Options:
      --absolute      Displays absolute paths.
      -l              Displays full information including size and file type.
  mkdirs     Makes directories in DBFS.
  mv         Moves a file between two DBFS paths.
  rm         Removes files from DBFS.
    Options:
      -r, --recursive

Pour les opérations qui listent, déplacent ou suppriment plus de 10 000 fichiers, nous vous déconseillons fortement d’utiliser l’interface CLI DBFS.

  • L’opération list (databricks fs ls) expire après environ 60 secondes.
  • L’opération move (databricks fs mv) expire après environ 60 secondes, ce qui peut entraîner un déplacement partiel des données.
  • L’opération delete (databricks fs rm) supprime de façon incrémentielle les lots de fichiers.

Nous vous recommandons d’effectuer ces opérations dans le contexte d’un cluster, à l’aide de l’utilitaire de système de fichiers (dbutils.fs). dbutils.fs couvre l’étendue fonctionnelle de l’API REST DBFS, mais à partir de notebooks. L’exécution de ces opérations à l’aide de notebooks offre un meilleur contrôle, comme des suppressions sélectives, la facilité de gestion et la possibilité d’automatiser les travaux périodiques.

Limites

L’utilisation de l’interface CLI DBFS Databricks avec des conteneurs de stockage avec pare-feu n’est pas prise en charge. Databricks vous recommande d’utiliser Databricks Connect ou az storage.

Lister le contenu d’un fichier

Pour afficher la documentation d’utilisation, exécutez databricks fs cat --help.

databricks fs cat dbfs:/tmp/my-file.txt
Apache Spark is awesome!

Copier un fichier

Pour afficher la documentation d’utilisation, exécutez databricks fs cp --help.

databricks fs cp dbfs:/tmp/your_file.txt dbfs:/parent/child/grandchild/my_file.txt --overwrite

En cas de réussite, cette commande n’affiche rien.

Lister les informations sur les fichiers et les répertoires

Pour afficher la documentation d’utilisation, exécutez databricks fs ls --help.

databricks fs ls dbfs:/tmp --absolute -l
file  42408084  dbfs:/tmp/LoanStats.csv    1590005159000
file        40  dbfs:/tmp/file_b.txt       1603991038000
dir          0  dbfs:/tmp/hive                         0
dir          0  dbfs:/tmp/mlflow                       0
file       385  dbfs:/tmp/multi-line.json  1597770632000
dir          0  dbfs:/tmp/new                          0
dir          0  dbfs:/tmp/parent                       0
file       243  dbfs:/tmp/test.json        1597770628000
file        40  dbfs:/tmp/test_dbfs.txt    1603989162000

Créer un répertoire

Pour afficher la documentation d’utilisation, exécutez databricks fs mkdirs --help.

databricks fs mkdirs dbfs:/tmp/new-dir

En cas de réussite, cette commande n’affiche rien.

Déplacer un fichier

Pour afficher la documentation d’utilisation, exécutez databricks fs mv --help.

databricks fs mv dbfs:/tmp/my-file.txt dbfs:/parent/child/grandchild/my-file.txt

En cas de réussite, cette commande n’affiche rien.

Supprimer un fichier

Pour afficher la documentation d’utilisation, exécutez databricks fs rm --help.

databricks fs rm dbfs:/tmp/parent/child/grandchild/my-file.txt
Delete finished successfully.