使用 sqlmlutils 安裝 Python 套件

發行項
05/04/2023

適用於： SQL Server 2019 (15.x)Azure SQL 受控執行個體

本文描述如何使用 sqlmlutils 套件中的函式，以將新 Python 套件安裝到 SQL Server 機器學習服務的執行個體，以及巨量資料叢集。您安裝的套件可用於使用 sp_execute_external_script T-SQL 陳述式在資料庫中執行的 Python 指令碼。

本文描述如何使用 sqlmlutils 套件中的函式，以將新 Python 套件安裝到 Azure SQL 受控執行個體機器學習服務的執行個體上。您安裝的套件可用於使用 sp_execute_external_script T-SQL 陳述式在資料庫中執行的 Python 指令碼。

注意

您無法更新或解除安裝已預先安裝於 SQL 受控執行個體機器學習服務執行個體上的套件。若要檢視目前已安裝的套件清單，請參閱列出所有已安裝的 Python 套件 (部分機器翻譯)。

如需套件位置和安裝路徑的詳細資訊，請參閱取得 Python 套件資訊。

注意

本文所述的 sqlmlutils 套件是用來將 Python 套件新增至 SQL Server 2019 或更新版本。 SQL Server 2017 及舊版請參閱使用 Python 工具安裝套件。

Prerequisites

您必須使用 Python 語言選項安裝 SQL Server 機器學習服務。

在用來連線到 SQL Server 的用戶端電腦上安裝 Azure Data Studio。您可以使用其他資料庫管理或查詢工具，但此文章假設使用 Azure Data Studio。
在 Azure Data Studio 中安裝 Python 核心程序。您也可以從命令列安裝及使用 Python，而且可以使用替代的 Python 開發環境，例如具有 Python 延伸模組的 Visual Studio Code。

用戶端電腦上的 Python 版本必須符合伺服器上的 Python 版本，而且您安裝的套件必須符合所擁有的 Python 版本。如需每個 SQL Server 版本隨附的 Python 版本相關資訊，請參閱 Python 和 R 版本。

若要確認特定 SQL Server 執行個體上的 Python 版本，請使用下列 T-SQL 命令。
```
EXECUTE sp_execute_external_script
  @language = N'Python',
  @script = N'
import sys
print(sys.version)
'
```

其他考量

Python 套件程式庫位於 SQL Server 執行個體的 Program Files 資料夾中，而且根據預設，在此資料夾中安裝需要系統管理員權限。如需詳細資訊，請參閱套件程式庫位置。
套件安裝是您在提供給 sqlmlutils的連線資訊中指定的 SQL 執行個體、資料庫和使用者專用的。若要在多個 SQL 執行個體或資料庫中使用套件，或將其用於不同的使用者，您必須個別為其安裝套件。例外狀況是，如果套件是由 dbo 的成員所安裝，則套件會是公用的，且會與所有使用者共用。如果使用者安裝了較新版本的公用套件，公用套件將不受影響，但該使用者將可存取較新的版本。
新增套件之前，請考慮套件是否適合用於 SQL Server 環境。
- 我們建議您在資料庫中使用 Python，以進行與資料庫引擎 (例如機器學習服務) 緊密整合的工作，而不是單純查詢資料庫的工作。
- 如果您新增的套件為伺服器帶來過多的計算壓力，效能將會受到影響。
- 在已強化的 SQL Server 環境中，您可以避免下列情況：
  - 需要網路存取的套件
  - 需要提升檔案系統存取權的套件
  - 用於網頁程式開發或其他工作，但無法透過在 SQL Server 內部執行而獲益的套件
- 您無法使用 sqlmlutils 來安裝 Python 套件 tensorflow。如需詳細資訊及因應措施，請參閱 SQL Server 機器學習服務中的已知問題。

在用戶端電腦上安裝 sqlmlutils

若要使用 sqlmlutils，您必須先將其安裝在用來連接到 SQL Server 的用戶端電腦上。

在 Azure Data Studio 中

若您將在 Azure Data Studio 中使用 sqlmlutils，則可使用 Python 核心程序筆記本中的 [管理套件] 功能來進行安裝。

在 Azure Data Studio 中的 Python 核心程序筆記本內，按一下 [管理套件]。
按一下 [新增] 。
在 [搜尋 Pip 套件] 欄位中輸入 "sqlmlutils"，然後按一下 [搜尋]。
選取所要安裝的套件版本 (建議安裝最新版本)。
按一下 [安裝]，然後按一下 [關閉]。

從 Python 命令列

若將從 Python 命令列或 IDE 使用 sqlmlutils，可使用簡易的 pip 命令來安裝 sqlmlutils：

pip install sqlmlutils

您也可以從 ZIP 檔案安裝 sqlmlutils：

