RevoScaleR (SQL Server 機器學習服務中的 R 套件)

發行項
05/04/2023

適用於：SQL Server 2016 (13.x) 和更新版本

RevoScaleR 是來自 Microsoft 的 R 套件，其支援分散式計算、遠端計算內容，以及高效能資料科學演算法。其也支援資料匯入、資料轉換、摘要、視覺效果和分析。該套件包含在 SQL Server 機器學習服務與 SQL Server 2016 R Services 中。

相較於基底 R 函式，RevoScaleR 作業可針對大型的資料集、平行處理，以及在分散式檔案系統上執行。函式可以使用區塊化，以及在作業完成時重組結果，來處理無法放入記憶體中的資料集。

RevoScaleR 函式會以 rx** 或 Rx 前置詞表示，使其易於識別。

RevoScaleR 可作為分散式資料科學的平台。例如，您可以在 MicrosoftML 中，使用 RevoScaleR 計算內容和轉換搭配最先進的演算法。您也可以使用 rxExec 平行執行基底 R 函式。

完整參考文件

RevoScaleR 套件分散在多個 Microsoft 產品中，但不論是在 SQL Server 或其他產品中取得該套件，其使用方式都相同。由於函數相同，因此個別 RevoScaleR 函數的文件只發佈至 R 參考底下的一個位置。若有任何產品特定行為存在，函式說明頁面中將會註明不一致之處。

版本與平台

RevoScaleR 套件以 R 3.4.3 為基礎，且只有當安裝下列其中一個 Microsoft 產品或下載項目時才會提供：

注意

在 SQL Server 2017 中，完整產品發行版本僅適用於 Windows。在 SQL Server 2019 中，RevoScaleR 則同時支援 Windows 和 Linux。

依類別區分的函式

本節依類別列出函式，讓您了解每個函式的使用方式。您也可以使用目錄來依字母順序尋找函式。

1-資料來源與計算

RevoScaleR 包含用於建立資料來源及設定計算執行位置 (或計算內容) 的函式。資料來源物件是可一起指定連接字串和您想要之資料集 (可定義為資料表、檢視或查詢) 的容器。不支援預存程序呼叫。下表列出與 SQL Server 案例相關的函式。

在某些情況下，SQL Server 和 R 會使用不同的資料類型。如需 SQL 與 R 資料類型間的對應清單，請參閱 R 與 SQL 的對應資料類型。

函式	描述
RxInSqlServer	建立 SQL Server 計算內容物件以將計算推送至遠端執行個體。數個 RevoScaleR 函式會以計算內容作為引數。
rxGetComputeContext / rxSetComputeContext	取得或設定使用中的計算內容。
RxSqlServerData	根據 SQL Server 查詢或資料表來建立資料物件。
RxOdbcData	根據 ODBC 連線來建立資料來源。
RxXdfData	根據本機 XDF 檔案來建立資料來源。 XDF 檔案通常用來將記憶體內的資料卸載至磁碟。當使用的資料超過可從資料庫以單一批次傳輸的資料，或是超過記憶體可容納的資料時，XDF 檔案非常實用。例如，如果您會定期將大量資料從資料庫移到本機工作站，而不是針對每個 R 作業重複地查詢資料庫，則您可以使用 XDF 檔案作為一種快取以將資料儲存在本機，然後在您的 R 工作區中使用它。

提示

如果您不熟悉資料來源或計算內容，建議您先從分散式計算這篇文章開始。

執行 DDL 陳述式

您可以從 R 執行 DDL 陳述式，前提是您具有執行個體及資料庫的必要權限。下列函式會使用 ODBC 呼叫來執行 DDL 陳述式或擷取資料庫結構描述。

函式	說明
rxSqlServerTableExists 和 rxSqlServerDropTable	卸除 SQL Server 資料表，或檢查資料庫資料表或物件是否存在。
rxExecuteSQLDDL	執行定義或操作資料庫物件的資料定義語言 (DDL) 命令。此函式無法傳回資料，而且只會用來擷取或修改物件結構描述或中繼資料。

