共用方式為

在 Linux 上安裝 SQL Server 2022 機器學習服務 (Python 和 R)

  • 發行項

適用於： SQL Server 2022 (16.x) - Linux

本文會引導您在 Linux 上安裝 SQL Server 機器學習服務。 您可使用機器學習服務來在資料庫中執行 Python 和 R 指令碼。

您可以在 Ubuntu 和 Red Hat Enterprise Linux (RHEL) 上安裝機器學習服務。 目前不支援 SUSE Linux Enterprise Server (SLES)。

您可以在執行 Linux 發行版本的 Docker 容器上安裝 ML 服務。 在 Docker 容器內，步驟會與以下相同。

如需詳細資訊，請參閱 Linux 上的 SQL Server 安裝指引中的＜支援的平台＞一節。

重要

本文參考 SQL Server 2022 (16.x)。 若是 Linux 上的 SQL Server 2019，請參閱在 Linux 上安裝 SQL Server 2019 機器學習服務 (Python 和 R)。 若是 Windows 上的 SQL Server，請參閱在 Windows 上安裝 SQL Server 2022 機器學習服務 (Python 和 R)。

預先安裝檢查清單

  • 在 Linux 上安裝 SQL Server 並驗證安裝。

  • 查看 Python 和 R 延伸模組的 SQL Server Linux 存放庫。 如果您已為資料庫引擎安裝設定來源存放庫，您可以使用相同的存放庫註冊來執行 mssql-server-extensibility 封裝安裝命令。

  • 您應該有執行 T-SQL 命令的工具。

    • 您可使用 Azure Data Studio，這是在 Linux、Windows 和 macOS 上執行的免費資料庫工具。

  • 需要在此安裝過程中重新啟動 SQL Server 執行個體。

套件清單

在連線到網際網路的裝置上，系統會使用每個作業系統的套件安裝程式，獨立地下載及安裝套件。

Linux 上 SQL Server 2022 (16.x) 可用的安裝套件：

套件名稱 適用於 描述
mssql-server-extensibility 全部 用來執行 Python 和 R 的擴充性架構。

安裝 mssql-server-extensibility 套件

  1. 設定存放庫，以安裝及升級對應至Linux發行版的 Linux 上的 SQL Server。 使用套件 mssql-server-extensibility 和相關聯相依性 libssl-dev 安裝 SQL Server 擴充性功能。

    Ubuntu \(英文\)

    sudo apt-get install mssql-server-extensibility libssl-dev

    RHEL

    yum install mssql-server-extensibility

  2. 檢閱並接受 SQL Server ML 服務的使用者授權合約 (EULA)。

    sudo /opt/mssql/bin/mssql-conf set EULA accepteulaml Y

    若要完成接受 EULA，必須重新啟動 SQL Server 執行個體。

    sudo systemctl restart mssql-server

安裝執行階段和套件

設定 R 支援

安裝 R 執行階段

  1. 下載並安裝所需的 R 版本。 選擇 R 4.2 版或更高版本，可直接從 cran.r-project.org 下載。請依照所需執行階段的指示進行。

  2. 開啟管理員 R 終端機：

    sudo R

  3. 執行下列命令，以安裝 CompatibilityAPI 和 RevoScaleR 的相依性：

    # R Terminal
install.packages("iterators", lib="/usr/lib/R/library")
install.packages("foreach", lib="/usr/lib/R/library")
install.packages("R6", lib="/usr/lib/R/library")
install.packages("jsonlite", lib="/usr/lib/R/library")

  4. 為 Linux 下載並安裝 CompatibilityAPI 和 RevoScaleR。

    install.packages("https://aka.ms/sqlml/r4.2/linux/CompatibilityAPI_1.1.0_R_x86_64-pc-linux-gnu.tar.gz", repos=NULL, lib="/usr/lib/R/library")
install.packages("https://aka.ms/sqlml/r4.2/linux/RevoScaleR_10.0.1_R_x86_64-pc-linux-gnu.tar.gz", repos=NULL, lib="/usr/lib/R/library")

  5. 從 R 終端機確認 RevoScaleR 安裝。

    library("RevoScaleR")

使用 SQL Server 設定 R 執行階段

  1. 使用適用於 Linux 的 SQL Server 設定已安裝的 R 執行階段，其中 path/to/ 是 R 二進位檔的檔案路徑，而 RFolderVersion 是所安裝 R 執行階段的版本特定資料夾名稱 (例如 R4.2)。

    sudo /opt/mssql/bin/mssql-conf set extensibility rbinpath /usr/lib/R/bin/R
