Freigeben über

Arbeitsbereichs-CLI (Legacy)

  • Artikel

Wichtig

Diese Dokumentation wurde eingestellt und wird unter Umständen nicht aktualisiert.

Diese Informationen gelten für ältere Versionen der Databricks-Befehlszeilenschnittstelle (0.18 und niedriger). Databricks empfiehlt, stattdessen die neuere Databricks-CLI Version 0.205 oder höher zu verwenden. Weitere Informationen finden Sie unter Was ist die Databricks-CLI?. Führen Sie databricks -v aus, um die Version Ihrer Databricks CLI zu ermitteln.

Informationen zum Migrieren der Databricks CLI-Version 0.18 oder niedriger zur Databricks CLI-Version 0.205 oder höher finden Sie unter Databricks CLI-Migration.

Sie führen CLI-Unterbefehle für den Databricks-Arbeitsbereich aus, indem Sie sie an databricks workspace anfügen. Diese Unterbefehle rufen die Arbeitsbereichs-API auf.

databricks workspace -h

Usage: databricks workspace [OPTIONS] COMMAND [ARGS]...

  Utility to interact with the Databricks workspace. Workspace paths must be
  absolute and be prefixed with `/`.

Common Options:
  -v, --version  [VERSION]
  -h, --help     Show this message and exit.

Commands:
  delete      Deletes objects from the Databricks workspace. rm and delete are synonyms.
    Options:
        -r, --recursive
  export      Exports a file from the Databricks workspace.
    Options:
      -f, --format FORMAT      SOURCE, HTML, JUPYTER, or DBC. Set to SOURCE by default.
      -o, --overwrite          Overwrites file with the same name as a workspace file.
  export_dir  Recursively exports a directory from the Databricks workspace.
    Options:
      -o, --overwrite          Overwrites local files with the same names as workspace files.
  import      Imports a file from local to the Databricks workspace.
    Options:
      -l, --language LANGUAGE  SCALA, PYTHON, SQL, R  [required]
      -f, --format FORMAT      SOURCE, HTML, JUPYTER, or DBC. Set to SOURCE by default.
      -o, --overwrite          Overwrites workspace files with the same names as local files.
  import_dir  Recursively imports a directory to the Databricks workspace.

    Only directories and files with the extensions .scala, .py, .sql, .r, .R,
    .ipynb are imported. When imported, these extensions are stripped off
    the name of the notebook.

    Options:
      -o, --overwrite          Overwrites workspace files with the same names as local files.
      -e, --exclude-hidden-files
  list        Lists objects in the Databricks workspace. ls and list are synonyms.
    Options:
      --absolute               Displays absolute paths.
      -l                       Displays full information including ObjectType, Path, Language
  ls          Lists objects in the Databricks workspace. ls and list are synonyms.
    Options:
      --absolute               Displays absolute paths.
      -l                       Displays full information including ObjectType, Path, Language
  mkdirs      Makes directories in the Databricks workspace.
  rm          Deletes objects from the Databricks workspace. rm and delete are synonyms.
    Options:
        -r, --recursive

Löschen eines Objekts aus einem Arbeitsbereich

Führen Sie databricks workspace delete --help oder databricks workspace rm --help aus, um die Syntaxdokumentation anzuzeigen.

databricks workspace delete --recursive "/Users/someone@example.com/My Folder"

Oder:

databricks workspace rm --recursive "/Users/someone@example.com/My Folder"

Bei Erfolg wird keine Ausgabe angezeigt.

Exportieren einer Datei aus einem Arbeitsbereich in Ihr lokales Dateisystem

Führen Sie databricks workspace export --help aus, um die Syntaxdokumentation anzuzeigen.

databricks workspace export --overwrite --format JUPYTER "/Users/someone@example.com/My Python Notebook" /Users/me/Downloads

Diese Option kann auch zum Exportieren von Notebooks aus einem Databricks-Git-Ordner verwendet werden:

