如何使用 Visual Studio Code 將應用程式部署至 SQL Server 巨量數據叢集

適用於：SQL Server 2019 (15.x)

本文說明如何將應用程式部署至 SQL Server 巨量數據叢集。 我們將使用 Microsoft Visual Studio Code 和應用程式部署延伸模組。

Prerequisites

• Visual Studio Code
• SQL Server 巨量數據叢集

Capabilities

應用程式部署延伸模組支援 Visual Studio Code 中的下列工作：

• 使用 SQL Server 巨量數據叢集進行驗證。
• 從 GitHub 存放庫擷取應用程式範本，以部署支援的運行時間。
• 管理使用者工作區中目前開啟的應用程式範本。
• 透過 YAML 格式的規格來部署應用程式。
• 管理 SQL Server 巨量數據叢集中已部署的應用程式。
• 顯示您已在側邊列中部署的所有應用程式，其中包含其他資訊。
• 產生執行規格以取用應用程式或刪除叢集的應用程式。
• 透過執行規格 YAML 取用已部署的應用程式。

下列各節將逐步解說應用程式部署的安裝。 它們也會提供其運作方式的概觀。

如何在 Visual Studio Code 中安裝應用程式部署延伸模組

在 Visual Studio Code 中，安裝 應用程式部署 延伸模組：

1. 若要安裝 App Deploy 作為 Visual Studio Code 的一部分，請從 GitHub 下載延伸模組 。

2. 啟動 Visual Studio Code 並流覽至 [延伸模組] 提要字段。

3. …點選位於邊列頂端的內容選單，然後選取Install from vsix。

   

4. 尋找您下載的 sqlservbdc-app-deploy.vsix 檔案，並選擇它進行安裝。

應用程式部署成功安裝之後，它會提示您重載Visual StudioCode。 您現在應該會在 Visual Studio Code 提要字段中看到 SQL Server BDC 應用程式總管。

載入應用程式瀏覽器

選取提要欄位中的 [延伸模組] 圖示。 側邊面板載入並顯示應用程式總管。

連接到叢集端點

您可以使用下列任一方法來連線到叢集端點：

• 點擊底部的狀態列，顯示 SQL Server BDC Disconnected。
• 或者按兩下 Connect to Cluster 頂端的按鈕，箭號指向門道。

Visual Studio Code 會提示您輸入適當的端點、使用者名稱和密碼。

使用埠 30080 連線到端點 Cluster Management Service 。

您也可以使用下列命令，從命令列找到此端點：

azdata bdc endpoint list

擷取此資訊的另一種方式是流覽至 Azure Data Studio 中的伺服器，並以滑鼠右鍵按兩下 [ 管理]。 會列出服務的端點。

尋找您想要使用的端點，然後連線到叢集。

成功連線時，Visual Studio Code 會通知您已連線到叢集。 已部署的應用程式會顯示在提要字段中，而您的端點和使用者名稱會儲存為 ./sqldbc 使用者配置檔的一部分。 從未儲存任何密碼或令牌。 後續登入時，提示會預先填入已儲存的主機和用戶名稱，但一律會要求您輸入密碼。 如果您要連線到不同的叢集端點，請選擇取 New Connection。 當您結束 Visual Studio Code，以及開啟不同的工作區時，會自動關閉連線。 您接著需要重新連線。

建立應用程式範本

在 Visual Studio Code 中，在您要儲存應用程式成品的位置開啟工作區。

若要從範本部署新的應用程式，請選取 [應用程式規格] 窗格上的 [新增應用程式範本] 按鈕。 提示會詢問您要在本機電腦上儲存名稱、運行時間以及新應用程式的位置。 您提供的名稱和版本應該是 DNS-1035 標籤，且必須包含小寫、英數位元或 『-』。 它們也必須以字母字元開頭，並以英數字元結尾。

最好將延伸模組放在您目前的 Visual Studio Code 工作區中。 這讓您可以全面使用擴充功能的所有功能。

完成後，會在您指定的位置為您建構新的應用程式範本，並在工作區中開啟部署 spec.yaml 。 如果您選擇的目錄位於工作區中，則會列在[ 應用程式規格 ] 窗格中：

新的範本是一個簡單的 helloworld 應用程式，其配置在 [ 應用程式規格 ] 窗格中，如下所示：

