Databricks 命令行介面

注意

此資訊適用於 Databricks CLI 0.205 版和更新版本。 Databricks CLI 處於 公開預覽狀態。

Databricks CLI 使用受限於 Databricks 授權 和 Databricks 隱私權通知，包括任何使用量數據規定。

Databricks CLI（命令列介面）允許您從本地終端機或自動化腳本與Azure Databricks平台互動。 您也可以使用 Web 終端機，從 Databricks 工作區內執行 Databricks CLI 命令。 請參見 Azure Databricks 網頁終端機中執行 shell 命令 。

若要安裝和設定 Databricks CLI 的認證，請參閱 安裝或更新 Databricks CLI 和 Databricks CLI 認證。

提示

Databricks CLI 原始碼公開於 databricks/cli GitHub 倉庫。

Databricks CLI 舊用戶資訊

  • Databricks 計劃不再支援或為舊版 Databricks CLI 開發新功能。
  • 如需舊版 Databricks CLI 的詳細資訊，請參閱 舊版 Databricks CLI。
  • 若要從 Databricks CLI 0.18 版或更低版本移轉至 Databricks CLI 0.205 版或更新版本，請參閱 Databricks CLI 移轉。

Databricks CLI 如何運作？

CLI 包裝了 Databricks REST API，該 API 提供端點以修改或請求 Azure Databricks 帳號與工作區物件的資訊。 請參考 Azure Databricks REST API 參考。

例如，若要列印工作區中個別叢集的相關信息，請執行 CLI，如下所示：

databricks clusters get 1234-567890-a12bcde3

使用 curl時，對等作業如下所示：

curl --request GET "https://${DATABRICKS_HOST}/api/2.0/clusters/get" \
     --header "Authorization: Bearer ${DATABRICKS_TOKEN}" \
     --data '{ "cluster_id": "1234-567890-a12bcde3" }'

範例：建立 Azure Databricks 工作

以下範例使用 CLI 建立 Azure Databricks 工作。 此作業包含單一作業工作。 此任務執行指定的 Azure Databricks 筆記本。 此筆記本相依於名為 wheel的特定 PyPI 套件版本。 若要執行這項工作，作業會暫時建立作業叢集，以匯出名為的 PYSPARK_PYTHON環境變數。 作業執行之後，叢集就會終止。

databricks jobs create --json '{
  "name": "My hello notebook job",
  "tasks": [
    {
      "task_key": "my_hello_notebook_task",
      "notebook_task": {
        "notebook_path": "/Workspace/Users/someone@example.com/hello",
        "source": "WORKSPACE"
      },
      "libraries": [
        {
          "pypi": {
            "package": "wheel==0.41.2"
          }
        }
      ],
      "new_cluster": {
        "spark_version": "13.3.x-scala2.12",
        "node_type_id": "Standard_DS3_v2",
        "num_workers": 1,
        "spark_env_vars": {
          "PYSPARK_PYTHON": "/databricks/python3/bin/python3"
        }
      }
    }
  ]
}'

下一步

  • 若要安裝 CLI 並設定驗證以快速開始使用，請參閱 Databricks CLI 教學課程。
  • 若要略過教學課程並直接安裝 CLI，請參閱 安裝或更新 Databricks CLI。
  • 欲了解 CLI 與您的 Azure Databricks 帳戶及工作空間之間所有可用的認證類型，請參閱 Databricks CLI 的 Authentication 條目。
  • 若要使用組態配置檔在相關 CLI 設定群組之間快速切換，請參閱 Databricks CLI 的組態配置檔。
  • 若要瞭解 CLI 的基本用法，請參閱 Databricks CLI 的基本使用量。
  • 如需所有可用 CLI 命令的清單，請參閱 Databricks CLI 命令。
  • Last updated on