共用方式為

為 Visual Studio Code 的 Databricks 延伸模組選取工作區目錄

  • 發行項

注意

本文適用於 Visual Studio Code 的舊版 Databricks 擴充功能。 如需 Visual Studio Code 第 2 版和更新版本的 Databricks 延伸模組工作區同步資訊，請參閱 同步處理您的工作區資料夾與 Databricks。

此文件已淘汰，且可能未更新。 不再支援此內容中提及的產品、服務或技術。

本文說明如何為Visual Studio Code的 Databricks 擴充功能選取 Azure Databricks 工作區目錄。 請參閱什麼是適用於 Visual Studio Code 的 Databricks 延伸項目？

下列資訊假設您已設定適用於 Visual Studio Code 的 Databricks 擴充功能，以便向 Azure Databricks 工作區進行驗證。 請參閲 適用於 Visual Studio Code 的 Databricks 延伸項目的驗證設定。

注意

適用於 Visual Studio Code 的 Databricks 擴充功能僅適用於其建立的工作區目錄。 除非延伸模組已建立工作區目錄，否則您無法在工作區中使用現有的工作區目錄。

若要搭配 Visual Studio Code 的 Databricks 擴充功能使用工作區目錄，您必須使用 0.3.5 版或更高版本的延伸模組，而且您的 Azure Databricks 叢集必須已安裝 Databricks Runtime 11.3 LTS 或更高版本。

工作區目錄是預設設定，從延伸模組0.3.15版開始。 不過，如果您將延伸模組設定為使用 Databricks Git 資料夾，而不是工作區目錄，您可以將延伸模組設定回使用工作區目錄，如下所示：

  1. 開啟延伸模組和您的程式代碼專案，並已設定 Azure Databricks 組態配置檔，在 [命令選擇區] 中>輸入 Preferences: Open User Settings，然後按兩下 [喜好設定：開啟使用者設定]。
  2. 在 [ 使用者] 索引標籤上，展開 [ 擴充功能]，然後按兩下 [Databricks]。
  3. 針對 [同步：目的地類型]，選取 工作區。
  4. 結束並重新啟動 Visual Studio Code。

請注意，當您將設定從使用 Databricks Git 資料夾變更為使用工作區目錄之後，您可能需要手動將程式代碼重新同步至工作區。 若要這樣做，請在下一個程式中建立新的工作區目錄之後，按兩下 [同步目的地] 旁的箭號圓形 （開始同步處理） 圖示。

開始同步處理圖示 0

開啟延伸模組和程式代碼專案後，請建立您想要使用的新 Azure Databricks 工作區目錄，或選取您稍早使用擴充功能建立的現有工作區目錄。

建立新的工作區目錄

若要建立新的工作區目錄，請執行下列動作：

  1. 在 [設定] 窗格中，按兩下 [同步目的地] 旁的齒輪 （設定同步目的地） 圖示。

    設定同步目的地圖示 1

  2. 在命令選擇區中，按兩下 [建立新的同步目的地]。

  3. 輸入新工作區目錄的名稱，然後按 Enter。

    延伸模組會在工作區中 /Users/<your-username>/.ide 建立具有指定目錄名稱的目錄，然後將工作區目錄的路徑新增至程式代碼項目的 .databricks/project.json 檔案，例如 "workspacePath": "/Users/<your-username>/.ide/<your-directory-name>"。

    注意

    如果遠端工作區目錄的名稱不符合本機程式代碼專案的名稱，會出現警告圖示，並顯示下列訊息：遠端同步目的地名稱不符合目前的 Visual Studio Code 工作區名稱。 如果您不需要名稱相符，可以忽略此警告。

  4. 設定工作區目錄之後，按兩下 [同步目的地] 旁的箭號圓形 （開始同步處理） 圖示，開始與工作區目錄同步處理。

    開始同步處理圖示 1

重要

適用於 Visual Studio Code 的 Databricks 擴充功能只會執行單向、自動同步處理本機 Visual Studio Code 專案到遠端 Azure Databricks 工作區中相關工作區目錄的檔案變更。 此遠端工作區目錄中的檔案是暫時性的。 請勿從遠端工作區內起始這些檔案的變更，因為這些變更不會同步處理回本機專案。

重複使用現有的工作區目錄

如果您有使用適用於 Visual Studio Code 的 Databricks 擴充功能建立的現有工作區目錄，而且想要在目前的 Visual Studio Code 項目中重複使用，請執行下列動作：

  1. 在 [設定] 窗格中，按兩下 [同步目的地] 旁的齒輪 （設定同步目的地） 圖示。

    設定同步目的地圖示 2

  2. 在命令 選擇區中，從清單中選取工作區目錄的名稱。

此延伸模組會將工作區目錄的路徑新增至程式碼項目的 .databricks/project.json 檔案，例如 "workspacePath": "/Users/<your-username>/.ide/<your-directory-name>"。

注意

如果遠端工作區目錄的名稱不符合本機程式代碼專案的名稱，會出現警告圖示，並顯示下列訊息：遠端同步目的地名稱不符合目前的 Visual Studio Code 工作區名稱。 如果您不需要名稱相符，可以忽略此警告。

設定工作區目錄之後，按兩下 [同步目的地] 旁的箭號圓形 （開始同步處理） 圖示，開始與工作區目錄同步處理。

開始同步處理圖示 2

重要

適用於 Visual Studio Code 的 Databricks 擴充功能只會執行單向、自動同步處理本機 Visual Studio Code 專案到遠端 Azure Databricks 工作區中相關工作區目錄的檔案變更。 此遠端工作區目錄中的檔案是暫時性的。 請勿從遠端工作區內起始這些檔案的變更，因為這些變更不會同步處理回本機專案。