共用方式為


使用 RevoScaleR 來安裝 R 套件

適用於: SQL Server 2016 (13.x) SQL Server 2017 (14.x)

此文章描述如何使用 RevoScaleR (9.0.1 版或更新版本) 函式來搭配機器學習服務或 R Services 在 SQL Server 上安裝 R 套件。 RevoScaleR 函式可以由遠端的非系統管理員用來在 SQL Server 上安裝套件,而不需要直接存取伺服器。

適用於套件管理的 RevoScaleR 函式

下表描述用於 R 套件安裝及管理的函式。

函式 描述
rxSqlLibPaths \(英文\) 判斷遠端 SQL Server 上執行個體程式庫的路徑。
rxFindPackage (英文) 取得遠端 SQL Server 上一或多個套件的路徑。
rxInstallPackages \(英文\) 從遠端 R 用戶端呼叫此函式來從指定的存放庫,或是透過讀取本機儲存的壓縮套件,於 SQL Server 計算內容中安裝套件。 此函式會檢查相依性,並確保所有相關的套件都可以安裝至 SQL Server,就像本機計算內容中的 R 套件安裝一樣。 若要使用此選項,您必須在伺服器和資料庫上啟用套件管理。 用戶端和伺服器環境都必須具有相同版本的 RevoScaleR。
rxInstalledPackages (英文) 取得在指定計算內容中所安裝之套件的清單。
rxSyncPackages \(英文\) 針對指定的計算內容,複製檔案系統和資料庫之間的套件程式庫相關資訊。
rxRemovePackages \(英文\) 從指定的計算內容中移除套件。 其也會計算相依性,並確保會移除 SQL Server 上的其他套件不再使用的套件,以便釋出資源。

必要條件

  • 已在 SQL Server 上啟用遠端管理。 如需詳細資訊,請參閱在 SQL Server 上啟用遠端 R 套件管理

  • 用戶端和伺服器環境上具有相同版本的 RevoScaleR。 如需詳細資訊,請參閱取得 R 套件資訊

  • 您具有連線至伺服器和資料庫,以及執行 R 命令權限。 您必須是資料庫角色的成員,其能允許您在指定的執行個體和資料庫上安裝套件。

    • 處於共用範圍中的套件,可以由屬於特定資料庫中 rpkgs-shared 角色的使用者安裝。 此角色中的所有使用者都可以將共用套件解除安裝。

    • 處於私人範圍中的套件,可以由屬於資料庫中 rpkgs-private 角色的任何使用者安裝。 不過,使用者只能查看並解除安裝自己的套件。

    • 資料庫擁有者可以使用共用或私人套件。

用戶端連接

重要

Machine Learning Server (先前稱為 R Server) 的支援已於 2022 年 7 月 1 日結束。 如需詳細資訊,請參閱 Machine Learning Server 發生什麼事?

用戶端工作站可以是位於相同網路上的 Microsoft R 用戶端 \(英文\) 或 Microsoft Machine Learning Server \(英文\) (資料科學家通常會使用免費的開發人員版本)。

從遠端 R 用戶端呼叫套件管理函式時,您必須先使用 RxInSqlServer \(英文\) 函式建立計算內容物件。 之後,針對您使用的每個套件管理函式,請將計算內容以引數的形式傳遞。

使用者身分識別通常會在設定計算內容時指定。 如果您在建立計算內容時不指定使用者名稱和密碼,系統會使用執行 R 程式碼的使用者身分識別。

  1. 從 R 命令列,定義針對執行個體和資料庫的連接字串。

  2. 使用 RxInSqlServer \(英文\) 建構函式來使用連接字串定義 SQL Server 計算內容。

    sqlcc <- RxInSqlServer(connectionString = myConnString, shareDir = sqlShareDir, wait = sqlWait, consoleOutput = sqlConsoleOutput)
    
  3. 建立您想要安裝之套件的清單,然後將清單儲存在字串變數中。

    packageList <- c("e1071", "mice")
    
  4. 呼叫 rxInstallPackages \(英文\) 並傳遞計算內容,以及包含套件名稱的字串變數。

    rxInstallPackages(pkgs = packageList, verbose = TRUE, computeContext = sqlcc)
    

    如果需要相依套件,系統也會加以安裝,前提是用戶端上有可用的網際網路連線。

    系統會使用進行連線之使用者的認證,在該使用者的預設範圍中安裝套件。

在預存程序中呼叫套件管理函式

您可以在 sp_execute_external_script 內執行套件管理函式。 當您這麼做時,系統會使用預存程序呼叫者的安全性內容來執行函式。

範例

此節提供如何在連線至 SQL Server 執行個體或資料庫作為計算內容的情況下,從遠端用戶端使用這些函式的範例。

