注意
Databricks CLI 的使用受限於 Databricks 授權 和 Databricks 隱私權聲明，包括任何使用數據條款。
sandbox
Databricks CLI 中的指令群組協助你建立、設定及存取 Databricks 沙盒環境。
這很重要
Databricks 沙盒目前處於 測試階段。
Databricks 沙盒環境是支援 SSH 存取的開發環境，並由 microVM 隔離支援。 每個沙盒都是個人環境，內建工具（Python、Node.js、Rust 和 Databricks CLI）和持久儲存。
開始之前：
databricks auth login --host https://...
databricks sandbox register
databricks sandbox create
databricks sandbox ssh
Databricks 沙盒設定
設定沙盒名稱和自動停止政策。
--name、 --idle-timeout和 --no-autostop 設定是獨立的，你可以選擇任何組合。
databricks sandbox config <sandbox-id> [flags]
Arguments
<sandbox-id>
沙盒的 ID 要設定。
選項
--name string
沙盒標籤（最大 256 位元組）。 傳 --name= 球清場。
--idle-timeout string
閒置暫停時間。 將此值設為 0 （或 0s） 以清除，並使用 manager 預設值 （10m）。 有效範圍： 1m 到 24h。
--no-autostop
當情況成立時，這個沙盒從不會在閒置時自動停止。 通過 --no-autostop=false 以恢復。
Examples
databricks sandbox config my-sandbox-1234 --name my-project
databricks sandbox config my-sandbox-1234 --idle-timeout 15m
databricks sandbox config my-sandbox-1234 --idle-timeout 1h30m
databricks sandbox config my-sandbox-1234 --idle-timeout 0
databricks sandbox config my-sandbox-1234 --no-autostop
databricks sandbox config my-sandbox-1234 --no-autostop=false
databricks sandbox config my-sandbox-1234 --idle-timeout 30m --no-autostop=false
Databricks 沙盒創建
建立一個新的沙盒環境。
建立一個由 microVM 支援的個人開發環境，封鎖直到沙盒運行，並列印沙盒 ID。
databricks sandbox create [flags]
選項
--json
以 JSON 格式回傳結果。
--name string
沙盒標籤（最大 256 位元組）。
Examples
databricks sandbox create
databricks sandbox create --name my-project
databricks sandbox create --json
Databricks 沙盒預設值
設定預設沙盒。databricks sandbox ssh
預設值會儲存在 ~/.databricks/sandbox.json 每個設定檔的本地。 沙盒 ID 會在寫入前先與伺服器進行驗證。
databricks sandbox default <sandbox-id> [flags]
別名： set-default
Arguments
<sandbox-id>
沙盒 ID 設定為預設。
選項
Example
databricks sandbox default my-sandbox-1234
Databricks 沙盒刪除
刪除沙盒環境。
這會永久終止並移除指定的沙盒。 指令提示字串可互動式確認;用 --auto-approve 來跳過提示。
databricks sandbox delete <sandbox-id> [flags]
Arguments
<sandbox-id>
要刪除沙盒 ID。
選項
--auto-approve
跳過互動式確認提示。
Examples
databricks sandbox delete my-sandbox-1234
databricks sandbox delete my-sandbox-1234 --auto-approve
Databricks 沙盒列表
列出你的沙盒環境。
顯示與你帳號相關的所有沙盒，包括它們目前的狀態和識別碼。
databricks sandbox list [flags]
選項
--json
以 JSON 格式回傳結果。
Examples
databricks sandbox list
databricks sandbox list --json
Databricks 沙盒暫存器
產生專用的沙盒 SSH 金鑰並註冊給服務。
此命令：
- 在 （
~/.ssh/sandbox_ed25519如果不存在的話）會產生 Ed25519 SSH 金鑰。 - 將公鑰註冊到沙盒服務，標記為
--name。 - 可選擇性地更新
~/.ssh/config，加入Host sandbox-gw條目。
註冊後，會 databricks sandbox ssh 自動使用此鑰匙。
databricks sandbox register [flags]
選項
--name string
註冊金鑰的標籤（預設為此機主機名稱）。 無需標籤即可通過 --name= 登記。
Examples
databricks sandbox register
databricks sandbox register --name my-laptop
Databricks 沙盒 SSH
SSH 到預設或特定的沙盒環境。 之後 -- 的額外參數會直接傳給 ssh。
databricks sandbox ssh [sandbox-id] [-- <ssh-args-or-command>...] [flags]
Arguments
[sandbox-id]
可選的沙盒識別碼。 如果省略了，則使用你的預設沙盒。
選項
--gateway string
沙盒閘道器主機名稱（若為空，則自動從設定檔偵測）。
--port string
沙盒閘道器的 SSH 埠。 預設值：2222。
Examples
databricks sandbox ssh
databricks sandbox ssh my-sandbox-1234
databricks sandbox ssh -- ls -la /home
databricks sandbox ssh my-sandbox-1234 -- cat /etc/os-release
databricks sandbox ssh -- -L 8080:localhost:8080
Databricks 沙盒 SSH-Key
管理與沙盒服務註冊的 SSH 金鑰。
databricks sandbox ssh-key [command]
可用的命令
-
databricks sandbox ssh-key list- 列出與沙盒服務註冊的 SSH 金鑰。 -
databricks sandbox ssh-key delete- 刪除註冊於沙盒服務的 SSH 金鑰。
選項
Databricks 沙盒 SSH 金鑰列表
列出註冊在沙盒服務的 SSH 金鑰。
每一列顯示伺服器指派的金鑰雜湊值（用於刪除金鑰）、使用者提供的名稱，以及建立與最後使用時間戳記。 當本地註冊的金鑰（來自 databricks sandbox register）的雜湊值與列出的某個條目相符時，就會被標記。
databricks sandbox ssh-key list [flags]
選項
--json
以 JSON 格式回傳結果。
Examples
databricks sandbox ssh-key list
databricks sandbox ssh-key list --json
Databricks 沙盒 ssh-key 刪除
刪除與沙盒服務註冊的 SSH 金鑰。
金鑰雜湊是由 databricks sandbox ssh-key list返回的識別碼。 刪除後，使用對應私鑰的 SSH 嘗試在你再次註冊該金鑰前不會成功。
databricks sandbox ssh-key delete <key-hash> [flags]
Arguments
<key-hash>
要刪除的金鑰雜湊值。
選項
Example
databricks sandbox ssh-key delete a1b2c3d4e5f6...
Databricks 沙盒開始
開啟停止的沙盒環境。
啟動後備的 microVM，並封鎖直到沙盒達到運行狀態（或最多 10 分鐘）。 在已經運行中的沙盒上執行這個指令是 no-op。
databricks sandbox start <sandbox-id> [flags]
Arguments
<sandbox-id>
開啟沙盒 ID。
選項
Example
databricks sandbox start my-sandbox-1234
Databricks 沙盒狀態
顯示沙盒環境的詳細狀態。
databricks sandbox status <sandbox-id> [flags]
Arguments
<sandbox-id>
要檢查沙盒 ID。
選項
--json
以 JSON 格式回傳結果。
Examples
databricks sandbox status my-sandbox-1234
databricks sandbox status my-sandbox-1234 --json
Databricks 沙盒停止
停止運行中的沙盒環境。
終止後備的 microVM，但保留沙盒記錄及其持久儲存。 阻止一個已經停止的沙盒是 no-op。
databricks sandbox stop <sandbox-id> [flags]
Arguments
<sandbox-id>
沙盒ID要停止。
選項
Example
databricks sandbox stop my-sandbox-1234
全域旗標
--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 字串
如果適用，要使用的套件組合目標