在 Azure Databricks 網頁終端中執行 Shell 命令

Azure Databricks Web 終端機提供方便且高度互動的方式，可在命令行介面（CLI）中執行殼層命令，包括 Databricks CLI 命令，以程式設計方式對 Databricks 對象採取動作。 這對於進階使用案例特別有用，例如多個檔案上的批次作業，而現有使用者介面 （UI） 可能無法完全支援這些檔案。

多個用戶可以在一個計算上使用 Web 終端機。

網頁終端機支援經典運算、無伺服器 CPU 運算及無伺服器 GPU 運算（AI Runtime）。 支援無伺服器 GPU 運算（AI 執行時）目前已 進入公開預覽階段。

您可以使用 Web 終端機來執行下列動作：

  • 使用 Vim 或 Emacs 快速編輯檔案。
  • 使用 （叢集使用量） 或 htop （GPU 使用量） 等nvidia-smi命令監視資源使用量。
  • 執行非 Spark Python 腳本。
  • 使用諸如 mv 和 mkdir 之類的 shell 指令來執行文件操作。
  • 在計算環境中安裝和管理程式庫。
  • 使用 Databricks CLI 將 Azure Databricks 的各個層面自動化。

需求

警告

Azure Databricks 會從計算 Spark 驅動程式上的埠 7681 代理 Web 終端機服務。 此 Web Proxy 僅適用於 Web 終端機。 如果當運算程序啟動或發生某種衝突時埠被佔用，網路終端機可能無法如預期運作。 如果埠 7681 上啟動其他 Web 服務，計算使用者可能會暴露在潛在的安全性惡意探索中。 Databricks 和 Microsoft 都不負責計算上安裝不支持軟體所造成的任何問題。

  • 預設會停用所有工作區使用者的 Web 終端機。 若要啟用它，請參閱 啟用 Web 終端機。
  • 可以附加至 計算資源的許可權。
  • 若要搭配標準存取模式使用 Web 終端機 （先前的共用存取模式），計算必須位於 Databricks Runtime 15.1 或更新版本上。
  • 無伺服器 GPU 運算（AI 執行時）上的網頁終端機需要環境版本 5 或以上。

啟動 Web 終端機

您可以從計算詳細數據頁面或筆記本啟動 Web 終端機。

從筆記本

若要從筆記本啟動 Web 終端機：

  1. 將筆記本連接到計算機。
  2. 在筆記本右側邊欄底部，按一下終端機圖示 終端機圖示。 以啟動 Web 終端機。
  3. 或者，按一下所附計算資源的下拉選單，將滑鼠移至所附計算資源上方，然後按一下 Web 終端機。

網路終端機會在畫面底部的面板中開啟。 面板右上角的按鈕可讓您：

  • 新視窗圖示。 在新索引標籤中開啟新的終端機工作階段。
  • 同步圖示。 重新載入終端機工作階段。
  • 關閉圖示。 關閉底部面板。 若要重新開啟面板，請按一下右側邊欄底部的終端機圖示。

從計算詳細數據頁面

若要從計算詳細數據頁面啟動 Web 終端機：

  1. 在工作區的側邊欄中，按一下 計算。
  2. 在 所有用途計算 索引標籤上，按一下計算名稱。
  3. 按兩下 [ 開始] 以啟動計算。
  4. 在 [ 應用程式] 索引標籤上，按兩下 [Web 終端機]。

新的分頁開啟，其中包含網頁終端機介面和 Bash 命令提示符。

使用 Web 終端機

在 Web 終端機中，您可以從計算驅動程式節點容器內的根目錄執行命令。

每位使用者最多可開啟 100 個活躍的網頁終端分頁會話。 閒置的 Web 終端機會話可能會逾時，Web 終端機應用程式將會重新連線，進而產生新的 shell 進程。 如果您想要保留 Bash 會話，Databricks 建議使用 tmux。

執行 Databricks CLI 命令

您也可以使用 Web 終端機來執行 Databricks CLI 命令。 可用的 CLI 一律為最新版本，而驗證是以目前的用戶為基礎。

備註

在 Web 終端機中執行 CLI 命令時，不支援組態設定檔命令。 這是因為 Web 終端機使用環境變數對 CLI 進行認證，而這些環境變數在 認證的評估順序 中優先於配置檔。

計算必須符合下列需求：

  • Databricks Runtime 15.0 或更新版本
  • 不得啟用 Private Link 的工作區

啟動 Web 終端機並執行下列命令，以輸出目前使用者的相關信息：

   databricks current-user me

Databricks 工作空間的網頁終端機提供 Bundle 指令，讓您能直接在此建立和管理宣告式自動化套件。 例如，若要使用預設範本建立、部署及執行簡單的套件組合：

  1. 從 Web 終端機根目錄，瀏覽至工作區首頁並執行 bundle init：

    cd /Workspace/Users/someone@example.com
databricks bundle init

  2. 接受預設範本提示，然後變更為套件組合目錄並加以部署：

    cd my_project
databricks bundle deploy

    您可以在 Databricks 工作區 UI 中檢視已部署的 my_project 套件組合。

  3. 最後，在套件組合中執行預設作業：

    databricks bundle run my_project_job

    瀏覽至 [作業執行 ] 以查看執行中的作業。

設定 Web 終端機

您可以使用 .bashrc 組態檔來設定 Web 終端機的持續性組態。

Databricks 會自動從工作區文件系統的主目錄載入名為 .bashrc 的檔案。 每次您啟動新的終端機會話時，會自動啟動這些檔案中的設定。

如果您想要為 Web 終端機體驗提供任何其他檔案（例如 .zshrc），請從 .bashrc 檔案加以來源以保存設定。

將所有組態檔儲存在工作區資料夾中，您可以在其中使用文字編輯器進行設定。

限制

  • Azure Databricks 不支援從 Web 終端機執行 Spark 作業。
  • Azure Databricks 網頁終端無法提供以下運算類型：
    • 任務計算
    • 計算在設置了 DISABLE_WEB_TERMINAL=true 環境變數後啟動。
    • 15.1 以下 Databricks Runtime 版本上的標準計算。
    • 在 Databricks Runtime 上具有低於 16.4 的 ARM 實例類型的標準計算。
    • 使用第 1 版無伺服器環境的無伺服器運算。
    • 使用 Spark 組態啟動的運算 spark.databricks.pyspark.enableProcessIsolation 設定為 true。
  • 在無伺服器 GPU 運算（AI 執行時）中，網頁終端僅在支援無伺服器 GPU 運算的區域提供：westus、 eastus、 eastus2centralusnorthcentralus和 。
  • 自初次載入頁面後，嚴格的限制為 12 小時，之後即使仍在使用中，任何連接都會被終止。 您可以重新載入網頁終端機以重新連線。 Databricks 建議使用 tmux 來保留終端會話。
  • 低於 16.4 的 Databricks Runtime 上的 ARM 計算資源無法使用 Web 終端機來存取工作區檔案，包括 Git 資料夾中的檔案。
  • 啟用 Docker Container Services 會停用 Web 終端機。
  • Last updated on