針對所有範例,您必須提供連接字串或是計算內容 (其需要連接字串)。 此範例提供針對 SQL Server 建立計算內容的其中一個方法:

instance_name <- "computer-name/instance-name";
database_name <- "TestDB";
sqlWait= TRUE;
sqlConsoleOutput <- TRUE;
connString <- paste("Driver=SQL Server;Server=", instance_name, ";Database=", database_name, ";Trusted_Connection=true;", sep="");
sqlcc <- RxInSqlServer(connectionString = connString, wait = sqlWait, consoleOutput = sqlConsoleOutput, numTasks = 4);

取決於伺服器的所在位置,以及安全性模型,您可能需要在連接字串中提供網域和子網路規格,或是使用 SQL 登入。 例如:

connStr <- "Driver=SQL Server;Server=myserver.financeweb.contoso.com;Database=Finance;Uid=RUser1;Pwd=RUserPassword"

在遠端 SQL Server 計算內容上取得套件路徑

此範例會取得計算內容 sqlccRevoScaleR 套件的路徑。

sqlPackagePaths <- rxFindPackage(package = "RevoScaleR", computeContext = sqlcc)
print(sqlPackagePaths)

結果

"C:/Program Files/Microsoft SQL Server/MSSQL14.MSSQLSERVER/R_SERVICES/library/RevoScaleR"

提示

如果您已啟用查看 SQL 主控台輸出的選項,您可能會從 print 陳述式之前的函式取得狀態訊息。 在您完成程式碼測試之後,請在計算內容建構函式中將 consoleOutput 設定為 FALSE 以排除訊息。

取得多個封裝的位置

下列範例會取得計算內容 sqlccRevoScaleRlattice 套件的路徑。 若要取得多個套件的相關資訊,請傳遞包含套件名稱的字串向量。

packagePaths <- rxFindPackage(package = c("RevoScaleR", "lattice"), computeContext = sqlcc)
print(packagePaths)

在遠端計算內容上取得套件版本

從 R 主控台執行此命令,來取得計算內容 sqlServer 上所安裝之套件的組建編號和版本號碼。

sqlPackages <- rxInstalledPackages(fields = c("Package", "Version", "Built"), computeContext = sqlServer)

在 SQL Server 上安裝封裝

此範例會將 forecast 套件及其相依性安裝到計算內容中。

pkgs <- c("forecast")
rxInstallPackages(pkgs = pkgs, verbose = TRUE, scope = "private", computeContext = sqlcc)

從 SQL Server 移除封裝

此範例會將 forecast 套件及其相依性從計算內容中移除。

pkgs <- c("forecast")
rxRemovePackages(pkgs = pkgs, verbose = TRUE, scope = "private", computeContext = sqlcc)

在資料庫和檔案系統之間同步套件

下列範例會檢查資料庫 TestDB,並判斷所有套件是否皆已安裝到檔案系統中。 如果遺失某些套件,系統會在檔案系統中加以安裝。

# Instantiate the compute context
connectionString <- "Driver=SQL Server;Server=myServer;Database=TestDB;Trusted_Connection=True;"
computeContext <- RxInSqlServer(connectionString = connectionString )

# Synchronize the packages in the file system for all scopes and users
rxSyncPackages(computeContext=computeContext, verbose=TRUE)

套件同步會以每個資料庫及每個使用者為基礎運作。 如需詳細資訊,請參閱 SQL Server 的 R 套件同步

使用預存程序來在 SQL Server 中列出套件

從 Management Studio 或其他支援 T-SQL 的工具執行此命令,以在預存程序中使用 rxInstalledPackages 來取得目前執行個體上的已安裝套件清單。

EXEC sp_execute_external_script 
  @language=N'R', 
  @script=N'
    myPackages <- rxInstalledPackages();
    OutputDataSet <- as.data.frame(myPackages);
    '

rxSqlLibPaths 函式可以用來判斷 SQL Server 機器學習服務所使用的作用中程式庫。 此指令碼只能傳回目前伺服器的程式庫路徑。

declare @instance_name nvarchar(100) = @@SERVERNAME, @database_name nvarchar(128) = db_name();
exec sp_execute_external_script 
  @language = N'R',
  @script = N'
    connStr <- paste("Driver=SQL Server;Server=", instance_name, ";Database=", database_name, ";Trusted_Connection=true;", sep="");
    .libPaths(rxSqlLibPaths(connStr));
    print(.libPaths());
  ', 
  @input_data_1 = N'', 
  @params = N'@instance_name nvarchar(100), @database_name nvarchar(128)',
  @instance_name = @instance_name, 
  @database_name = @database_name;

另請參閱