Build a predictive model using R and SQL Server ML Services

Predictive modeling is a powerful way to add intelligence to your application. It enables applications to predict outcomes against new data. The act of incorporating predictive analytics into your applications involves two major phases: model training and model deployment

In this tutorial, you will learn how to create a predictive model in R and deploy it with SQL Server 2016 (and above) Machine Learning Services.

Here is a video that introduces in-database analytics and predictive modeling with R in SQL Server.

You can copy code as you follow this tutorial. All code is also available on GitHub

Step 1.1 Install SQL Server with in-database R / Machine Learning Services

1. If you don’t have SQL Server 2016 Developer (or above) installed:

*Click here to download the preview of SQL Server 2017

*Click here here to download the SQL Server 2016 exe (This version only supports R for Machine Learning)

1. Run it to start the SQL installer
2. Click Accept> after you have read the license terms
3. On the Feature Selection page, select: R Services (In-Database) for SQL Server 2016 or Machine Learning Services (In-Database) for SQL Server 2017
4. Don’t forget to choose R/Python or both
5. If you chose R: On the page, Consent to Install Microsoft R Open>, click Accept.
6. If you chose Python: On the page, Consent to Python>, click Accept.
7. Click Install to proceed with the installation

You now have SQL Server installed with in-database ML services, running locally on your Windows computer! Check out the next section to continue installing prerequisites.

Step 1.2 Install SQL Server Management Studio (SSMS)

Download and install SQL Server Management studio: SSMS

Now you have installed a tool you can use to easily manage your database objects and scripts.

Step 1.3 Enable external script execution

Run SSMS and open a new query window. Then execute the script below to enable your instance to run R scripts in SQL Server.

 EXEC sp_configure 'external scripts enabled', 1;
RECONFIGURE WITH OVERRIDE

You can read more about configuring Machine Learning Services here. Don’t forget to restart your SQL Server Instance after the configuration! You can restart in SSMS by right clicking on the instance name in the Object Explorer and choose Restart.

Optional: If you want, you can also download SSMS custom reports available on github. The report “R Services - Configuration.rdl” for example provides an overview of the R runtime parameters and gives you an option to configure your instance with a button click. To import a report in SSMS, right click on Server Objects in the SSMS Object Explorer and choose Reports -> Custom reports. Upload the .rdl file.

Now you have enabled external script execution so that you can run R code inside SQL Server!

Step 1.4 Install and configure your R development environment

1. You need to install an R IDE. Here are some suggestions:

*R Tools for Visual Studio (RTVS) Download

*RStudio Download

1. To be able to use some of the functions in this tutorial, you need to configure your R IDE to point to Microsoft R Client, which is an R Runtime provided by Microsoft. This runtime contains MS R Open packages.

Follow the steps 1 and 2 here to install R client and configure your R IDE tool.

Terrific, now your SQL Server instance is able to host and run R code and you have the necessary development tools installed and configured! The next section will walk you through creating a predictive model using R.