在 Windows 上安裝 SQL Server Java 語言延伸模組

適用於：SQL Server 2019 (15.x) 和更新版本

了解如何在 Windows 上安裝適用於 SQL Server 的 Java 語言延伸模組元件。 Java 語言延伸模組是 SQL Server 語言延伸模組的一部分。

注意

此文章適用於在 Windows 上安裝適用於 SQL Server 的 Java 語言延伸模組。 針對 Linux，請參閱在 Linux 上安裝 SQL Server Java 語言延伸模組。 如需 Windows 上的 C# 語言延伸模組，請參閱在 Windows 上安裝 SQL Server .NET 語言延伸模組。

必要條件

注意

功能和安裝選項會因 SQL Server 的版本而異。 使用版本選取器下拉式清單來選擇適當的 SQL Server 版本。

• 如果您想要安裝 Java 語言延伸模組的支援，則需要 SQL Server 安裝程式。

• 您可以視需要下載並安裝任何 JAVA 執行階段，包括最新 OpenJDK 的 Microsoft 組建或正式授權的 Java 執行階段。 在 SQL Server 2022 (16.x) 和更新版本中，SQL Server 安裝程式不會安裝 Java 執行階段。

• 需要資料庫引擎執行個體。 您無法只安裝 Java 語言延伸模組功能，但是您可以透過累加方式將其新增至現有的執行個體。

• 針對商務持續性，語言延伸模組支援 Always On 可用性群組。 您必須在每個節點上安裝語言延伸模組，並設定套件。 亦支援在 SQL Server 中的容錯移轉叢集執行個體上安裝 Java 語言延伸模組。

• 請勿在網域控制站上安裝 SQL Server 語言延伸模組或 Java 語言延伸模組。 安裝程式的語言延伸模組部分會失敗。

• 根據預設，系統會在 SQL Server 巨量資料叢集上安裝語言延伸模組與機器學習服務。 如果您使用的是巨量資料叢集，就不需要依照此文章中的步驟進行。 如需詳細資訊，請參閱對安裝有機器學習服務的 SQL Server 2019 巨量資料叢集執行 Python 與 R 指令碼。

重要

安裝完成之後，請務必完成此文章中所述的設定後步驟。 這些步驟包括讓 SQL Server 使用外部程式碼，以及新增 SQL Server 代表您執行 Java 程式碼所需的帳戶。 設定變更通常需要重新啟動執行個體，或重新啟動啟動控制板服務。

Java JRE 或 JDK

注意

功能和安裝選項會因 SQL Server 的版本而異。 使用版本選取器下拉式清單來選擇適當的 SQL Server 版本。

使用 SQL Server 2022 (16.x)，您可以下載並安裝任何 JAVA 執行階段，包括最新 OpenJDK 的 Microsoft 組建或正式授權的 Java 執行階段。

Java 11 目前是 Windows 上支援的版本。 Java Runtime Environment (JRE) 是最低需求，但如果您需要 Java 編譯器與開發套件，Java 開發套件 (JDK) 就很有用。 由於 JDK 全都包含在內，因此如果您安裝 JDK，就不需要 JRE。 在 Windows 上，建議您盡可能地將 JDK 安裝在預設的 /Program Files/ 資料夾下。 否則，需要進行額外的設定，才能授與可執行檔權限。 如需詳細資訊，請參閱此文件中的授與權限 (Windows) 一節。

取得安裝媒體

SQL Server 的下載位置因版本而異：

• SQL Server Enterprise、Standard 和 Express Edition。 這些版本已獲得生產環境使用授權。 對於 Enterprise Edition 和 Standard Edition，請連絡您的軟體廠商以取得安裝媒體。 購買資訊和 Microsoft 合作夥伴目錄請見 Microsoft 購買網站。

• 最新的免費版本。

執行安裝程式

如果是本機安裝，您必須以管理員身分執行安裝程式。 如果您是從遠端共用位置安裝 SQL Server，則必須使用對遠端共用位置具有讀取和執行權限的網域帳戶。

1. 啟動 SQL Server 的安裝精靈。

2. 在 [安裝] 索引標籤上，選取 [新增 SQL Server 獨立安裝或將功能加入至現有安裝] 。

3. 在 [特徵選取] 頁面上，選取下列選項：

   資料庫引擎服務：若要搭配 SQL Server 使用語言延伸模組，您必須安裝資料庫引擎的執行個體。 您可以使用預設或具名執行個體。

   機器學習服務和語言延伸模組：此選項會安裝支援 Java 程式碼執行的語言延伸模組元件。

   

