Note
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI の使用には、Databricks ライセンスおよび使用状況データのプロビジョニングを含むDatabricks のプライバシーに関する通知が適用されます。
Databricks CLI 内の fs
コマンド グループを使用すると、Unity カタログおよび Databricks File System (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
という名前のディレクトリとその内容をローカル ファイルシステム パスから、指定されたボリュームのルートまたは DBFS ルート内の squirrels
ディレクトリにコピーします。
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
サイズ、ファイルの種類、エポック以降の変更時間などの完全な情報をミリ秒単位で表示します。
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
次の例では、指定されたボリュームのルートまたは DBFS ルート内の tmp
ディレクトリにある、オブジェクトの完全な情報とオブジェクトの完全なパスの一覧を示します。
databricks fs ls dbfs:/Volumes/main/default/my-volume -l --absolute
databricks fs ls dbfs:/tmp -l --absolute
databricks fs mkdir(Databricks環境でディレクトリを作成するコマンド)
ディレクトリを作成します。 ボリュームまたは DBFS で作成されるディレクトリへのパスを指定します。 ディレクトリが既に存在する場合は、何も起こりません。
databricks fs mkdir DIR_PATH [flags]
Arguments
DIR_PATH
作成するディレクトリ パス
オプション
Examples
次の例では、指定したボリュームのルート内または DBFS ルート内の squirrel-data
という名前のディレクトリに、tmp
という名前のディレクトリを作成します。
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
次の例では、指定したボリュームのルートまたは DBFS ルートのsquirrel-data
ディレクトリから、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
、 append
、 inplace
、または json
-t, --target
文字列
該当する場合は、使用するバンドル ターゲット