databricks workspace export "/Repos/someone@example.com/MyRepoNotebook" /Users/me/Downloads

Bei Erfolg wird keine Ausgabe angezeigt.

Exportieren einer Datei aus einem Arbeitsbereich in Ihr lokales Dateisystem

Führen Sie databricks workspace export_dir --help aus, um die Syntaxdokumentation anzuzeigen.

databricks workspace export_dir --overwrite /Users/someone@example.com/my-folder /Users/me/Downloads/my-folder

/Users/someone@example.com/my-folder/My Python Notebook -> /Users/me/Downloads/my-folder/My Python Notebook.py
/Users/someone@example.com/my-folder/My Scala Notebook -> /Users/me/Downloads/my-folder/My Scala Notebook.scala
/Users/someone@example.com/my-folder/My R Notebook -> /Users/me/Downloads/my-folder/My R Notebook.r
/Users/someone@example.com/my-folder/My SQL Notebook -> /Users/me/Downloads/my-folder/My SQL Notebook.sql

Importieren einer Datei aus Ihrem lokalen Dateisystem in einen Arbeitsbereich

Führen Sie databricks workspace import --help aus, um die Syntaxdokumentation anzuzeigen.

Nur Dateien mit den Erweiterungen .scala, .py, .sql, .r, .R können importiert werden. Beim Importieren werden diese Erweiterungen aus dem Notebooknamen entfernt.

databricks workspace import ./a.py /Users/someone@example.com/example

./a.py -> /Users/someone@example.com/example/a

Importieren eines Verzeichnisses aus Ihrem lokalen Dateisystem in einen Arbeitsbereich

Führen Sie databricks workspace import_dir --help aus, um die Syntaxdokumentation anzuzeigen.

Dieser Befehl importiert rekursiv ein Verzeichnis aus dem lokalen Dateisystem in den Arbeitsbereich. Nur Verzeichnisse und Dateien mit den Erweiterungen .scala, .py, .sql, .r, .R werden importiert. Beim Importieren werden diese Erweiterungen aus dem Notebooknamen entfernt.

Um vorhandene Notebooks am Zielpfad zu überschreiben, fügen Sie das Flag --overwrite oder -o hinzu.

tree

.
├── a.py
├── b.scala
├── c.sql
├── d.R
└── e

databricks workspace import_dir . /Users/someone@example.com/example

./a.py -> /Users/someone@example.com/example/a
./b.scala -> /Users/someone@example.com/example/b
./c.sql -> /Users/someone@example.com/example/c
./d.R -> /Users/someone@example.com/example/d

databricks workspace ls /Users/someone@example.com/example -l

NOTEBOOK   a  PYTHON
NOTEBOOK   b  SCALA
NOTEBOOK   c  SQL
NOTEBOOK   d  R
DIRECTORY  e

Auflisten von Objekten in einem Arbeitsbereich

Führen Sie databricks workspace list --help oder databricks workspace ls --help aus, um die Syntaxdokumentation anzuzeigen.

databricks workspace list --absolute --long --id /Users/someone@example.com

Oder:

databricks workspace ls --absolute --long --id /Users/someone@example.com

NOTEBOOK           /Users/someone@example.com/My Python Notebook  PYTHON  1234567898012345
NOTEBOOK           /Users/someone@example.com/My Scala Notebook   SCALA   2345678980123456
NOTEBOOK           /Users/someone@example.com/My R Notebook       R       3456789801234567
DIRECTORY          /Users/someone@example.com/My Directory                4567898012345678
MLFLOW_EXPERIMENT  /Users/someone@example.com/My_Experiment               5678980123456789

Erstellen eines Verzeichnisses in einem Arbeitsbereich

Führen Sie databricks workspace mkdirs --help aus, um die Syntaxdokumentation anzuzeigen.

databricks workspace mkdirs "/Users/someone@example.com/My New Folder"

Bei Erfolg wird keine Ausgabe angezeigt.