4. 在 [準備安裝] 頁面上，確認包含這些選項，然後選取 [安裝] 。

   • Database Engine 服務
   • 機器學習服務和語言延伸模組

   請注意組態檔儲存所在資料夾 (路徑 ..\Setup Bootstrap\Log 底下) 的位置。 當安裝程式完成時，您可以在摘要檔案中檢閱已安裝的元件。

5. 當安裝程式完成之後，如果系統指示您重新啟動電腦，則請立即重新啟動。 當您完成安裝時，請務必閱讀安裝精靈提供的訊息。 如需詳細資訊，請參閱＜ View and Read SQL Server Setup Log Files＞。

新增 JRE_HOME 變數

JRE_HOME 是系統環境變數，可指定 Java 解譯器的位置。 在此步驟中，請在 Windows 上為它建立系統環境變數。

1. 尋找並複製 JRE 主路徑。

   此路徑取決於執行階段和安裝選項。

   Java 延伸模組會嘗試從路徑 %JRE_HOME%\bin\server 載入 jvm.dll。

1. 在 [控制台] 中，開啟 [系統及安全性]、開啟 [系統]，然後選取 [進階系統內容]。

2. 選取 [環境變數]。

3. 為 JRE_HOME 建立新的系統變數，其值為 JDK/JRE 路徑 (可在步驟 1 中找到)。

1. 註冊語言延伸模組。 遵循下列步驟來下載並註冊用於 Java 自訂執行階段的 Java 語言延伸模組。

   1. 從 SQL Server GitHub 存放庫的 Java 語言延伸模組下載 java-lang-extension-windows-release.zip 檔案。 下載最新的 Windows java-lang-extension-windows.zip 檔案。 如果您尚未從 SQL Server 安裝程式安裝預設 Java，請確保 JRE 版本與從 GitHub 下載的版本相符。 如果想要使用自己安裝的 JRE 版本，您可能需要從 GitHub 原始程式碼編譯 java-lang-extension。

   2. 使用 Azure Data Studio 來連線到您的 SQL Server 執行個體，並執行下列 T-SQL 命令，使用 CREATE EXTERNAL LANGUAGE 註冊 Java 語言延伸模組。

   3. 修改此陳述式中的路徑，以反映所下載語言延伸模組 zip 檔案 (java-lang-extension-windows-release.zip) 的位置，以及自訂 Java 安裝的位置 (%ProgramFiles%\Python)。

   CREATE EXTERNAL LANGUAGE [Java]
   FROM (CONTENT = N'C:\path\to\java-lang-extension-windows-release.zip',
       FILE_NAME = 'javaextension.dll',
       ENVIRONMENT_VARIABLES = N'{"JAVAHOME": "C:\\Program Files\\Java"}');
   GO
   

2. 重新啟動啟動控制板。

   1. 開啟 SQL Server 組態管理員。

   2. 在 [SQL Server 服務] 底下，以滑鼠右鍵按一下 [SQL Server 啟動控制板]，然後選取 [重新啟動] 。

授與非預設 JRE 資料夾的存取權

如果未在程式檔案下安裝 Java，您需要執行下列步驟。

從已提高權限行執行 icacls 命令，以將 JRE 存取權授與 SQLRUsergroup 與 SQL Server 服務帳戶 (在 ALL_APPLICATION_PACKAGES 中)。 這些命令會以遞迴方式授與指定目錄路徑下的所有檔案與資料夾的存取權。

1. 授與 SQLRUserGroup 權限

   針對具名執行個體，請將執行個體名稱附加到 SQLRUsergroup (例如 SQLRUsergroupINSTANCENAME)。

   icacls "<PATH to JRE>" /grant "SQLRUsergroup":(OI)(CI)RX /T
   

   如果您已將 JDK/JRE 安裝在 Windows 上的預設資料夾 [Program Files] 底下，則可以略過此步驟。

2. 授與 AppContainer 權限。 此命令會授與電腦 SID S-1-15-2-1 的權限，這相當於英文版 Windows 上的 ALL APPLICATION PACKAGES。 或者，您也可以在英文版的 Windows 上使用 icacls "<PATH to JRE>" /grant "ALL APPLICATION PACKAGES":(OI)(CI)RX /T。

   icacls "<PATH to JRE>" /grant *S-1-15-2-1:(OI)(CI)RX /T
   

重新啟動服務

當安裝完成時，請先重新啟動資料庫引擎，然後再繼續執行下一個步驟，以啟用指令碼執行。

重新啟動該服務也會自動重新啟動相關的 SQL Server Launchpad 服務。

