Native scoring

THIS TOPIC APPLIES TO: yesSQL Server (Windows only)noAzure SQL DatabasenoAzure SQL Data WarehousenoParallel Data Warehouse

This topic describes features in SQL Server 2017 that provide scoring on machine learning models in near realtime.

  • What is native scoring vs. realtime scoring
  • How it works
  • Supported platforms and requirements

What is native scoring and how is it different from realtime scoring?

In SQL Server 2016, Microsoft created an extensibility framework that allows R scripts to be executed from T-SQL. This framework supports any operation you might perform in R, ranging from simple functions to training complex machine learning models. However, the dual-process architecture requires invoking an external R process for every call, regardless of the complexity of the operation. If you are loading a pre-trained model from a table and scoring against it on data already in SQL Server, the overhead of calling the external R process represents an unnecessary performance cost.

Scoring is a two-step process. First, you specify a pre-trained model to load from a table. Second, pass new input data to the function, to generate prediction values (or scores). The input can be either tabular or single rows. You can choose to output a single column value representing a probability, or you might output several values, such as a confidence interval, error, or other useful complement to the prediction.

When the input includes many rows of data, it is usually faster to insert the prediction values into a table as part of the scoring process. Generating a single score is more typical in a scenario where you get input values from a form or user request, and return the score to a client application. To improve performance when generating successive scores, SQL Server might cache the model so that it can be reloaded into memory.

To support fast scoring, SQL Server Machine Learning Services (and Microsoft Machine Learning Server) provide built-in scoring libraries that work in R or in T-SQL. There are different options depending on which version you have.

Native scoring

  • The PREDICT function in Transact-SQL supports native scoring in any instance of SQL Server 2017. It requires only that you have a model already trained, which you can call using T-SQL. Native scoring using T-SQL has these advantages:

    • No additional configuration is required.
    • The R runtime is not called. There is no need to install R.

Realtime scoring

  • sp_rxPredict is a stored procedure for realtime scoring that can be used to generates scores from any supported model type, without calling the R runtime.

    This stored procedure is also available in SQL Server 2016, if you upgrade the R components using the standalone installer of Microsoft R Server. sp_rxPredict is also supported in SQL Server 2017. Therefore, you might use this function when generating scores with a model type not supported by the PREDICT function.

  • The rxPredict function can be used for fast scoring within R code.

For all of these scoring methods, you must use a model that was trained using one of the supported RevoScaleR or MicrosoftML algorithms.

For an example of realtime scoring in action, see End to End Loan ChargeOff Prediction Built Using Azure HDInsight Spark Clusters and SQL Server 2016 R Service

How native scoring works

Native scoring uses native C++ libraries from Microsoft that can read the model from a special binary format and generate scores. Because a model can be published and used for scoring without having to call the R interpreter, the overhead of multiple process interactions is reduced. Hence, native scoring supports much faster prediction performance in enterprise production scenarios.

To generate scores using this library, you call the scoring function, and pass the following required inputs:

  • A compatible model. See the Requirements section for details.
  • Input data, typically defined as a SQL query

The function returns predictions for the input data, together with any columns of source data that you want to pass through.

For code samples, along with instructions on how to prepare the models in the required binary format, see this article:

For a complete solution that includes native scoring, see these samples from the SQL Server development team:


Supported platforms are as follows:

  • SQL Server 2017 Machine Learning Services (includes Microsoft R Server 9.1.0)

    Native scoring using PREDICT requires SQL Server 2017. It works on any version of SQL Server 2017, including Linux.

    You can also perform realtime scoring using sp_rxPredict. To use this stored procedure requires that you enable SQL Server CLR integration.

  • SQL Server 2016

    Realtime scoring using sp_rxPredict is possible with SQL Server 2016, and can also be run on Microsoft R Server. This option requires SQLCLR to be enabled, and that you install the Microsoft R Server upgrade. For more information, see Realtime scoring

Model preparation

  • The model must be trained in advance using one of the supported rx algorithms. For details, see Supported algorithms.
  • The model must be saved using the new serialization function provided in Microsoft R Server 9.1.0. The serialization function is optimized to support fast scoring.

Algorithms that support native scoring

If you need to use models from MicrosoftML, use realtime scoring with sp_rxPredict.


The following model types are not supported:

  • Models containing other, unsupported types of R transformations
  • Models using the rxGlm or rxNaiveBayes algorithms in RevoScaleR
  • PMML models
  • Models created using other R libraries from CRAN or other repositories
  • Models containing any other R transformation