Running a Magic 8-ball Python script in SQL Server big data cluster

About this sample
Before you begin
Run this sample
Sample details
Related links

About this sample

This is a sample Python app, which runs a Magic 8-Ball. This sample creates an app that adds requires a question as input and returns an answer to the question. The code for this sample is in magic8ball.py. The inputs and outputs are shown below.

Inputs

Parameter	Description
`txt`	The input question on which you would like answered

Outputs

Parameter	Description
`result`	The answer of the Magic 8-ball

Before you begin

To run this sample, you need the following prerequisites.

Software prerequisites:

SQL Server big data cluster CTP 2.3 or later.
azdata. Refer to installing azdata document on setting up the azdata and connecting to a SQL Server 2019 big data cluster.

Run this sample

Clone or download this sample on your computer.
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 and then return to this sample.
```
azdata login -e https://<ip-address-of-controller-svc-external>:30080 -u <user-name>
```
Deploy the application by running the following command, specifying the folder where your spec.yaml and magic8ball.py files are located:
```
azdata app create --spec ./magic8ball
```
Check the deployment by running the following command:
```
azdata app list -n magic8ball -v [version]
```
Once the app is listed as Ready you can continue to the next step.
Test the app by running the following command:
```
azdata app run -n magic8ball -v [version] --input txt="Will it rain tomorrow?"
```
You should get output like the example below. The answer to your question are returned as result.
```
{
  "changedFiles": [],
  "consoleOutput": "",
  "errorMessage": "",
  "outputFiles": {},
  "outputParameters": {
    "result": "You may rely on it"
  },
  "success": true
}
```
RESTful web service. Note that any app you create is also accessible using a RESTful web service that is Swagger compliant. See step 6 in the Addpy sample for detailed instructions on how to call the web service.

You can clean up the sample by running the following commands:

# delete app
azdata app delete --name magic8ball --version [version]

Sample details

Please refer to magic8ball.py for the code for this sample.

Spec file

Here is the spec file for this application. As you can see the sample uses the Python runtime and calls the magic8ball method in the magic8ball.py file, accepting a str input called txt (the question that you ask the Magic 8-ball) and returning a str output named result.

name: magic8ball
version: v2
runtime: Python
src: ./magic8ball.py
entrypoint: magic8ball
replicas: 1
poolsize: 1
inputs:
  txt: str
output:
  result: str

For more information, see these articles:

How to deploy and app on SQL Server 2019 big data cluster

3.9 KiB Raw Blame History