2-資料操作 (ETL)

建立資料來源物件之後，您可以使用物件將資料載入其中、轉換資料，或將新的資料寫入至指定的目的地。根據來源中的資料大小，您也可以定義資料來源中的批次大小，以及以區塊移動資料。

函式	說明
rxOpen-methods	檢查資料來源是否可用、開啟或關閉資料來源、從來源讀取資料、將資料寫入至目標，以及關閉資料來源。
rxImport	將資料從資料來源移到檔案儲存體或資料框架中。
rxDataStep	在資料來源之間移動資料時進行轉換。

3-圖形函式

函式名稱	描述
rxHistogram	從資料建立長條圖。
rxLinePlot	從資料建立線繪圖。
rxLorenz	計算可繪製的 Lorenz 曲線。
rxRocCurve	從實際和預測資料計算並繪製 ROC 曲線。

4-描述性統計資料

函式名稱	描述
rxQuantile^*	計算 .xdf 檔案和資料框架的近似分位數，而不需要排序。
rxSummary^*	資料的基本摘要統計資料，包括依群組計算。不支援依群組計算寫入至 .xdf 檔案。
rxCrossTabs^*	資料以公式為基礎的交叉資料表。
rxCube^*	以公式為基礎的替代交叉資料表，針對有效表示傳回的 Cube 結果所設計。不支援將輸出寫入至 .xdf 檔案。
rxMarginals	交叉資料表的臨界摘要。
as.xtabs	將交叉資料表結果轉換為 xtabs 物件。
rxChiSquaredTest	針對 xtabs 物件執行卡方檢定。搭配小型資料集使用，而且不會將資料區塊化。
rxFisherTest	針對 xtabs 物件執行費雪精確檢定。搭配小型資料集使用，而且不會將資料區塊化。
rxKendallCor	使用 xtabs 物件計算肯德爾等級相關係數。
rxPairwiseCrossTab	將函式套用到成對組合的 xtabs 物件資料列與資料行。
rxRiskRatio	計算兩兩 xtabs 物件的相對風險。
rxOddsRatio	計算兩兩 xtabs 物件的勝算比。

^* 表示此類別中最常用的函式。

5-預測函式

函式名稱	描述
rxLinMod^*	將線性模型套入資料。
rxLogit^*	將羅吉斯迴歸模型套入資料。
rxGlm^*	將廣義線性模型套入資料。
rxCovCor^*	計算一組變數的共變數、相關性或正方形 / 交叉乘積矩陣的總和。
rxDTree^*	將分類或迴歸樹狀結構套入資料。
rxBTrees^*	使用隨機梯度提升演算法，將分類或迴歸決策樹系套入資料。
rxDForest^*	將分類或迴歸決策樹系套入資料。
rxPredict^*	計算適合模型的預測。輸出必須是 XDF 資料來源。
rxKmeans^*	執行 K 平均數叢集。
rxNaiveBayes^*	執行貝氏機率分類。
rxCov	計算一組變數的共變數矩陣。
rxCor	計算一組變數的相關矩陣。
rxSSCP	計算一組變數的正方形/交叉乘積矩陣總和。
rxRoc	使用二元分類器系統的實際與預測值的接收器操作特徵曲線 (ROC) 計算。

^* 表示此類別中最常用的函式。

如何使用 RevoScaleR

封裝在預存程序中的 R 程式碼可呼叫 RevoScaleR 中的函式。大多數開發人員會在本機建置 RevoScaleR 解決方案，然後將完成的 R 程式碼移轉至預存程序作為部署練習。

在本機執行時，您通常會從命令列或從 R 開發環境執行 R 指令碼，然後使用其中一個 RevoScaleR 函式來指定 SQL Server 計算內容。您可以將遠端計算內容用於整個程式碼，也可以用於個別函式。例如，您可以將模型定型卸載至伺服器，以使用最新資料並避免資料移動。

當您準備好將 R 指令碼封裝在預存程序 sp_execute_external_script 內時，建議您將程式碼重寫成已清楚定義輸入和輸出的單一函式。