使用 sqlmlutils 安裝 Python 套件

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

本文描述如何使用 sqlmlutils 套件中的函式，以將新 Python 套件安裝到 SQL Server 機器學習服務的執行個體，以及巨量資料叢集。 您安裝的套件可用於使用 sp_execute_external_script T-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 核心程序筆記本中的 [管理套件] 功能來進行安裝。

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

從 Python 命令列

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

pip install sqlmlutils

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

1. 請確認已安裝 pip。 請參閱 pip installation (pip 安裝) 以取得詳細資訊。
2. 從 https://github.com/microsoft/sqlmlutils/tree/master/R/dist 將最新的 sqlmlutils ZIP 檔案下載到用戶端電腦。 請勿解壓縮檔案。
3. 開啟 [命令提示字元] 並執行下列命令，以安裝 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 執行個體。

1. 在用戶端電腦上，開啟 Python 或 Python 環境。

2. 使用下列命令來安裝 text-tools 套件。 替代自有的 SQL Server 資料庫連線資訊 (如果使用 Windows 驗證，則不需要 uid 和 pwd 參數)。

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

離線新增套件

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

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

1. 開啟 [命令提示字元] 並執行下列命令，以建立包含 text-tools 套件的本機資料夾。 這個範例會建立 c:\temp\text-tools 資料夾。

   pip download text-tools -d c:\temp\text-tools
   

2. 將 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 陳述式。

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")

更多 sqlmlutils 函數

sqlmlutils 套件包含許多用於管理 Python 套件，以及在 SQL Server 中建立、管理及執行預存程序與查詢的函數。 如需詳細資料，請參閱 sqlmlutils Python 讀我檔案。

如需任何 sqlmlutils 函數的詳細資訊，請使用 Python help 函數。 例如：

import sqlmlutils
help(SQLPackageManager.install)

後續步驟

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

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