sync
コマンド グループ
この情報は、Databricks CLI バージョン 0.205 以降に適用されます。 Databricks CLI は パブリック プレビュー段階です。
Databricks CLI 使用には、 Databricks ライセンス および Databricks プライバシー通知(使用データのプロビジョニングを含む)が適用されます。
Databricks CLI 内の sync
コマンド グループを使用すると、ローカル ファイルシステム ディレクトリ内のファイル変更をリモート Databricks ワークスペース内のディレクトリに一方向に同期できます。
sync
コマンドを実行するには、コマンドを databricks sync
に追加します。sync
コマンドのヘルプを表示するには、databricks sync -h
を実行します。
ローカルファイルの変更をリモートディレクトリに段階的に同期します
ローカル ファイルシステム ディレクトリ内のファイル変更をリモート Databricks ワークスペース内のディレクトリに 1 つの増分一方向同期を実行するには、次のように sync
コマンドを実行します。
databricks sync <local-directory-path> <remote-directory-path>
たとえば、ローカルの現在の作業ディレクトリ内の my-folder
という名前のフォルダ内のすべてのファイル変更を、リモート ワークスペース内の特定のパスに 1 回だけ一方向で増分同期するには、次のコマンドを実行します。
databricks sync ./my-folder/ /Users/someone@example.com/
この例では、 sync
コマンドを最後に実行してからの変更のみが /Users/someone@example.com/
に同期されます。 デフォルトでは、呼び出し元の DEFAULT
プロファイル内のワークスペース URL を使用して、同期先のリモート ワークスペースが決定されます。
ローカルファイルの変更をリモートディレクトリに完全に同期する
ローカル ファイル システム ディレクトリ内のファイル変更をリモート Databricks ワークスペース内のディレクトリに 1 回の完全な一方向同期を実行するには、最後の [ sync
コマンドがいつ実行されたかに関係なく、次のように --full
オプションを使用します。
databricks sync ./my-folder/ /Users/someone@example.com/ --full
ローカルファイルの変更をリモートディレクトリに継続的に同期
ローカル ファイルシステム ディレクトリ内のファイル変更とリモート Databricks ワークスペース内のディレクトリへの継続的な一方向の同期を有効にするには、次のように --watch
オプションを使用します。
databricks sync ./my-folder/ /Users/someone@example.com/ --watch
一方向同期は、コマンドが端末から停止するまで (通常は Ctrl + c
または Ctrl + z
を押すことによって) 続行されます。
同期イベントのポーリングは、デフォルトで 1 秒に 1 回行われます。 この間隔を変更するには、 --interval
オプションを使用し、ポーリングする秒数の後に文字 s
(たとえば 5 秒間) を付けます。
databricks sync ./my-folder/ /Users/someone@example.com/ --watch --interval 5s
同期の進行状況の出力形式を変更する
同期の進行状況情報は、デフォルトではテキスト形式で端末に出力されます。 同期進行状況の出力形式を指定するには、 --output
オプションを使用して、 text
(特に指定されていない場合 --output
デフォルト) または json
を指定します。たとえば、次の例です。
databricks sync ./my-folder/ /Users/someone@example.com/ --output json