Databricks IDE 擴充功能允許你在叢集上執行 Python 程式碼,或是 Python、R、Scala、SQL 程式碼或筆記本,當作 Azure Databricks 的工作。
這些資訊假設你已經安裝並設定好 Databricks IDE 擴充套件。 請參見 安裝 Databricks IDE 擴充功能。
注意
若要從 Visual Studio Code 內對程式代碼或筆記本進行偵錯,請使用 Databricks Connect。 請參閱使用 Databricks Connect 除錯程式碼以取得 Databricks IDE 擴充功能 ,並使用 Databricks IDE 擴充功能執行與除錯筆記本儲存格。
在叢集上執行 Python 檔案
注意
使用無伺服器計算時,無法使用此功能。
要在 Azure Databricks 叢集上使用 Databricks IDE 擴充功能執行 Python 檔案,並且開啟該擴充功能並開啟你的專案:
- 開啟您要在叢集上執行的 Python 檔案。
- 執行下列其中一項動作:
在檔案編輯器的標題欄中,點擊 在 Databricks 上執行 圖示,然後點擊 上傳並執行檔案。
在 [Explorer] 檢視中(View > Explorer),以滑鼠右鍵單擊檔案,然後從操作功能表中選取 [在 Databricks 上執行] [上傳並執行檔案>]。
檔案會在叢集上執行,而且輸出可在 [偵錯主控台] 中查看。
以作業身分執行 Python 檔案
要使用 Databricks IDE 擴充功能,並開啟 Python 檔案作為 Azure Databricks 工作,並開啟該擴充功能與專案:
- 開啟您要以作業身分執行的 Python 檔案。
- 執行下列其中一項動作:
在檔案編輯器的標題欄中,按兩下 [在 Databricks 上執行 ] 圖示,然後按兩下 [ 以工作流程身分執行檔案]。
在檔案總管 檢視中(檢視> 檔案總管),在檔案上點擊右鍵,然後從右鍵選單中選取 在 Databricks 上執行>作為工作流程執行檔案。
新的編輯器索引標籤隨即出現,標題為 Databricks 作業執行。 檔案會在工作區中以作業的形式執行,而且任何輸出都會列印到新編輯器索引標籤的 [ 輸出 ] 區域。
若要檢視作業執行的相關信息,請按兩下 [新增 Databricks 作業執行編輯器] 索引標籤中的 [工作執行標識符] 連結。您的工作區隨即開啟,作業執行的詳細數據會顯示在工作區中。
以作業身分執行 Python、R、Scala 或 SQL 筆記本
要使用 Databricks IDE 擴充功能作為Azure Databricks工作執行筆記本,並且開啟擴充功能和專案:
開啟您要以作業身分執行的筆記本。
提示
若要將 Python、R、Scala 或 SQL 檔案轉換成 Azure Databricks 筆記本,請將批註新增至檔案開頭,並在每個數據格之前新增批注
# Databricks notebook source# COMMAND ----------。 如需詳細資訊,請參閱 將檔案轉換成筆記本。
執行下列其中一項動作:
在筆記本檔案編輯器的標題欄中,按兩下 [在 Databricks 上執行 ] 圖示,然後按兩下 [ 以工作流程身分執行檔案]。
注意
如果無法使用 在 Databricks 上以工作流程方式執行,請參閱 建立自訂執行設定。
在 [Explorer 檢視](View > Explorer)中,以滑鼠右鍵單擊筆記本檔案,然後從操作功能表中選取[在 Databricks 上執行] [>執行檔案為工作流程]。
新的編輯器索引標籤隨即出現,標題為 Databricks 作業執行。 筆記本會在工作區中以作業形式運行。 筆記本及其輸出會顯示在新編輯器索引標籤的 [ 輸出 ] 區域中。
若要檢視作業執行的相關信息,請按兩下 [Databricks 作業執行編輯器] 索引標籤中的 [工作執行標識符] 連結。您的工作區隨即開啟,作業執行的詳細數據會顯示在工作區中。
建立自定義執行組態
Databricks IDE 擴充功能的自訂執行設定允許你將自訂參數傳給工作或筆記本,或為不同檔案建立不同的執行設定。 如需詳細資訊,請參閱 Visual Studio Code 檔中的啟動組態 。
若要建立自定義執行組態,請單擊Visual StudioCode主功能表中的[ 執行 > 新增組態 ]。 然後選擇 Databricks 來設定叢集型執行組態,或者選擇 Databricks:工作流程 來設定作業型執行組態。
例如,下列自訂執行組態會修改 執行檔案為工作流程 的啟動命令,以將 --prod 參數傳遞至作業:
{
"version": "0.2.0",
"configurations": [
{
"type": "databricks-workflow",
"request": "launch",
"name": "Run on Databricks as Workflow",
"program": "${file}",
"parameters": {},
"args": ["--prod"]
}
]
}
提示
如果你想使用 Python 設定,並利用擴充功能設定中包含的 Databricks Connect 認證,請將 "databricks": true 加入至 "type": "python" 設定中。