• spec.yaml
  • 告知叢集如何部署您的應用程式
• run-spec.yaml
  • 告知叢集您想要如何呼叫您的應用程式

應用程式原始碼位於 [工作區] 資料夾中。

• 來源檔名
  • 這是您的原始碼檔案，如 src 中所指定 spec.yaml
  • 它有一個稱為 handler 的函式，被視為應用程式的 entrypoint，如 spec.yaml 所示。 它會接受名為 msg 的字串輸入，並傳回稱為 out的字串輸出。 這些是在 inputs 的 outputs 和 spec.yaml 中指定。

若要使用 spec.yaml 來部署應用程式，而不是樣板，請選取 New Deploy Spec 按鈕旁的 New App Template 按鈕。 現在重複相同的過程。 您只會收到 spec.yaml，然後可以自由修改它。

部署您的應用程式

您可以立即透過 CodeLens Deploy App 在 spec.yaml 中部署您的應用程式，或在 [應用程式規格] 菜單中，選擇檔案旁的 spec.yaml閃電資料夾 按鈕。 此延伸模組會壓縮您 spec.yaml 所在目錄中的所有檔案。 接著，它會將您的應用程式部署至叢集。

側邊欄中的應用程式狀態會在準備好使用時通知您：

在側邊窗格中，您可以看到下列項目：

您可以使用下列連結來檢視您已部署的所有應用程式：

• 狀態
• 版本
• input parameters
• output parameters
• links
  • swagger
  • details

如果您按下 links，您會看到您可以存取已部署應用程式的 swagger.json。 這可讓您撰寫用戶端來呼叫您的應用程式：

如需詳細資訊，請參閱 在大數據叢集上使用的應用程式。

執行您的應用程式

一旦您的應用程式準備就緒，請使用 run-spec.yaml來呼叫它。 此檔案會作為應用程式範本的一部分提供：

指定要取代 hello的字串。 然後，透過側邊列中的 CodeLens 連結或 閃電 按鈕，再次執行您的應用程式。 如果您沒有看到 run-spec 此選項，請從叢集中部署的應用程式產生一個：

編輯您的 run-spec 之後，請執行它。 當應用程式完成執行時，Visual Studio Code 會傳回意見反應：

在上一個螢幕快照中，您會看到輸出是在工作區的暫存.json檔案中顯示的。 如果您想要保留此輸出，可以儲存它。 否則，會在關閉時刪除。 如果您的應用程式沒有輸出可列印到檔案，您只會取得 Successful App Run 狀態通知。 如果您沒有成功的執行，您會收到錯誤訊息，可協助您判斷出問題。

執行應用程式時，有多種方式可以傳遞參數：

您可以透過 .json指定所需的所有輸入，也就是：

• inputs: ./example.json

當呼叫已部署的應用程式且輸入參數不是原始類型時，請在呼叫點直接指定參數類型。 因此，使用陣列、向量、數據框架、複雜的 JSON 文件等。

• Vector
  • inputs:
    • x: [1, 2, 3]
• Matrix
  • inputs:
    • x: [[A,B,C],[1,2,3]]
• Object
  • inputs:
    • x: {A: 1, B: 2, C: 3}

或者，以您的應用程式所需的格式將字串傳遞至 .txt、 .json或 .csv 檔案。 在這個例子中，檔案解析是以Node.js Path library為基礎，其中檔案路徑定義為string that contains a / or \ character。

如果未提供必要的輸入參數，則會顯示錯誤訊息。 如果指定字串檔案路徑，則會提供不正確的檔案路徑，或指出參數無效。 應用程式建立者必須確保他們了解他們定義的參數。

若要刪除應用程式，請移至側邊窗格中的應用程式 Deployed Apps ，然後選取垃圾桶圖示。

Next steps

探索如何在您自己的應用程式中整合部署在 SQL Server 巨量資料叢集上的應用程式，詳情請參閱 使用巨量資料叢集上的應用程式。 您也可以參閱 應用程式部署範例 中的其他範例，以嘗試擴充功能。

如需 SQL Server 巨量數據叢集的詳細資訊，請參閱 SQL Server 2019 巨量數據叢集簡介。

我們的目標是讓此延伸模組對您很有用，我們很感激您的意見反應。 請將它們傳送給 SQL Server 小組。