Merge pull request #10 from microsoft/master

merge from master

Author: Melony QIN

samples/features/high availability/Kubernetes/readme.md

@@ -2,11 +2,3 @@
 
 
 Availability Groups on SQL Server Containers was provided during SQL Server 2019 preview releases to demonstrate a potential capability. SQL Server 2019 does not support Availability Groups on containers.
-
-Go to the documentation to learn more about:
-
-[Always On Availability Groups for SQL Server containers](https://docs.microsoft.com/en-us/sql/linux/sql-server-ag-kubernetes)
-
-[Deploy a SQL Server Always On Availability Group on Kubernetes Cluster](https://docs.microsoft.com/en-us/sql/linux/sql-server-linux-kubernetes-deploy) 
-
-[Create deployment script for SQL Server Always On Availability Group](https://docs.microsoft.com/en-us/sql/linux/sql-server-linux-kubernetes-create-deployment) 

samples/features/query-store/PropertyMLS.bacpac

@@ -1,19 +1,19 @@
 # Application deployment on SQL Server big data cluster
 
 ## Build more intelligent apps
-Application deployment allows you to deploy applications into SQL Server big data cluster as containers. These apps are hosted for you and exposed as Swagger compliant web services for usage in your application. The apps you deploy have access to the data stored in the big data cluster and can be monitored easily. For more information, see [How to deploy and app on SQL Server 2019 big data cluster (preview)](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps?view=sqlallproducts-allversions). This page provides a number of samples for different technology stacks.
+Application deployment allows you to deploy applications into SQL Server big data cluster as containers. These apps are hosted for you and exposed as Swagger compliant web services for usage in your application. The apps you deploy have access to the data stored in the big data cluster and can be monitored easily. For more information, see [How to deploy and app on SQL Server 2019 big data cluster](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps). This page provides a number of samples for different technology stacks.
 
 ![Appdeploy](Appdeploy.PNG)
 
 ## Pre-requisites
 * SQL Server big data cluster CTP 2.3 or later
-* `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.
+* `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) for more information.
 
 * Tip 
 **azdata app -h** will display the various commands to manage the app
 
 ## Templates
-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.
+Templates are used by our [App Deploy add-ins](https://docs.microsoft.com/en-us/sql/big-data-cluster/app-deployment-extension) and can be used to quickly deploy applications.
 > Looking for our templates? See [the SQLBDC-AppDeploy repo](https://github.com/Microsoft/SQLBDC-AppDeploy).
 
 ## Available samples
@@ -53,4 +53,4 @@ These samples demonstrates how you can deploy a simple R app into SQL Server big
 ## Related Links
 For more information, see these articles:
 
-[How to deploy and app on SQL Server 2019 big data cluster (preview)](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps?view=sqlallproducts-allversions)
+[How to deploy and app on SQL Server 2019 big data cluster](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps)

samples/features/sql-big-data-cluster/app-deploy/README.md

@@ -41,7 +41,7 @@ To run this sample, you need the following prerequisites.
 ## Run this sample
 
 1. Clone or download this sample on your computer.
-2. Log in to the SQL Server big data cluster using the command below using the IP address of the `controller-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.
+2. Log in to the SQL Server big data cluster using the command below using the IP address of the `controller-svc-external` in your cluster. If you are not familiar with `azdata` 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.
 
     ```bash
     azdata login -e https://<ip-address-of-controller-svc-external>:30080 -u <user-name> -p <password>
@@ -119,4 +119,4 @@ output:
 ## Related Links
 For more information, see these articles:
 
-[How to deploy and app on SQL Server 2019 big data cluster (preview)](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps?view=sqlallproducts-allversions)
+[How to deploy and app on SQL Server 2019 big data cluster](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps)

samples/features/sql-big-data-cluster/app-deploy/RollDice/README.md

@@ -32,7 +32,7 @@ To run this sample, you need the following prerequisites.
 ## Run this sample
 
 1. Clone or download this sample on your computer.
-2. Log in to the SQL Server big data cluster using the command below using the IP address of the `controller-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.
+2. Log in to the SQL Server big data cluster using the command below using the IP address of the `controller-svc-external` in your cluster. If you are not familiar with `azdata` 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.
 
     ```bash
     azdata login -e https://<ip-address-of-controller-svc-external>:30080 -u <user-name>
@@ -49,7 +49,7 @@ To run this sample, you need the following prerequisites.
     Once the app is listed as `Ready` the job should run within a minute.
     You can check if the backup is created by running:
     ```bash
-    kubectl -n [your namespace] exec -it mssql-master-pool-0 -c mssql-server -- /bin/bash -c "ls /var/opt/mssql/data/*.DWConfigbak"
+    kubectl -n [your namespace] exec -it master-0 -c mssql-server -- /bin/bash -c "ls /var/opt/mssql/data/*.DWConfigbak"
     ```
     You should see a backup being created for every run of the job, with a maximum of 60 backups since the SSIS package cleans up backups older than one hour.
     You can use any of the `.DWConfigbak` files to restore the database.
@@ -80,7 +80,7 @@ name: back-up-db
 version: v1
 runtime: SSIS
 entrypoint: ./back-up-db.dtsx
-options: /REP V /CONN "MasterSQL"\;"\"Data Source=service-master-pool;User ID=sa;Initial Catalog=master;Password=[SA_PASSWORD]\""
+options: /REP V /CONN "MasterSQL"\;"\"Data Source=master-svc;User ID=sa;Initial Catalog=master;Password=[SA_PASSWORD]\""
 schedule: "*/1 * * * *"
 ```
 
@@ -89,4 +89,4 @@ schedule: "*/1 * * * *"
 ## Related Links
 For more information, see these articles:
 
-[How to deploy and app on SQL Server 2019 big data cluster (preview)](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps?view=sqlallproducts-allversions)
+[How to deploy and app on SQL Server 2019 big data cluster](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps)

samples/features/sql-big-data-cluster/app-deploy/SSIS/README.md

@@ -2,5 +2,5 @@ name: back-up-db
 version: v1
 runtime: SSIS
 entrypoint: ./back-up-db.dtsx
-options: /REP V /CONN "MasterSQL"\;"\"Data Source=master-0;User ID=sa;Initial Catalog=master;Password=[SA_PASSWORD]\""
+options: /REP V /CONN "MasterSQL"\;"\"Data Source=master-svc;User ID=sa;Initial Catalog=master;Password=[SA_PASSWORD]\""
 schedule: "*/1 * * * *"

samples/features/sql-big-data-cluster/app-deploy/SSIS/spec.yaml

@@ -35,14 +35,14 @@ To run this sample, you need the following prerequisites.
 **Software prerequisites:**
 
 1. SQL Server big data cluster CTP 2.3 or later.
-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.
+2. `azdata`. Refer to [installing azdata](https://docs.microsoft.com/en-us/sql/big-data-cluster/deploy-install-azdata) document on setting up the `azdata` and connecting to a SQL Server 2019 big data cluster.
 
 <a name=run-this-sample></a>
 
 ## Run this sample
 
 1. Clone or download this sample on your computer.
-2. Log in to the SQL Server big data cluster using the command below using the IP address of the `controller-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.
+2. Log in to the SQL Server big data cluster using the command below using the IP address of the `controller-svc-external` in your cluster. If you are not familiar with `azdata` you can refer to the [documentation](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps) and then return to this sample.
 
     ```bash
     azdata login -e https://<ip-address-of-controller-svc-external>:30080 -u <user-name>
@@ -73,56 +73,7 @@ To run this sample, you need the following prerequisites.
       "success": true
     }
     ```
-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:
-   ```bash
-   azdata app describe --name addpy --version [version]
-   ```
-   This will return an output much like the following:
-   ```json
-   {
-      "input_param_defs": [
-        {
-          "name": "x",
-          "type": "int"
-        },
-        {
-          "name": "y",
-          "type": "int"
-        }
-      ],
-      "links": {
-        "app": "https://[IP]:[PORT]/api/app/addpy/[version]",
-        "swagger": "https://[IP]:[PORT]/api/app/addpy/[version]/swagger.json"
-      },
-      "name": "addpy",
-      "output_param_defs": [
-        {
-          "name": "result",
-          "type": "int"
-        }
-      ],
-      "state": "Ready",
-      "version": "[version]"
-    }
-   ```
-   Note the IP address and the port number in this output. Open the following URL in your browser:
-   `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:
-   ![API Swagger](api_swagger.png)
-
-   Notice the `app` GET method as well as the `token` POST method. Since the authentication for apps 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 that in [Postman](https://www.getpostman.com/):
-   ![Postman Token](postman_token.png)
-
-   The result of this request will give you an `access_token`, which you will need to call the URL to run the app.
-   
-   > *Optional*: If you want, you can open the URL for the `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.
-
-   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.
-   ![Postman Run Headers](postman_run_1.png)
-   Next, in the requests body, pass in the parameters to the app you are calling and set the `content-type` to `application/json`:
-   ![Postman Run Body](postman_run_2.png)
-   When you send the request, you will get the same output as you did when you ran the app through `azdata app run`:
-   ![Postman Run Result](postman_result.png)
-   You have now successfully called the app through the web service!
+6. <a name=restapi></a>Any app you create is also accessible using a RESTful web service that is [Swagger](swagger.io) compliant. See: [Consume an app deployed on SQL Server Big Data Clusters using a RESTful web service](https://docs.microsoft.com/en-us/sql/big-data-cluster/app-consume).
 
 7. You can clean up the sample by running the following commands:
     ```bash
@@ -159,4 +110,4 @@ output:
 ## Related Links
 For more information, see these articles:
 
-[How to deploy and app on SQL Server 2019 big data cluster (preview)](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps?view=sqlallproducts-allversions)
+[How to deploy and app on SQL Server 2019 big data cluster](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps)

samples/features/sql-big-data-cluster/app-deploy/addpy/README.md

@@ -41,7 +41,7 @@ To run this sample, you need the following prerequisites.
 ## Run this sample
 
 1. Clone or download this sample on your computer.
-2. Log in to the SQL Server big data cluster using the command below using the IP address of the `controller-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.
+2. Log in to the SQL Server big data cluster using the command below using the IP address of the `controller-svc-external` in your cluster. If you are not familiar with `azdata` 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.
 
     ```bash
     azdata login -e https://<ip-address-of-controller-svc-external>:30080 -u <user-name>
@@ -109,4 +109,4 @@ output:
 ## Related Links
 For more information, see these articles:
 
-[How to deploy and app on SQL Server 2019 big data cluster (preview)](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps?view=sqlallproducts-allversions)
+[How to deploy and app on SQL Server 2019 big data cluster](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps)

samples/features/sql-big-data-cluster/app-deploy/magic8ball/README.md

@@ -38,7 +38,7 @@ To run this sample, you need the following prerequisites.
 ## Run this sample
 
 1. Clone or download this sample on your computer.
-2. Log in to the SQL Server big data cluster using the command below using the IP address of the `controller-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.
+2. Log in to the SQL Server big data cluster using the command below using the IP address of the `controller-svc-external` in your cluster. If you are not familiar with `azdata` 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.
 
    ```bash
    azdata login -e https://<ip-address-of-controller-svc-external>:30080 -u <user-name>

samples/features/sql-big-data-cluster/app-deploy/mleap/README.md

@@ -42,7 +42,7 @@ To run this sample, you need the following prerequisites.
 ## Run this sample
 
 1. Clone or download this sample on your computer.
-2. Log in to the SQL Server big data cluster using the command below using the IP address of the `controller-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.
+2. Log in to the SQL Server big data cluster using the command below using the IP address of the `controller-svc-external` in your cluster. If you are not familiar with `azdata` 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.
 
     ```bash
     azdata login -e https://<ip-address-of-controller-svc-external>:30080 -u <user-name>
@@ -120,4 +120,4 @@ output:
 ## Related Links
 For more information, see these articles:
 
-[How to deploy and app on SQL Server 2019 big data cluster (preview)](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps?view=sqlallproducts-allversions)
+[How to deploy and app on SQL Server 2019 big data cluster](https://docs.microsoft.com/en-us/sql/big-data-cluster/big-data-cluster-create-apps)