針對 SSMS 中的執行個體，可使用滑鼠右鍵按一下 [重新啟動] 命令，使用控制面板中的 [服務] 面板，或使用 SQL Server 組態管理員來重新啟動服務。

啟用指令碼執行

1. 開啟 SQL Server Management Studio。 連線到您安裝語言延伸模組的執行個體、選取 [新增查詢] 開啟查詢視窗，然後執行下列命令：

   EXEC sp_configure;
   

   該功能預設為關閉 (value 為 0)，因此必須先由管理員明確啟用，才可以執行 Java 程式碼。

2. 若要啟用外部指令碼功能，請執行下列陳述式：

   EXEC sp_configure 'external scripts enabled', 1
   GO
   RECONFIGURE WITH OVERRIDE
   

   如果您已針對機器學習服務啟用該功能，則請不要再次執行語言延伸模組的重新設定。 底層擴充性平台支援這兩者。

註冊外部語言

針對您要在其中使用語言擴充功能的每個資料庫，您必須使用 CREATE EXTERNAL LANGUAGE 來註冊外部語言。

下例會將外部語言呼叫的 Java 新增至 Windows 之 SQL Server 的資料庫。

CREATE EXTERNAL LANGUAGE Java
FROM (CONTENT = N'<path-to-zip>', FILE_NAME = 'javaextension.dll');
GO

如需詳細資訊，請參閱 CREATE EXTERNAL LANGUAGE。

確認安裝

在安裝程式記錄中，檢查執行個體的安裝狀態。

使用下列步驟確認用於啟動外部指令碼的所有元件都正在執行。

1. 在 SQL Server Management Studio 或 Azure Data Studio 中，開啟新的 [查詢] 視窗，並執行下列陳述式︰

   EXEC sp_configure 'external scripts enabled';
   

   run_value 現在設定為 1。

2. 開啟 [服務] 面板或 SQL Server 組態管理員，並確認 SQL Server Launchpad 服務正在執行。 每個安裝語言延伸模組的資料庫引擎執行個體應該都有一個該服務。 如需服務的詳細資訊，請參閱 SQL Server 語言延伸模組中的擴充性架構。

其他設定

如果驗證步驟成功，您就可以從 SQL Server Management Studio、Azure Data Studio、Visual Studio Code，或任何可以將 T-SQL 陳述式傳送到伺服器的其他用戶端來執行 Java 程式碼。

如果您在執行命令時遇到錯誤，請檢閱此節中的其他設定步驟。 您可能需要對服務或資料庫進行額外的適當設定。

在執行個體層級，額外設定可能包括：

• SQL Server 機器學習服務的防火牆設定
• 啟用或停用伺服器網路通訊協定
• 設定遠端存取 (伺服器組態選項)
• 為 SQLRUserGroup 建立登入

在資料庫上，您可能需要下列設定更新：

• 使用 SQL Server 機器學習服務，授與資料庫使用者執行 Python 及 R 指令碼的權限
• 授與使用者執行特定語言的權限

注意

是否需要其他設定取決於您的安全性架構、SQL Server 的安裝位置，以及預期使用者如何連線至資料庫並執行外部指令碼。

建議的最佳化

在一切都正常運作之後，建議您將伺服器最佳化以支援 Java 語言延伸模組。

針對 Java 語言延伸模組將伺服器最佳化

SQL Server 安裝程式的預設設定是為了最佳化伺服器的平衡，以處理資料庫引擎支援的各種服務，其中可能包含擷取、轉換和載入 (ETL) 程序、報告、稽核，以及使用 SQL Server 資料的應用程式。 因此，在預設設定下，您可能會發現語言延伸模組的資源有時會受到限制或遭遇瓶頸，尤其是需要大量記憶體的作業。

為確保優先處理語言延伸模組工作並獲得適當的資源，建議您使用 SQL Server 資源管理員設定外部資源集區。 您也可以變更配置給資料庫引擎的記憶體數量，或增加在 SQL Server Launchpad 服務下執行的帳戶數目。

• 若要設定用來管理外部資源的資源集區，請參閱建立外部資源集區 (Transact-SQL)。

• 若要變更為資料庫保留的記憶體量，請參閱伺服器記憶體設定選項。

如果您使用標準版且沒有「資源管理員」，則可以使用「動態管理檢視 (DMV)」與「擴充事件」，以及 Windows 事件監視，以協助管理伺服器資源。

後續步驟

Java 開發人員可以從一些簡單的範例開始，並了解 Java 如何搭配 SQL Server 使用的基本概念。 針對下一個步驟，請參閱下列連結：

教學課程：使用 Java 的規則運算式