You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: samples/features/sql-big-data-cluster/app-deploy/README.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,10 +7,10 @@ Application deployment allows you to deploy applications into SQL Server big dat
7
7
8
8
## Pre-requisites
9
9
* SQL Server big data cluster CTP 2.3 or later
10
-
*`mssqlctl` CLI familiarity. If you are unfamiliar with `mssqlctl` please refer to - [App Deployment in SQL Server big data cluster](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps?view=sqlallproducts-allversions) for more information.
10
+
*`azdata` CLI familiarity. If you are unfamiliar with `azdata` please refer to - [App Deployment in SQL Server big data cluster](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps?view=sqlallproducts-allversions) for more information.
11
11
12
12
* Tip
13
-
**mssqlctl app -h** will display the various commands to manage the app
13
+
**azdata app -h** will display the various commands to manage the app
14
14
15
15
## Templates
16
16
Templates are used by our [App Deploy add-ins](https://docs.microsoft.com/en-us/sql/big-data-cluster/app-deployment-extension?view=sqlallproducts-allversions) and can be used to quickly deploy applications.
Copy file name to clipboardExpand all lines: samples/features/sql-big-data-cluster/app-deploy/RollDice/README.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ To run this sample, you need the following prerequisites.
34
34
**Software prerequisites:**
35
35
36
36
1. SQL Server big data cluster CTP 2.3 or later.
37
-
2.`mssqlctl`. Refer to [installing mssqlctl](https://docs.microsoft.com/en-us/sql/big-data-cluster/deploy-install-mssqlctl?view=sqlallproducts-allversions) document on setting up the `mssqlctl` and connecting to a SQL Server 2019 big data cluster.
37
+
2.`azdata`. Refer to [installing azdata](https://docs.microsoft.com/en-us/sql/big-data-cluster/deploy-install-azdata?view=sqlallproducts-allversions) document on setting up the `azdata` and connecting to a SQL Server 2019 big data cluster.
38
38
39
39
<aname=run-this-sample></a>
40
40
@@ -44,20 +44,20 @@ To run this sample, you need the following prerequisites.
44
44
2. Log in to the SQL Server big data cluster using the command below using the IP address of the `mgmtproxy-svc-external` in your cluster. If you are not familiar with `mssqltctl` you can refer to the [documentation](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps?view=sqlallproducts-allversions) and then return to this sample.
Copy file name to clipboardExpand all lines: samples/features/sql-big-data-cluster/app-deploy/SSIS/README.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -23,7 +23,7 @@ To run this sample, you need the following prerequisites.
23
23
**Software prerequisites:**
24
24
25
25
1. SQL Server big data cluster CTP 2.3 or later.
26
-
2.`mssqlctl`. Refer to [installing mssqlctl](https://docs.microsoft.com/en-us/sql/big-data-cluster/deploy-install-mssqlctl?view=sqlallproducts-allversions) document on setting up the `mssqlctl` and connecting to a SQL Server big data cluster.
26
+
2.`azdata`. Refer to [installing azdata](https://docs.microsoft.com/en-us/sql/big-data-cluster/deploy-install-azdata?view=sqlallproducts-allversions) document on setting up the `azdata` and connecting to a SQL Server big data cluster.
27
27
3. Optional: to see the SSIS package itself, install Visual Studio 2017 if you don't have it already. After that download and install [SSDT](https://docs.microsoft.com/en-us/sql/ssdt/download-sql-server-data-tools-ssdt?view=sql-server-2017#ssdt-for-vs-2017-standalone-installer).
28
28
4. Optional: install [SSMS](https://docs.microsoft.com/en-us/sql/ssms/download-sql-server-management-studio-ssms?view=sql-server-2017) if it is not already installed.
29
29
@@ -35,16 +35,16 @@ To run this sample, you need the following prerequisites.
35
35
2. Log in to the SQL Server big data cluster using the command below using the IP address of the `mgmtproxy-svc-external` in your cluster. If you are not familiar with `mssqltctl` you can refer to the [documentation](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps?view=sqlallproducts-allversions) and then return to this sample.
@@ -73,7 +73,7 @@ Here is the spec file for this application. This sample uses the `SSIS` runtime
73
73
|Setting|Description|
74
74
|-|-|
75
75
|options|Specifies any command line parameters passed to the execution of the SSIS package|
76
-
|schedule|Specifies when the job should run. This follows cron expressions. A value of '*/1 * * * *' means the job runs *every minute*. If omitted the package will not run automatically and you can run the package on demand using `mssqlctl run -n back-up-db -v [version]` or making a call to the API.|
76
+
|schedule|Specifies when the job should run. This follows cron expressions. A value of '*/1 * * * *' means the job runs *every minute*. If omitted the package will not run automatically and you can run the package on demand using `azdata run -n back-up-db -v [version]` or making a call to the API.|
Copy file name to clipboardExpand all lines: samples/features/sql-big-data-cluster/app-deploy/addpy/README.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -35,7 +35,7 @@ To run this sample, you need the following prerequisites.
35
35
**Software prerequisites:**
36
36
37
37
1. SQL Server big data cluster CTP 2.3 or later.
38
-
2.`mssqlctl`. Refer to [installing mssqlctl](https://docs.microsoft.com/en-us/sql/big-data-cluster/deploy-install-mssqlctl?view=sqlallproducts-allversions) document on setting up the `mssqlctl` and connecting to a SQL Server 2019 big data cluster.
38
+
2.`azdata`. Refer to [installing azdata](https://docs.microsoft.com/en-us/sql/big-data-cluster/deploy-install-azdata?view=sqlallproducts-allversions) document on setting up the `azdata` and connecting to a SQL Server 2019 big data cluster.
39
39
40
40
<aname=run-this-sample></a>
41
41
@@ -45,20 +45,20 @@ To run this sample, you need the following prerequisites.
45
45
2. Log in to the SQL Server big data cluster using the command below using the IP address of the `mgmtproxy-svc-external` in your cluster. If you are not familiar with `mssqltctl` you can refer to the [documentation](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps?view=sqlallproducts-allversions) and then return to this sample.
3. Deploy the application by running the following command, specifying the folder where your `spec.yaml` and `add.py` files are located:
51
51
```bash
52
-
mssqlctl app create --spec ./addpy
52
+
azdata app create --spec ./addpy
53
53
```
54
54
4. Check the deployment by running the following command:
55
55
```bash
56
-
mssqlctl app list -n addpy -v [version]
56
+
azdata app list -n addpy -v [version]
57
57
```
58
58
Once the app is listed as `Ready` you can continue to the next step.
59
59
5. Test the app by running the following command:
60
60
```bash
61
-
mssqlctl app run -n addpy -v [version] --input x=3,y=5
61
+
azdata app run -n addpy -v [version] --input x=3,y=5
62
62
```
63
63
You should get output like the example below. The result of adding 3+5 are returned as `result`.
64
64
```json
@@ -75,7 +75,7 @@ To run this sample, you need the following prerequisites.
75
75
```
76
76
6. <a name=restapi></a>Any app you create is also accessible using a RESTful web service that is [Swagger](swagger.io) compliant. You can get the endpoint for the web service by running:
This will return an output much like the following:
81
81
```json
@@ -106,28 +106,28 @@ To run this sample, you need the following prerequisites.
106
106
}
107
107
```
108
108
Note the IP address and the port number in this output. Open the following URL in your browser:
109
-
`https://[IP]:[PORT]/api/docs/swagger.json`. You will have to log in with the same credentials you used for`mssqlctl login`. The contents of the `swagger.json` you can paste into [Swagger Editor](https://editor.swagger.io) to understand what methods are available:
109
+
`https://[IP]:[PORT]/api/docs/swagger.json`. You will have to log in with the same credentials you used for`azdata login`. The contents of the `swagger.json` you can paste into [Swagger Editor](https://editor.swagger.io) to understand what methods are available:
110
110

111
111
112
112
Notice the `app` GET method as well as the `token` POST method. Since the authentication forapps uses JWT tokens you will need to get a token my using your favorite tool to make a POST call to the `token` method. Here is an example of how to do just thatin [Postman](https://www.getpostman.com/):
113
113

114
114
115
115
The result of this request will give you an `access_token`, which you will need to call the URL to run the app.
116
116
117
-
>*Optional*: If you want, you can open the URL forthe `swagger` that was returned when you ran `mssqlctl app describe --name addpy --version [version]`in your browser. You will have to log in with the same credentials you used for`mssqlctl login`. The contents of the `swagger.json` you can paste into [Swagger Editor](https://editor.swagger.io). You will see that the web service exposes the `run` method.
117
+
>*Optional*: If you want, you can open the URL forthe `swagger` that was returned when you ran `azdata app describe --name addpy --version [version]`in your browser. You will have to log in with the same credentials you used for`azdata login`. The contents of the `swagger.json` you can paste into [Swagger Editor](https://editor.swagger.io). You will see that the web service exposes the `run` method.
118
118
119
119
You can use your favorite tool to call the `run` method (`https://[IP]:30778/api/app/addpy/[version]/run`), passing in the parameters in the body of your POST request as json. In this example we will use [Postman](https://www.getpostman.com/). Before making the call, you will need to set the `Authorization` to `Bearer Token` and paste in the token you retrieved earlier. This will set a header on your request. See the screenshot below.
120
120

121
121
Next, in the requests body, pass in the parameters to the app you are calling and set the `content-type` to `application/json`:
122
122

123
-
When you send the request, you will get the same output as you did when you ran the app through `mssqlctl app run`:
123
+
When you send the request, you will get the same output as you did when you ran the app through `azdata app run`:
124
124

125
125
You have now successfully called the app through the web service!
126
126
127
127
7. You can clean up the sample by running the following commands:
Copy file name to clipboardExpand all lines: samples/features/sql-big-data-cluster/app-deploy/magic8ball/README.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,7 +34,7 @@ To run this sample, you need the following prerequisites.
34
34
**Software prerequisites:**
35
35
36
36
1. SQL Server big data cluster CTP 2.3 or later.
37
-
2.`mssqlctl`. Refer to [installing mssqlctl](https://docs.microsoft.com/en-us/sql/big-data-cluster/deploy-install-mssqlctl?view=sqlallproducts-allversions) document on setting up the `mssqlctl` and connecting to a SQL Server 2019 big data cluster.
37
+
2.`azdata`. Refer to [installing azdata](https://docs.microsoft.com/en-us/sql/big-data-cluster/deploy-install-azdata?view=sqlallproducts-allversions) document on setting up the `azdata` and connecting to a SQL Server 2019 big data cluster.
38
38
39
39
<aname=run-this-sample></a>
40
40
@@ -44,20 +44,20 @@ To run this sample, you need the following prerequisites.
44
44
2. Log in to the SQL Server big data cluster using the command below using the IP address of the `mgmtproxy-svc-external` in your cluster. If you are not familiar with `mssqltctl` you can refer to the [documentation](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps?view=sqlallproducts-allversions) and then return to this sample.
Copy file name to clipboardExpand all lines: samples/features/sql-big-data-cluster/app-deploy/mleap/README.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -31,7 +31,7 @@ To run this sample, you need the following prerequisites.
31
31
**Software prerequisites:**
32
32
33
33
1. SQL Server big data cluster CTP 2.3 or later.
34
-
2.`mssqlctl`. Refer to [installing mssqlctl](https://docs.microsoft.com/en-us/sql/big-data-cluster/deploy-install-mssqlctl?view=sqlallproducts-allversions) document on setting up the `mssqlctl` and connecting to a SQL Server 2019 big data cluster.
34
+
2.`azdata`. Refer to [installing azdata](https://docs.microsoft.com/en-us/sql/big-data-cluster/deploy-install-azdata?view=sqlallproducts-allversions) document on setting up the `azdata` and connecting to a SQL Server 2019 big data cluster.
35
35
36
36
<aname=run-this-sample></a>
37
37
@@ -41,25 +41,25 @@ To run this sample, you need the following prerequisites.
41
41
2. Log in to the SQL Server big data cluster using the command below using the IP address of the `mgmtproxy-svc-external` in your cluster. If you are not familiar with `mssqltctl` you can refer to the [documentation](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps?view=sqlallproducts-allversions) and then return to this sample.
3. This example uses a TensorFlow Machine Learning Model that uses public US Census data predict income. [More details and information on the example are here](https://docs.microsoft.com/en-us/sql/big-data-cluster/train-and-create-machinelearning-models-with-spark?view=sqlallproducts-allversions). The application you will be deploying as part of this sample is a Random Forest Model that was built in Spark and has been [serialized as an MLeap bundle](https://docs.microsoft.com/en-us/sql/big-data-cluster/export-model-with-spark-mleap?view=sqlallproducts-allversions).
47
47
48
48
Deploy the app using the `create` command and pass the location of the spec file. In the example below, the spec file is expected to be in the `mleap` folder:
49
49
```bash
50
-
mssqlctl app create --spec ./mleap/
50
+
azdata app create --spec ./mleap/
51
51
```
52
52
1. Check the deployment by running the following command:
53
53
```bash
54
-
mssqlctl app list -n mleap-census -v [version]
54
+
azdata app list -n mleap-census -v [version]
55
55
```
56
56
Once the app is listed as `Ready` you can continue to the next step.
57
57
2. Now that the app has been deployed you can test if the app works correctly by passing in a sample input that is available in the `mleap` folder. The deployed app is a RESTful webservice that is [Swagger](swagger.io) compliant. For this sample we will show you how you can test this using the CLI.
58
58
59
59
To test the app, run the command below. The input parameter is a `MLeapFrame`, a `json` file that describes the parameters and the values provided to the model for predicting income. Note that the input parameter has a special character '@' to indicate that a `json` file is being passed. This command needs to be run within the `mleap` folder.
60
60
61
61
```bash
62
-
mssqlctl app run --name mleap-census --version [version] --input schema=@census_frame.json
62
+
azdata app run --name mleap-census --version [version] --input schema=@census_frame.json
63
63
```
64
64
65
65
The result will be a json output that includes the predicted income along with additional data.
@@ -69,7 +69,7 @@ To run this sample, you need the following prerequisites.
69
69
6. You can clean up the sample by running the following commands:
0 commit comments