Home
Basic usage
Creating a new application with the 1010data Python SDK includes importing the library, establishing a session, submitting a query, receiving results, and cleaning up the session.
Running a query
Your application should act as an intermediary between your users and the platform to pass in a query and receive the queried data.

Basic usage
Creating a new application with the 1010data Python SDK includes importing the library, establishing a session, submitting a query, receiving results, and cleaning up the session.
- Setting up an application
  Your application setup includes importing any required libraries, including the 1010data Python SDK.
- Establishing a session
  A 1010data Insights Platform session is an instance of a particular user ID logged into the platform within a certain environment. A session is comprised of a dedicated set of resources that can serve a single request at a time.
- Running a query
  Your application should act as an intermediary between your users and the platform to pass in a query and receive the queried data.
- Accessing query results
  After querying the 1010data Insights Platform, your application receives a set of results, which is accessible through the Query object.
- Cleaning up a session
  If your application uses the with keyword, the 1010ata Insights Platform session is cleaned up automatically at the end of the with statement. If your application does not use with, you need to clean up the platform session when you've completed the transaction.

Running a query

Your application should act as an intermediary between your users and the platform to pass in a query and receive the queried data.

Gathering specific sets of data or scoping your data should occur within queries. Typically, the analytical work is done by the Macro Language query specified by the Query object. For more information on writing queries using the Insights Platform Macro Language see the 1010data Reference Manual.

In the example, the new Query object (exampleQuery) is created using the Query method which takes two parameters, the table path and the XML query. As a best practice, longer queries should be stored in a separate file.

You use the run method, which is part of the Query class, to run queries.

import py1010
import sys

gateway = "https://www2.1010data.com/cgi-bin/gw"
tablename = "pub.demo.weather.stations"
username = "[USER_NAME]"
password = "[PASSWORD]"

testSession = py1010.Session(gateway, username, password, py1010.POSSESS)
exampleQuery = testSession.query(tablename, '<sel value="(elev>10)"/>')
exampleQuery.run()

Note: [USER_NAME] and [PASSWORD] are placeholders for valid Insights Platform user name and password.