什麼是 Synapse Visual Studio Code 擴充功能？

Synapse Visual Studio Code 延伸模組支援親開發人員體驗，以探索 Microsoft Fabric Lakehouses，以及撰寫 Fabric 筆記本和 Spark 作業定義。 深入瞭解延伸模組，包括如何開始使用必要的必要條件。

Visual Studio （VS） Code 是最受歡迎的輕量型原始碼編輯器之一;它會在您的桌面上執行，適用於 Windows、macOS 和 Linux。 藉由安裝 Synapse VS Code 擴充功能，您可以在 VS Code 本機撰寫、執行和偵錯筆記本和 Spark 作業定義。 您也可以將程式代碼張貼至 Fabric 工作區中的遠端 Spark 計算，以執行或偵錯。 此延伸模組也可讓您在 VS Code 中流覽 Lakehouse 數據，包括數據表和源檔。

必要條件

Synapse VS Code 擴充功能的必要條件：

• 從 OpenJDK8 網站安裝 Java 開發工具套件（JDK）。 請確定使用 JDK 連結，而不是 JRE。
• 安裝 Conda。
• 安裝適用於 VS Code 的 Jupyter 擴充功能

安裝必要的軟體之後，您必須更新作業系統屬性。

Windows

1. 將JAVA_HOME新增至環境變數，並將它指向安裝 java 1.8 的目錄。 例如，如果您在此路徑 C:\Program Files\Java\jdk-1.8上安裝 JDK，請將 JAVA_HOME 變數值設定為該路徑。

2. 將 %JAVA_HOME%/bin 和 Condabin 安裝的 condabin 子資料夾新增至系統路徑目錄。 condabin 資料夾可以位於您安裝的資料夾，且格式為 \miniconda3\condsbin。 開啟環境變數，並將 %JAVA_HOME%/bin 和 condabin 路徑新增至 Path 變數。

macOS

在 終端機執行 conda.sh ：

1. 開啟終端機視窗，將目錄變更為已安裝 conda 的資料夾，然後變更為子目錄 etc/profile.d。 子目錄應該包含名為 conda.sh 的檔案。

2. 執行 source conda.sh。

3. 在相同的終端機視窗中，執行 sudo conda init。

4. 輸入 Java --version。 版本應該是 Java 1.8。

安裝延伸模組並準備您的環境

1. 在 VS Code 擴充功能市集中搜尋 Synapse VS Code ，並安裝延伸模組。

2. 擴充功能安裝完成之後，請重新啟動 VS Code。 延伸模組的圖示會列在 VS Code 活動列上。

本機工作目錄

若要編輯筆記本，您必須有筆記本內容的本地副本。 延伸模組的本機工作目錄會作為所有已下載筆記本的本機根資料夾，甚至是來自不同工作區的筆記本。 藉由叫用 命令 Synapse:Set Local Work Folder，您可以將資料夾指定為延伸模組的本機工作目錄。

若要驗證安裝程式，請開啟擴充功能設定，並檢查其中的詳細數據：

登入和註銷您的帳戶

1. 從 VS Code 命令選擇區中，輸入 Synapse:Sign in 命令以登入延伸模組。 隨即會出現個別的瀏覽器登入頁面。

2. 輸入您的使用者名稱和密碼。

3. 成功登入之後，您的使用者名稱會顯示在 VS Code 狀態列中，以指出您已登入。

   

4. 若要登出延伸模組，請輸入 命令 Synapse: Sign off。

選擇要使用的工作區

若要選取網狀架構工作區，您必須建立工作區。 如果您沒有帳戶，您可以在網狀架構入口網站中建立一個。 如需詳細資訊，請參閱 建立工作區。

擁有工作區之後，請選取 [ 選取工作區 ] 選項加以選擇。 您有權存取的所有工作區清單隨即出現;從清單中選取您想要的專案。

目前的限制

• 桌面模式下的擴充功能尚不支援 Microsoft Spark 公用程式
• 不支援以 “！” 開頭的Shell 命令。

相關內容

在此概觀中，您會基本瞭解如何安裝和設定 Synapse VS Code 擴充功能。 下一篇文章說明如何在 VS Code 中本機開發筆記本和 Spark 作業定義。

• 若要開始使用筆記本，請參閱 在Visual StudioCode中建立和管理 Microsoft Fabric 筆記本。
• 若要開始使用 Spark 作業定義，請參閱 在 Visual Studio Code 中建立和管理 Apache Spark 作業定義。