什麼是適用於 Visual Studio Code 的 Databricks 延伸項目？

適用於 Visual Studio Code 的 Databricks 延伸模組可讓您從本機開發電腦上的 Visual Studio Code 或 游標 連線到遠端 Azure Databricks 工作區。 接著，您可以：

• 定義、部署並執行宣告式自動化套件，將 CI/CD 模式與最佳實務套用至 Lakeflow 工作、Lakeflow Spark 宣告式管線及 MLOps 堆疊，使用 Visual Studio Code 介面。 請參閱 「什麼是宣告式自動化套件？」 以及「 宣告式自動化套件」擴充功能。
• 在遠端工作區的 Azure Databricks 叢集或無伺服器計算上，從 Visual Studio Code 執行本機 Python 程式代碼檔案。 請參閱 在叢集上運行 Python 檔案。
• 在遠端工作區中，從 Visual Studio Code 執行本機 Python 程式碼檔案（.py）和 Python、R、Scala 和 SQL 筆記本（.py、.ipynb、.r、.scala 和 .sql）作為 Lakeflow 作業。 請參閱執行 Python 檔案作為作業。
• 使用簡單的檢查清單以觸發選擇對話框，設置和配置您的偵錯環境及 Databricks Connect。 請參閱使用 Databricks Connect 為 Visual Studio Code 的 Databricks 延伸項目偵錯程式碼。
• 使用 Databricks Connect 在 Visual Studio Code 內對筆記本逐個資料格地進行偵錯。 請參閱適用於 Visual Studio Code 的 Databricks 擴充功能，使用 Databricks Connect 執行和偵錯筆記本中的資料格。
• 將您在 Visual Studio Code 開發的本機程式碼與遠端工作區的程式碼同步。 請參閱 將您的工作區資料夾同步至 Databricks

注意

適用於 Visual Studio Code 的 Databricks 延伸項目支援以自動化作業的形式執行 R、Scala 和 SQL 筆記本，但不會在 Visual Studio Code 中提供對這些語言的任何更深入支援。

開始

若要開始使用適用於 Visual Studio Code 的 Databricks 擴充功能：

• 安裝延伸項目。
• 建立 新的 Databricks 專案，或將 現有的 Visual Studio Code 項目 轉換。
• 使用 Databricks 擴充功能 UI 輕鬆地設定您的專案。
• 在延伸項目教學課程中執行一些 Python 程式碼。
• 使用 Databricks Connect 整合對程式碼進行偵錯。
• 使用 pytest 測試您的程式碼。 請參閱 使用適用於 Visual Studio Code 的 Databricks 延伸模組執行 Python 測試。

建立新的 Databricks 專案

安裝延伸項目之後，您可以使用適用於 Visual Studio Code 的 Databricks 延伸項目來建立新的 Databricks 專案：

1. 啟動 Visual Studio Code。
2. 按一下 Visual Studio Code 側邊欄中的 Databricks 圖示，以開啟延伸項目。
3. 按一下 建立新專案。
4. 在 命令選擇區中，選取專案的主機和驗證方法。 請參閱 為 Visual Studio Code設定 Databricks 擴充套件的授權。
5. 在提供專案資料夾路徑欄位中，輸入您想在本機開發電腦上創建專案的資料夾路徑，或點選開啟資料夾選取對話框，然後選擇專案資料夾的路徑。
6. 若要讓 範本在 Databricks 專案初始化檢視中使用，請使用向上和向下箭號來選取專案範本，然後按 Enter。 有關套件專案範本的資訊，請參閱宣告式自動化套件專案範本。
7. 為專案輸入此專案的唯一名稱，或保留預設專案名稱 my_project，然後按 Enter 鍵。
8. 選擇是否要將存根（範例）筆記本、存根（範例）Delta Live Tables 管線或存根（範例）Python 套件新增至專案，或這些存根的任何組合（範例）。
9. 按任意鍵以關閉 Databricks Project Init 編輯器索引標籤。
10. 請針對您想要開啟的專案，選擇您剛剛建立的專案。

開啟一個現有的宣告式自動化套件專案

宣告式自動化套件專案在專案根目錄中有一個 databricks.yml 檔案。 請參閱 宣告式自動化套件的設定。 如果你想在現有的 Declarative Automation Bundles 專案中使用這個擴充功能：

1. 啟動 Visual Studio Code。 從主功能表中，按一下 [檔案] >[開啟資料夾]，然後瀏覽至包含套件組合專案的目錄。

2. 按兩下Visual Studio Code 提要欄中的 Databricks 圖示，以開啟並開始使用延伸模組的功能。

   如果 Visual Studio Code 的 Databricks 擴充功能在當前資料夾中發現多個宣告式自動化套件專案，它會讓你選擇在根目錄中開啟專案或建立專案設定檔。

   

   • 如果你選擇了一個專案，在 指令面板中選擇你現有的 Declarative Automation Bundles 專案。
   • 如果您在根資料夾中建立組態，該資料夾會變成配套專案。

3. 選取專案的主機和驗證方法。 請參閱 為 Visual Studio Code設定 Databricks 擴充套件的授權。

注意

如果您使用適用於 Visual Studio Code 的 Databricks 延伸模組 v1 開啟專案，則會使用專案現有的驗證和工作區設定自動嘗試移轉。 只有在自動移轉失敗時，才能使用移轉按鈕。

在 Databricks 專案之間切換

適用於 Visual Studio Code 的 Databricks 延伸項目可讓您在 Visual Studio Code 工作區內有多個 Databricks 專案，並輕鬆地在這些專案之間切換。 在 Visual Studio Code 工作區中開啟多包專案：

1. 按一下 Visual Studio Code 側邊欄中的 Databricks 圖示，以開啟延伸項目。

2. 按一下 本機資料夾 選取擴充功能要使用的專案。

   

注意

執行動作僅適用於使用中套件組合中的檔案。

將項目轉換成 Databricks 專案

如果您有想要轉換成 Databricks 專案的現有專案：

1. 啟動 Visual Studio Code。 從主功能表中，按一下 [檔案] >[開啟資料夾]，並瀏覽至您的專案以開啟它。
2. 按一下 Visual Studio Code 側邊欄中的 Databricks 圖示，以開啟延伸項目。
3. 按一下 [建立設定]。
4. 在 命令選擇區中，選取專案的主機和驗證方法。 請參閱 為 Visual Studio Code設定 Databricks 擴充套件的授權。