This repository provides the Harlequin adapter for WherobotsDB, using the Wherobots Spatial SQL API and its wherobots-python-dbapi-driver.
$ pip install harlequin-wherobots
Procure an API key from Wherobots, and start Harlequin with the required parameters:
$ harlequin -a wherobots --api-key <key>
Alternatively, you can use your session token:
$ harlequin -a wherobots --token <token>
The Harlequin adapter for Wherobots will automatically start a Wherobots
SQL session with the default runtime (Sedona, 4 executors) in the
default Wherobots public compute region (AWS us-west-2). You can
override those defaults with the --runtime and --region options,
respectively:
$ harlequin -a wherobots --api-key <key> --runtime NEW_YORK --region AWS_US_WEST_2
If your SQL session is already provisioned and running, you can force the driver to directly connect to it via its WebSocket URL (without protocol version):
$ harlequin -a wherobots --api-key <key> --ws-url <session-url>
You can also specify the base hostname of the Wherobots stack to
interact with as the first positional parameter. By default, the driver
connects to cloud.wherobots.com, the official public Wherobots
service.
$ harlequin -a wherobots --api-key <key> [host]