Querying with URQL

The uSmart Resource Query Language (URQL) enables you to query the data stored in uSmart in order to perform actions including downloading data, creating visualisations and aggregating data.

Querying data can be done

Within a dataset using the query builder

Within a dataset using the latest urql

Within a dataset when creating a visualisation using viz wiz

By connecting to a dataset via the USMART client SDK

Connection is done via the SDK and guidance can be found on the Discovery view of the dataset

It's easy to subscribe to a data stream with USMART. You just need a USMART client SDK and the information included on this page: organisation GUID and dataset GUID.

Use the organisation and dataset GUIDs to connect to the USMART real-time service. After that, it's all up to you. The code samples on this page show the subscription code for each supported client SDK. If you have not already done so, set up one of our client SDKs and get started.

Access GUIDs

The organisation publishing the dataset.
Organisation GUID Example: 9261083136-6c2b-4a26-a0a0-b903bde0dc46

The dataset you would like to subscribe to.
Dataset GUID Example: 2e887717-3c33-4d46-779167-95be307289a2

You may also need to include your user account and an API key to connect.

An example code and SDK is shown as follows:

Node.JS

Code

var usmartSDK = require('usmart-sdk');
var usmart = new usmartSDK.USMART({keyId: "<>", keySecret: "<>"});

var organisation = '28ccd497-7cad-4470-bd17-721d5cbbd6ef';
var dataset = 'da6c9979-4b41-4338-8cfe-012ea16d4bda';

usmart.subscribe(organisation, dataset).progress(function(data){
console.log(data.value);
});