Note
此資訊適用於 Databricks CLI 版本 0.205 及以上。 Databricks CLI 處於 公開預覽狀態。
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明,包括任何使用數據條款。
fs
Databricks CLI 內的命令群組可讓您在 Unity 目錄和 Databricks 檔案系統 (DBFS) 中的磁碟區上執行文件系統作業。
fs 命令需要磁碟區路徑以 dbfs:/Volumes 開頭,且需要 DBFS 中的目錄和檔案路徑以 dbfs:/ 開頭。
若要在目錄中的 /Workspace 工作區檔案上執行作業,請使用 databricks workspace 命令。 請參閱 workspace 命令群組。
Important
不支援使用 Databricks CLI 及 REST API 搭配啟用防火牆的儲存容器。 Databricks 建議您使用 Databricks Connect 或 az storage。
Databricks FS CAT
輸出檔案的內容。 指定 DBFS 中檔案的路徑。
databricks fs cat FILE_PATH [flags]
Arguments
FILE_PATH
要輸出的檔案
選項
Examples
下列範例會輸出在指定磁碟區根目錄或在 DBFS 根目錄中的 babynames.csv 目錄內找到的名為 tmp 的檔案內容:
databricks fs cat dbfs:/Volumes/main/default/my-volume/babynames.csv
databricks fs cat dbfs:/tmp/babynames.csv
下列範例會傳回錯誤,因為它們會嘗試輸出目錄的內容,而不是檔案:
databricks fs cat dbfs:/Volumes/main/default/my-volume
databricks fs cat dbfs:/tmp
Databricks FS CP
複製目錄或檔案。 指定要複製的來源目錄或檔案的路徑及其目的地。 您可以在本機文件系統和 DBFS 之間複製目錄和檔案,而且可以在 DBFS 路徑之間複製目錄和檔案。
cp 命令會假設file:/,如果省略file:/。
databricks fs cp SOURCE_PATH TARGET_PATH [flags]
Arguments
SOURCE_PATH
來源目錄或檔案路徑
TARGET_PATH
目標目錄或檔案路徑
選項
--overwrite
覆寫現有的檔案
-r, --recursive
以遞歸方式複製目錄中的檔案
Examples
下列範例會將名為 squirrel-data 的目錄及其內容從本機檔系統路徑 squirrels 複製到指定磁碟區根目錄或 DBFS 根目錄內的目錄。
databricks fs cp /Users/<username>/squirrel-data dbfs:/Volumes/main/default/my-volume/squirrels -r
databricks fs cp /Users/<username>/squirrel-data dbfs:/squirrels -r
下列範例會將名為 squirrels.csv 的檔案從本機檔系統路徑複製到指定磁碟區根目錄或 DBFS 根目錄內名為 squirrel-data 的目錄。 如果檔案已存在於目的地中,則會覆寫它。
databricks fs cp /Users/<username>/squirrels.csv dbfs:/Volumes/main/default/my-volume/squirrel-data --overwrite
databricks fs cp /Users/<username>/squirrels.csv dbfs:/squirrel-data --overwrite
Databricks FS LS
列出磁碟區或 DBFS 中指定目錄的內容。
databricks fs ls DIR_PATH [flags]
Arguments
DIR_PATH
目錄路徑
選項
--absolute
顯示絕對路徑。
--long, -l
顯示包含大小、文件類型和自Epoch(時代)以毫秒計的修改時間在內的完整資訊。
Examples
下列範例會列出指定磁碟區根目錄或 DBFS 根目錄中找到的物件名稱:
databricks fs ls dbfs:/Volumes/main/default/my-volume
databricks fs ls dbfs:/
下列範例會列出在指定磁碟區的根目錄或在 DBFS 的 tmp 根目錄中找到之物件的完整資訊:
databricks fs ls dbfs:/Volumes/main/default/my-volume -l
databricks fs ls dbfs:/tmp -l
下列範例會列出物件的完整資訊,以及物件的完整路徑,位於指定磁碟區的根目錄或 tmp DBFS 根目錄中:
databricks fs ls dbfs:/Volumes/main/default/my-volume -l --absolute
databricks fs ls dbfs:/tmp -l --absolute
Databricks FS MKDIR
建立目錄。 指定要在磁碟區或 DBFS 中建立之目錄的路徑。 如果目錄已經存在,則不會發生任何動作。
databricks fs mkdir DIR_PATH [flags]
Arguments
DIR_PATH
要建立的目錄路徑
選項
Examples
下列範例會在指定的磁碟區根目錄或 DBFS 根目錄內建立名為 squirrel-datatmp 的目錄:
databricks fs mkdir dbfs:/Volumes/main/default/my-volume/squirrel-data
databricks fs mkdir dbfs:/tmp/squirrel-data
databricks fs rm 命令
刪除目錄。 指定 DBFS 中現有目錄的路徑。
如果目錄存在但不是空的,則會傳回錯誤。 如果目錄不存在,則不會發生任何動作。
databricks fs rm PATH [flags]
Arguments
PATH
DBFS 中現有目錄的路徑
選項
-r, --recursive
拿掉所有內容
Examples
下列範例會從指定磁碟區的根目錄或 squirrel-data DBFS 根目錄中移除名為 tmp 的目錄:
databricks fs rm dbfs:/Volumes/main/default/my-volume/squirrel-data
databricks fs rm dbfs:/tmp/squirrel-data
下列範例會從指定磁碟區的根目錄或 squirrel-data DBFS 根目錄中,移除名為 tmp 的非空白目錄:
databricks fs rm dbfs:/Volumes/main/default/my-volume/squirrel-data -r
databricks fs rm dbfs:/tmp/squirrel-data -r
全域旗標
--debug
是否要啟用偵錯記錄。
-h 或 --help
顯示 Databricks CLI、相關命令群組或相關命令的幫助說明。
--log-file 字串
字串,表示要寫入輸出記錄檔的檔案。 若未指定此旗標,則預設值是將輸出記錄寫入 stderr。
--log-format 格式
記錄格式類型,text 或 json。 預設值是 text。
--log-level 字串
表示日誌格式層級的字串。 若未指定,則日誌的格式層級功能將被停用。
-o, --output 類型
指令輸出類型,text 或 json。 預設值是 text。
-p, --profile 字串
用於執行命令的~/.databrickscfg檔案中的配置檔名稱。 如果未指定此旗標,則如果存在,則會使用名為 DEFAULT 的配置檔。
--progress-format 格式
顯示進度記錄的格式:default、、appendinplace、 或json
-t, --target 字串
如果適用,要使用的套件組合目標