sudo /opt/mssql/bin/mssql-conf set extensibility datadirectories /usr/lib/R

  2. 重新啟動 Launchpadd 服務。

    systemctl restart mssql-launchpadd.service

  3. 設定適用於 Linux 的 SQL Server，以允許使用 sp_configure 系統預存程序的外部指令碼。

    EXECUTE sp_configure 'external scripts enabled', 1;
GO

RECONFIGURE;
GO

  4. 執行簡單的 T-SQL 命令傳回 R 的版本，以確認安裝：

    EXECUTE sp_execute_external_script
    @script = N'print(R.version)',
    @language = N'R';
GO

設定 Python 支援

安裝 Python 執行階段

  1. 下載與安裝 Python。 專門選擇 Python 3.10 版，可直接從 python.org 下載。請依照提供的指示進行。 此外，為執行階段版本安裝共用的 Python 執行階段程式庫。 例如，若要為 Ubuntu 安裝 libpython3.10：sudo apt-get install libpython3.10。

  2. 為根使用者下載並安裝 revoscalepy。

    sudo pip install dill numpy==1.22.0 pandas patsy python-dateutil
sudo pip install https://aka.ms/sqlml/python3.10/linux/revoscalepy-10.0.1-py3-none-any.whl --target=/usr/lib/python3.10/dist-packages

  3. 從 Python 終端機確認 revoscalepy 安裝。 確認可匯入程式庫。

    import revoscalepy

使用 SQL Server 設定 Python 執行階段

  1. 使用 SQL Server 設定已安裝的 Python 執行階段，其中 pythonbinbath 會設定為已安裝 Python 二進位檔的路徑，而 datadirectories 會包含為所需 Python 版本安裝套件所使用的路徑 (例如 /usr/lib/python3.10/dist-packages)。 使用下列指令碼並搭配您的實際安裝路徑：

    sudo /opt/mssql/bin/mssql-conf set extensibility pythonbinpath /usr/bin/python3.10
sudo /opt/mssql/bin/mssql-conf set extensibility datadirectories /usr/lib:/usr/lib/python3.10/dist-packages

  2. 重新啟動 Launchpadd 服務。

    systemctl restart mssql-launchpadd.service

  3. 設定適用於 Linux 的 SQL Server，以允許使用 sp_configure 系統預存程序的外部指令碼。

    EXECUTE sp_configure 'external scripts enabled', 1;
GO

RECONFIGURE;
GO

  4. 執行簡單的 T-SQL 命令傳回 Python 的版本，以確認安裝：

    EXECUTE sp_execute_external_script
    @script = N'import sys;print(sys.version)',
    @language = N'Python';
GO

安裝 Java

若要安裝 Java 語言延伸模組，請參閱在 Linux 上安裝 SQL Server Java 語言延伸模組。

確認安裝

若要驗證安裝，請使用下列任一方法：

  • 使用查詢工具執行 T-SQL 指令碼，該指令碼會執行叫用 Python 或 R 的系統預存程序。

  • 執行下列 SQL 命令，以在 SQL Server 中測試 R 執行。 錯誤？ 請嘗試重新啟動服務，sudo systemctl restart mssql-server.service。

    EXECUTE sp_execute_external_script
    @language = N'R',
    @script = N'
      OutputDataSet <- InputDataSet', @input_data_1 = N'SELECT 1 AS hello'
    WITH RESULT SETS
(
        ([hello] INT NOT NULL)
);
GO

  • 執行下列 SQL 命令，以在 SQL Server 中測試 Python 執行。

    EXECUTE sp_execute_external_script
    @language = N'Python',
    @script = N'
      OutputDataSet = InputDataSet;
      ', @input_data_1 = N'SELECT 1 AS hello'
    WITH RESULT SETS
(
        ([hello] INT NOT NULL)
);
GO

離線安裝

遵循離線安裝指示，以取得安裝套件的步驟。 尋找您的下載網站，然後使用以下套件清單下載特定套件。

提示

數個套件管理工具都提供協助您判斷套件相依性的命令。 若是 yum，請使用 sudo yum deplist [package]。 若是 Ubuntu，請使用 sudo apt-get install --reinstall --download-only [package name]，後面接著 dpkg -I [package name].deb。

適用於 Python 和 R 執行階段的獨立 RevoScale 套件

RevoScale 套件也可以是用於 Python 和 R 執行階段的獨立套件。 若要為獨立案例安裝 Python 或 R 執行階段，請分別依照安裝 Python 執行階段和安裝 R 執行階段小節中的指示操作。

相關內容