Skip to main content
To connect TextQL with your Trino instance, you will need to gather the following connection details:
  • Host and port
  • Catalog and schema
  • Authentication credentials (username & password, or access token)

​
Creating the Connector in TextQL

Navigate to the TextQL Connectors Page and click Create New Connector. Select Trino from the available connectors to open the configuration form. The form requires the following information:
  • Connector Name: A descriptive name to identify this Trino connection in TextQL.
  • Host: Your Trino server hostname (e.g., trino.example.com).
  • Port: The Trino port (default 8080 for HTTP, typically 443 for HTTPS).
  • Catalog: The Trino catalog to query against (e.g., hive, iceberg, tpch).
  • Schema: The schema within your catalog (optional).

​
Authentication

TextQL supports two authentication methods for Trino:
MethodWhen to use
Username & PasswordStandard Trino authentication
Access Token (JWT)Service accounts or token-based authentication
Select your authentication type from the dropdown and fill in the relevant credentials.

​
SSL Configuration

For secure connections, toggle SSL/TLS to enable HTTPS. This is required for most cloud-hosted Trino deployments.

​
Starburst Galaxy

To connect to Starburst Galaxy:
  • Host: <cluster>-<account>.trino.galaxy.starburst.io
  • Port: 443
  • SSL: Enabled
  • Username: Your Starburst email with role suffix (e.g., user@company.com/accountadmin)
  • Password: Your Starburst Galaxy password or service account password

​
Supported Deployments

TextQL supports the following Trino-compatible deployments:
  • Trino (open source)
  • Starburst Galaxy (see connection details above)
  • Starburst Enterprise (uses standard Trino connection fields)
  • Self-hosted Trino clusters

​
Testing the Connection

After entering your credentials, click Create to establish the connection. TextQL will validate your credentials and create the connector. If the connection fails, verify your host, port, SSL setting, and authentication details.
Having trouble connecting? See the Network Configuration Guide for firewall and IP whitelisting setup.

​
Next Steps

Once connected, you can use TextQL to query your Trino data. The connector supports querying across any catalog and schema accessible to your Trino user. For optimal performance and security:
  • Use a dedicated Trino user for TextQL connections
  • Specify a catalog and schema to limit data access scope
  • Enable SSL for production deployments