Skip to main content
Applications can use the Python client library to query StarTree Cloud.

Prerequisites

  1. Ensure you have the latest pinotdb library installed. To install the library, run the following command in your terminal:
  1. Obtain username and password for authentication
  2. Find your Pinot Broker URL

Usage

Query the Pinot Broker Directly

Use SQLAlchemy to Query Pinot

The db engine connection string is formatted like this: pinot://:?controller=://:/

Clone the Python pinot-dbapi Repository

Obtaining Username and Password

You can cenerate an API token in the Data Portal or using the REST API. Then, obtain the username and password from the service token Th username and password are used to authorize your API requests.

Finding Your Broker URL

To find the correct Broker URL for your table in StarTree Cloud:
  1. Access the Data Portal.
  2. Click on Tables.
  3. Select the specific table you want to query.
  4. From the browser address bar, copy the URL to your Pinot cluster. For example, if the URL shown is https://dp.1abcde6.cp.s7e.startree.cloud/tables, then the Broker URL for the table will be broker.pinot.1abcde6.cp.s7e.startree.cloud.