Skip to content

Commit 365a928

Browse files
committed
Merging changes synced from https://github.com/MicrosoftDocs/sql-docs-pr (branch live)
2 parents aee192a + 60739bc commit 365a928

30 files changed

+615
-832
lines changed

.openpublishing.redirection.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,16 @@
1010
"redirect_url": "/sql/relational-databases/polybase/polybase-guide",
1111
"redirect_document_id": false
1212
},
13+
{
14+
"source_path": "docs/advanced-analytics/tutorials/walkthrough-prepare-the-data.md",
15+
"redirect_url": "/sql/advanced-analytics/tutorials/demo-data-nyctaxi-in-sql",
16+
"redirect_document_id": false
17+
},
18+
{
19+
"source_path": "docs/advanced-analytics/tutorials/walkthrough-view-and-explore-the-data.md",
20+
"redirect_url": "/sql/advanced-analytics/tutorials/demo-data-nyctaxi-in-sql",
21+
"redirect_document_id": false
22+
},
1323
{
1424
"source_path": "docs/advanced-analytics/r/sqldev-train-and-save-a-model-using-t-sql.md",
1525
"redirect_url": "/sql/advanced-analytics/tutorials/sqldev-train-and-save-a-model-using-t-sql",

docs/advanced-analytics/python/setup-python-client-tools-sql.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,13 @@ manager: cgronlun
1515

1616
Python integration is available starting in SQL Server 2017 or later when you include the Python option in a [Machine Learning Services (In-Database) installation](../install/sql-machine-learning-services-windows-install.md).
1717

18-
To create and deploy Python solutions on SQL Server, install Microsoft's [revoscalepy](https://docs.microsoft.com/machine-learning-server/python-reference/revoscalepy/revoscalepy-package) and other Python libraries on the client workstation. The revoscalepy library, which is also on the remote SQL Server instance, coordinates computing requests between both systems.
18+
To develop and deploy Python solutions for SQL Server, install Microsoft's [revoscalepy](https://docs.microsoft.com/machine-learning-server/python-reference/revoscalepy/revoscalepy-package) and other Python libraries your development workstation. The revoscalepy library, which is also on the remote SQL Server instance, coordinates computing requests between both systems.
1919

20-
In this article, learn how to configure a Python development workstation so that you can connect to a remote SQL Server enabled for machine learning and Python integration. After completing the steps in this article, you will have the same Python libraries as those on SQL Server. You will also know how to push computations from a local Python session to a remote Python session on SQL Server.
20+
In this article, learn how to configure a Python development workstation so that you can interact with a remote SQL Server enabled for machine learning and Python integration. After completing the steps in this article, you will have the same Python libraries as those on SQL Server. You will also know how to push computations from a local Python session to a remote Python session on SQL Server.
2121

2222
![Client-server components](media/sqlmls-python-client-revo.png "Local and remote Python sessions and libraries")
2323

24-
You can use built-in Jupyter Notebooks as described in this article, or [link the libraries](#install-ide) to PyCharm or any another IDE that you normally use.
24+
To validate the installation, you can use built-in Jupyter Notebooks as described in this article, or [link the libraries](#install-ide) to PyCharm or any another IDE that you normally use.
2525

2626
> [!Tip]
2727
> For a video demonstration of these exercises, see [Run R and Python remotely in SQL Server from Jupyter Notebooks](https://blogs.msdn.microsoft.com/mlserver/2018/07/10/run-r-and-python-remotely-in-sql-server-from-jupyter-notebooks-or-any-ide/).

docs/advanced-analytics/r/set-up-a-data-science-client.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,13 @@ manager: cgronlun
1515

1616
R integration is available in SQL Server 2016 or later when you include the R language option in an [SQL Server 2016 R Services](../install/sql-r-services-windows-install.md) or [SQL Server 2017 Machine Learning Services (In-Database)](../install/sql-machine-learning-services-windows-install.md) installation.
1717

18-
To create and deploy R solutions on SQL Server, install [Microsoft R Client](https://docs.microsoft.com/machine-learning-server/r-client/what-is-microsoft-r-client) to get [RevoScaleR](https://docs.microsoft.com/machine-learning-server/r-reference/revoscaler/revoscaler) and other R libraries on your development workstation. The RevoScaleR library, which is also on the remote SQL Server instance, coordinates computing requests between both systems.
18+
To develop and deploy R solutions for SQL Server, install [Microsoft R Client](https://docs.microsoft.com/machine-learning-server/r-client/what-is-microsoft-r-client) on your development workstation to get [RevoScaleR](https://docs.microsoft.com/machine-learning-server/r-reference/revoscaler/revoscaler) and other R libraries. The RevoScaleR library, which is also required on the remote SQL Server instance, coordinates computing requests between both systems.
1919

20-
In this article, learn how to configure an R client development workstation so that you can connect to a remote SQL Server enabled for machine learning and R integration. After completing the steps in this article, you will have the same R libraries as those on SQL Server. You will also know how to push computations from a local R session to a remote R session on SQL Server.
20+
In this article, learn how to configure an R client development workstation so that you can interact with a remote SQL Server enabled for machine learning and R integration. After completing the steps in this article, you will have the same R libraries as those on SQL Server. You will also know how to push computations from a local R session to a remote R session on SQL Server.
2121

2222
![Client-server components](media/sqlmls-r-client-revo.png "Local and remote R sessions and libraries")
2323

24-
You can use built-in **RGUI** tool as described in this article, or [link the libraries](#install-ide) to RStudio or any another IDE that you normally use.
24+
To validate the installation, you can use built-in **RGUI** tool as described in this article, or [link the libraries](#install-ide) to RStudio or any another IDE that you normally use.
2525

2626
> [!Tip]
2727
> For a video demonstration of these exercises, see [Run R and Python remotely in SQL Server from Jupyter Notebooks](https://blogs.msdn.microsoft.com/mlserver/2018/07/10/run-r-and-python-remotely-in-sql-server-from-jupyter-notebooks-or-any-ide/).

docs/advanced-analytics/toc.yml

Lines changed: 15 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@
7070
- name: Tutorials
7171
href: tutorials/machine-learning-services-tutorials.md
7272
items:
73-
- name: Data
73+
- name: Sample data
7474
items:
7575
- name: Airline data set
7676
href: tutorials/demo-data-airlinedemo-in-sql.md
@@ -82,20 +82,20 @@
8282
href: tutorials/sql-server-python-tutorials.md
8383
items:
8484
- name: Train and use your first model
85-
href: tutorials/train-score-using-python-in-tsql.md
85+
href: tutorials/train-score-using-python-in-tsql.md
86+
- name: Create a Python model using revoscalepy
87+
href: tutorials/use-python-revoscalepy-to-create-model.md
8688
- name: Learn in-database analytics
8789
href: tutorials/sqldev-in-database-python-for-sql-developers.md
8890
items:
89-
- name: 1 - Visualize data
91+
- name: 1 - Data exploration
9092
href: tutorials/sqldev-py3-explore-and-visualize-the-data.md
91-
- name: 2 - Create data features
93+
- name: 2 - Feature engineering
9294
href: tutorials/sqldev-py4-create-data-features-using-t-sql.md
93-
- name: 3 - Train and save to SQL
95+
- name: 3 - Train and deploy
9496
href: tutorials/sqldev-py5-train-and-save-a-model-using-t-sql.md
95-
- name: 4 - Predict outcomes
97+
- name: 4 - Predictions
9698
href: tutorials/sqldev-py6-operationalize-the-model.md
97-
- name: Create a model using revoscalepy
98-
href: tutorials/use-python-revoscalepy-to-create-model.md
9999
- name: R
100100
href: tutorials/sql-server-r-tutorials.md
101101
items:
@@ -104,22 +104,18 @@
104104
- name: Learn in-database analytics
105105
href: tutorials/sqldev-in-database-r-for-sql-developers.md
106106
items:
107-
- name: 1 - Visualize data
107+
- name: 1 - Data exploration
108108
href: tutorials/sqldev-explore-and-visualize-the-data.md
109-
- name: 2 - Create data features
109+
- name: 2 - Feature engineering
110110
href: tutorials/sqldev-create-data-features-using-t-sql.md
111-
- name: 3 - Train and save to SQL
111+
- name: 3 - Train and deploy
112112
href: tutorials/sqldev-train-and-save-a-model-using-t-sql.md
113-
- name: 4 - Predict outcomes
113+
- name: 4 - Predictions
114114
href: tutorials/sqldev-operationalize-the-model.md
115-
- name: Data science end-to-end walkthrough
115+
- name: Data science walkthrough
116116
href: tutorials/walkthrough-data-science-end-to-end-walkthrough.md
117117
items:
118-
- name: Prepare data
119-
href: tutorials/walkthrough-prepare-the-data.md
120-
- name: Explore data using SQL
121-
href: tutorials/walkthrough-view-and-explore-the-data.md
122-
- name: Summarize data using R
118+
- name: Explore and summarize data
123119
href: tutorials/walkthrough-view-and-summarize-data-using-r.md
124120
- name: Create graphs and plots
125121
href: tutorials/walkthrough-create-graphs-and-plots-using-r.md
@@ -129,7 +125,7 @@
129125
href: tutorials/walkthrough-build-and-save-the-model.md
130126
- name: Deploy and use the model
131127
href: tutorials/walkthrough-deploy-and-use-the-model.md
132-
- name: Deep dive with RevoScaleR
128+
- name: RevoScaleR deep dive
133129
href: tutorials/deepdive-data-science-deep-dive-using-the-revoscaler-packages.md
134130
items:
135131
- name: Create database and permissions

docs/advanced-analytics/tutorials/deepdive-data-science-deep-dive-using-the-revoscaler-packages.md

Lines changed: 25 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: In this tutorial, learn how to call RevoScaleR function in SQL Serv
44
ms.prod: sql
55
ms.technology: machine-learning
66

7-
ms.date: 07/15/2018
7+
ms.date: 11/27/2018
88
ms.topic: tutorial
99
author: HeidiSteen
1010
ms.author: heidist
@@ -13,7 +13,7 @@ manager: cgronlun
1313
# Tutorial: Use RevoScaleR R functions with SQL Server data
1414
[!INCLUDE[appliesto-ss-xxxx-xxxx-xxx-md-winonly](../../includes/appliesto-ss-xxxx-xxxx-xxx-md-winonly.md)]
1515

16-
RevoScaleR is a Microsoft R package providing distributed and parallel processing for data science and machine learning workloads. For R development in SQL Server, RevoScaleR is one of the core built-in packages, with functions for setting a compute context, managing packages, and most importantly: working with data end-to-end, from import to visualization and analysis. Machine Learning algorithms in SQL Server have a dependency on RevoScaleR data sources. Given the importance of RevoScaleR, knowing when and how to call its functions is an essential skill.
16+
RevoScaleR is a Microsoft R package providing distributed and parallel processing for data science and machine learning workloads. For R development in SQL Server, RevoScaleR is one of the core built-in packages, with functions for creating data source objects, setting a compute context, managing packages, and most importantly: working with data end-to-end, from import to visualization and analysis. Machine Learning algorithms in SQL Server have a dependency on RevoScaleR data sources. Given the importance of RevoScaleR, knowing when and how to call its functions is an essential skill.
1717

1818
In this tutorial, you will learn how to create a remote compute context, move data between local and remote compute contexts, and execute R code on a remote SQL Server. You also learn how to analyze and plot data both locally and on the remote server, and how to create and deploy models.
1919

@@ -41,29 +41,34 @@ You should also be comfortable with [!INCLUDE[tsql](../../includes/tsql-md.md)]
4141
4242
## Prerequisites
4343

44-
- **SQL Server with support for R**
44+
+ [SQL Server 2017 Machine Learning Services](../install/sql-machine-learning-services-windows-install.md) with the R feature, or [SQL Server 2016 R Services (in-Database)](../install/sql-r-services-windows-install.md)
4545

46-
Install [SQL Server 2017 Machine Learning Services](../install/sql-machine-learning-services-windows-install.md) with the R feature, or install [SQL Server 2016 R Services (in-Database)](../install/sql-r-services-windows-install.md).
46+
+ [Database permissions](../security/user-permission.md) and a SQL Server database user login
4747

48-
Make sure external scripting is enabled, Launchpad service is running, and that you have permissions to access the service.
49-
50-
- **Database permissions**
51-
52-
To run the queries used to train the model, you must have **db_datareader** privileges on the database where the data is stored. To run R, your user must have the permission, EXECUTE ANY EXTERNAL SCRIPT.
48+
+ [SQL Server Management Studio](https://docs.microsoft.com/sql/ssms/download-sql-server-management-studio-ssms)
5349

54-
- **Data science development computer**
55-
56-
To switch back and forth between local and remote compute contexts, you need two systems. Local is typically a development workstation with sufficent power for data science workloads. Remote in this case is SQL Server 2017 or SQL Server 2016 with the R feature enabled.
57-
58-
Switching compute contexts is predicated on having the same-version RevoScaleR on both local and remote systems. On a local workstation, you can get the RevoScaleR packages and related providers by installing or using any one of the following: [Data Science VM on Azure](https://docs.microsoft.com/azure/machine-learning/data-science-virtual-machine/overview), [Microsoft R Client (free)](https://docs.microsoft.com/machine-learning-server/r-client/what-is-microsoft-r-client), or [Microsoft Machine Learning Server (Standalone)](https://docs.microsoft.com/machine-learning-server/install/machine-learning-server-install). For the standalone server option, install the free developer edition, using either Linux or Windows installers. You can also use SQL Server Setup to install a standalone server.
59-
60-
- **Additional R Packages**
50+
+ An IDE such as RStudio or the built-in RGUI tool included with R
51+
52+
To switch back and forth between local and remote compute contexts, you need two systems. Local is typically a development workstation with sufficent power for data science workloads. Remote in this case is SQL Server 2017 or SQL Server 2016 with the R feature enabled.
53+
54+
Switching compute contexts is predicated on having the same-version RevoScaleR on both local and remote systems. On a local workstation, you can get the RevoScaleR packages and related providers by installing Microsoft R Client.
55+
56+
If you need to put client and server on the same computer, be sure to install a second set of Microsoft R libraries for sending R script from a "remote" client. Do not use the R libraries that are installed in the program files of the SQL Server instance. Specifically, if you are using one computer, you need the RevoScaleR library in both of these locations to support client and server operations.
57+
58+
+ C:\Program Files\Microsoft\R Client\R_SERVER\library\RevoScaleR
59+
+ C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\R_SERVICES\library\RevoScaleR
60+
61+
For instructions on client configuration, see [Set up a data science client for R development](../r/set-up-a-data-science-client.md).
62+
63+
<a name="add-packages"></a>
64+
65+
## Additional R packages
6166

62-
In this tutorial, you install the following packages: **dplyr**, **ggplot2**, **ggthemes**, **reshape2**, and **e1071**. Instructions are provided as part of the tutorial.
67+
In this tutorial, you install the following packages: **dplyr**, **ggplot2**, **ggthemes**, **reshape2**, and **e1071**. Instructions are provided as part of the tutorial.
6368

64-
All packages must be installed in two places: on the workstation used for R solution development, and on the SQL Server computer where R scripts are executed. If you do not have permission to install packages on the server computer, ask an administrator.
65-
66-
**Do not install the packages to a user library.** The packages must be installed in the R package library that is used by the SQL Server instance.
69+
All packages must be installed in two places: on the workstation used for R solution development, and on the SQL Server computer where R scripts are executed. If you do not have permission to install packages on the server computer, ask an administrator.
70+
71+
**Do not install the packages to a user library.** The packages must be installed in the R package library that is used by the SQL Server instance.
6772

6873
## R development tools
6974

docs/advanced-analytics/tutorials/deepdive-work-with-sql-server-data-using-r.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: Work with SQL Server data using R (SQL and R deep dive)| Microsoft Docs
2+
title: Create a database and permissions (SQL and RevoScaleR deep dive)| Microsoft Docs
33
ms.prod: sql
44
ms.technology: machine-learning
55

6-
ms.date: 04/15/2018
6+
ms.date: 11/27/2018
77
ms.topic: tutorial
88
author: HeidiSteen
99
ms.author: heidist

0 commit comments

Comments
 (0)