Quickstart

Import the SDK class and instantiate it passing your client name and API Key.

from knolariosdk import KnolarIOSDK

customer_name = 'demo-customer'
sdk_token = os.getenv('SDK_API_KEY')
sdk = KnolarIOSDK(customer_name, sdk_token)

Then you are ready to make some queries using the dataset methods

sql_query = 'Select * from "demo-dataset" limit 10'
results = sdk.dataset.sql_query(sql_query)

You will obtain an output like this

[
    {
        '__time': '2021-06-30T11:24:21.034Z', 
        'count': 1.0, 
        'tag': '01IJC.T1422.105',
        'value': 211.0
    }, 
    {
        '__time': '2021-06-30T11:24:51.472Z', 
        'count': 1.0,
        'tag': '01IJB.T1021.162',
        'value': 256.0
    }, 
    {
        '__time': '2021-06-30T11:53:18.909Z', 
        'count': 1.0, 
        'tag': '01ILB.T1063.163', 
        'value': 223.0
    }, 
    {
        '__time': '2021-06-30T11:53:18.909Z', 
        'count': 1.0, 
        'tag': '01ILB.T1286.141', 
        'value': 248.0
    }, 
    ...
]

sql_query() method is an easy and flexible way to explore your data, but there are more ways to query your data, you can explore them in dataset section.