請確認已安裝 pip。請參閱 pip installation (pip 安裝) 以取得詳細資訊。
從 https://github.com/microsoft/sqlmlutils/tree/master/R/dist 將最新的 sqlmlutils ZIP 檔案下載到用戶端電腦。請勿解壓縮檔案。
開啟 [命令提示字元] 並執行下列命令，以安裝 sqlmlutils 套件。以您所下載 sqlmlutils ZIP 檔案的完整路徑取代，此範例假設下載的檔案是 c:\temp\sqlmlutils-1.0.0.zip。
```
pip install --upgrade --upgrade-strategy only-if-needed c:\temp\sqlmlutils-1.0.0.zip
```

在 SQL Server 上新增 Python 套件

使用 sqlmlutils，即可將 Python 套件新增到 SQL 執行個體。接著可在您於 SQL 執行個體內執行的 Python 程式碼中使用這些套件。 sqlmlutils 會使用 CREATE EXTERNAL LIBRARY 來安裝套件及其每個相依性。

在下列範例中，您會將 text-tools 套件新增至 SQL Server。

線上新增套件

如果您用來連線到 SQL Server 的用戶端電腦可以存取網際網路，則可以使用 sqlmlutils 透過網際網路尋找 text-tools 套件和任何相依性，然後從遠端將套件安裝到 SQL Server 執行個體。

在用戶端電腦上，開啟 Python 或 Python 環境。
使用下列命令來安裝 text-tools 套件。替代自有的 SQL Server 資料庫連線資訊 (如果使用 Windows 驗證，則不需要 uid 和 pwd 參數)。

在用戶端電腦上，開啟 Python 或 Python 環境。
使用下列命令來安裝 text-tools 套件。替換為您自己的 SQL Server 資料庫連線資訊。

import sqlmlutils
connection = sqlmlutils.ConnectionInfo(server="server", database="database", uid="username", pwd="password")
sqlmlutils.SQLPackageManager(connection).install("text-tools")

離線新增套件

如果您用來連接到 SQL Server 的用戶端電腦沒有網際網路連線，您可以在能存取網際網路的電腦上使用 pip，將套件和任何相依套件下載到本機資料夾。然後，將資料夾複製到用戶端電腦，讓您可以離線安裝套件。

在有網際網路存取的電腦上

開啟 [命令提示字元] 並執行下列命令，以建立包含 text-tools 套件的本機資料夾。這個範例會建立 c:\temp\text-tools 資料夾。
```
pip download text-tools -d c:\temp\text-tools
```
將 text-tools 資料夾複製到用戶端電腦。下列範例假設您已將其複製到 c:\temp\packages\text-tools。

在用戶端電腦上

使用 sqlmlutils，安裝您在 pip 建立的本機資料夾中找到的每個套件 (WHL 檔案)。安裝套件的順序並不重要。

在此範例中，text-tools 沒有相依性，因此 text-tools 資料夾中只有一個檔案可供您安裝。相反地，scikit-plot 之類的套件有11 個相依性，因此您會在資料夾中找到 12 個檔案 (scikit-plot 套件和 11 個相依套件)，而且您將會安裝每個檔案。

請執行下列 Python 指令碼。替代實際檔案路徑和套件名稱，以及自有的 SQL Server 資料庫連線資訊 (如果使用 Windows 驗證，則不需要 uid 和 pwd 參數)。針對資料夾中的每個套件檔案重複 sqlmlutils.SQLPackageManager 陳述式。

請執行下列 Python 指令碼。替代實際檔案路徑和套件名稱，以及自有的 SQL Server 資料庫連線資訊。針對資料夾中的每個套件檔案重複 sqlmlutils.SQLPackageManager 陳述式。

import sqlmlutils
connection = sqlmlutils.ConnectionInfo(server="yourserver", database="yourdatabase", uid="username", pwd="password"))
sqlmlutils.SQLPackageManager(connection).install("text_tools-1.0.0-py3-none-any.whl")

使用套件

您現在可以在 SQL Server 的 Python 指令碼中使用套件。例如：

EXECUTE sp_execute_external_script
  @language = N'Python',
  @script = N'
from text_tools.finders import find_best_string
corpus = "Lorem Ipsum text"
query = "Ipsum"
first_match = find_best_string(query, corpus)
print(first_match)
  '

從 SQL Server 移除套件

如果您想要移除 text-tools 套件，請利用您稍早定義的相同連線變數，在用戶端電腦上使用下列 Python 命令。

sqlmlutils.SQLPackageManager(connection).uninstall("text-tools")

後續步驟

如需 SQL Server 機器學習服務中所安裝 Python 套件的相關資訊，請參閱取得 Python 套件資訊。
如需在 SQL Server 機器學習服務中安裝 R 套件的相關資訊，請參閱在 SQL Server 上安裝新的 R 套件。