Example

This example Application demonstrates how to read Australian sensor values via a query statement against an Azure SQL Database using the Azure SQL Connector.

You can download the files here to try it out for yourself - adjusting the steps to use your own Azure SQL credentials.

Refer to configuration to understand all configuration options of this Connector.

Step 1: Add the Connection

From the Properties blade of the widget to which the Azure SQL Connector will be linked, a data grid in our example, select the Data Source tab.

Click the plus icon next to Data Source, then Connection, and select the Azure SQL Connector.

Fig 1: Add the Connection (Query Example)

Step 2: Configure Server

Enter a name for the connection and the authentication details: the Server Instance, User Name, and Password. In this case, tick to use variables and use SQL server authentication as a password is needed.

Fig 2: Configure Server (Query Example)

Step 3: Configure Database

Select the database, tick to specify a query, paste a query, and select the primary key.

In this case, select XCS Master, paste the query below, and select Id as the primary key.

select * from sensor_value where Region = 'Australia'

Fig 3: Configure Database (Query Example)

Step 4: Save

In this example, we are not using access control. Untick Access Control and click Save.

Refer to the data access configuration for more information.

Fig 4: Save (Query Example)

Step 5: Use the Connection

Select the Connection that was just created, select the entity to read, and enter the Data Source name.

In this case, set the name to Master Data, set the Connection to Master Data, and the entity to SQL Query. Save the Data Source.

Fig 5: Use the Connection (Query Example)

Step 6: Use the Data Source

Select the Data Source we just added, and save the Widget.

Fig 6: Use the Data Source (Query Example)

Step 7: Results

Click the Launch button and view the results. Observe that Australian sensor values are returned using a query statement against an entity in an Azure SQL database.

Fig 7: Results (Query Example)

Files

File	Link	Security Key
Application	Azure SQL Connector.xapp	C0mp|ex123

See the Import, Export, and Clone - XMPro article for steps to import an Application.