Skip to content
TableR
FeaturesWorkflowAgentEnginesChangelogDocs
Download
/

Getting started

  • Introduction
  • Getting started

Guides

    • PostgreSQL
    • MySQL
    • MariaDB
    • CockroachDB
    • Greenplum
    • Amazon Redshift
    • SQL Server
    • Vertica
    • ClickHouse
    • Snowflake
    • BigQuery
    • SQLite
    • DuckDB
    • Cassandra
    • Redis
    • MongoDB
    • LibSQL
    • Cloudflare D1
    • Oracle (ORDS)
    • Amazon DynamoDB
    • Elasticsearch
    • OpenSearch
    • Google Spanner
    • Trino
    • SurrealDB
    • Weaviate
  • Plugins & drivers
  • SQL workspace
  • Exploring data
  • Visualize & diagrams
  • AI & Agent

Reference

  • Keyboard shortcuts
  • Architecture

Help

  • FAQ & support
Documentation/Trino

Trino

Connect TableR to a Trino coordinator over HTTP/HTTPS with a user, optional password, and a catalog.schema selection — via the trino-driver plugin.

Trino is reached through the coordinator's HTTP protocol — the connection is provided by the trino-driver plugin (install it from the plugins page). Provide the coordinator host, a user name, and select a catalog (or catalog.schema) as the database.

Overview

TableR speaks the Trino client protocol over HTTP/HTTPS (default port 8080). Every request carries X-Trino-User, so a user name is always sent (default tabler); a password adds HTTP Basic auth for secured coordinators. The database field selects the session catalog — or catalog.schema to pin a schema too.

  • Coordinator HTTP — connects to the coordinator on port 8080 (or 443/8443 over TLS).
  • X-Trino-User — every request carries the user; it defaults to tabler when left empty.
  • catalog[.schema] — the database field selects the session catalog and optional schema.
  • Plugin-gated — the Trino card appears once the trino-driver plugin is installed.

Before you start

  • The trino-driver plugin installed (Plugins → Trino → Install).
  • The coordinator host and port (default 8080).
  • A Trino user name (any string; defaults to tabler).
  • Optional: a password when the coordinator enforces basic auth (usually over TLS).
  • The catalog (or catalog.schema) to query, e.g. tpch.tiny.

Connection fields

These fields match TableR's Trino connection form. The password is stored in the operating system keyring, never in plain configuration files.

FieldRequiredDefaultNotes
HostYes—The Trino coordinator host.
PortNo8080The coordinator HTTP port; use 443/8443 with SSL/TLS.
UsernameNotablerSent as X-Trino-User on every request; defaults to tabler.
PasswordNo—Optional; adds HTTP Basic auth for secured coordinators. Stored in the OS keyring.
DatabaseNo—Session default as catalog or catalog.schema (e.g. tpch.tiny).
SSL/TLSNoOffEnable for HTTPS coordinators; required when basic auth is used.

Connect with the form

  1. 1
    Install the Trino plugin

    Open Plugins, find Trino, and install the trino-driver plugin.

  2. 2
    Choose Trino

    Open the launcher and pick the Trino card.

  3. 3
    Enter coordinator host and port

    Use your coordinator host and port (8080 for HTTP).

  4. 4
    Set the user

    Any user name works — it is sent as X-Trino-User; defaults to tabler.

  5. 5
    Pick a catalog

    Use the Database field for catalog or catalog.schema (e.g. tpch.tiny).

  6. 6
    Enable SSL/TLS + password (optional)

    Turn on TLS and add a password when the coordinator enforces basic auth.

  7. 7
    Save and connect

    Save the profile so it reappears in the launcher, then connect.

Verify the connection

Once connected, open a query tab and run SQL through the coordinator:

SELECT 1;
SHOW CATALOGS;

If both statements return, the coordinator, user, and credentials are all correct.

Troubleshooting

SymptomLikely causeFix
Trino card missingThe trino-driver plugin is not installed.Open Plugins and install the Trino driver, then retry.
Trino database must use 'catalog' or 'catalog.schema' formatThe database value has too many segments.Use catalog or catalog.schema — e.g. tpch or tpch.tiny.
Authentication failed (401)Coordinator requires basic auth or the password is wrong.Enable SSL/TLS and provide a valid password; it is saved to the keyring.
Connection refusedCoordinator down, wrong port, or a firewall.Confirm the coordinator is up and the HTTP port is reachable.
Catalog does not existThe selected catalog is not configured on the coordinator.Run SHOW CATALOGS or pick one from the database selector.

Next steps

SQL workspace

Write and run queries, manage tabs, and read results.

Exploring data

Browse schemas, tables, and columns, and search across databases.

All engines

Back to the connections overview and the full engine list.

PreviousGoogle SpannerNextSurrealDB
Was this page helpful?
Edit this page on GitHub
In this section
  • Overview
  • Before you start
  • Connection fields
  • Connect with the form
  • Verify the connection
  • Troubleshooting
  • Next steps