How trinodb/trino works
Trino is a distributed SQL analytics engine. A client submits SQL; the coordinator manages query execution, plans work into stages and schedules tasks across workers, which execute connector-backed reads or writes and return results. The graph also preserves catalog/connector access, query-session configuration, and execution statistics as distinct responsibilities. The README confirms CLI use and a broad plugin model; unsampled runtime branches are represented only where repository paths and documented capabilities support them. Source excerpts show scheduler and query-manager responsibilities, but do not expose the complete dispatch and result protocol.
Main entry points: QueryManager.java Query manager · PipelinedQueryScheduler.java Stage scheduler · StatementClientV1.java Client protocol · ConnectorServices.java Connector plugins
Components 20
Client access
- Command-line client
client/trino-cli/src/main/java/io/trino/cli/Trino.java - JDBC driver
client/trino-jdbc/src/main/java/io/trino/jdbc/TrinoDriver.java - Client protocol
client/trino-client/src/main/java/io/trino/client/StatementClientV1.java - Query results
client/trino-client/src/main/java/io/trino/client/QueryResults.java
Query coordination
- Trino server
- Query session
core/trino-main/src/main/java/io/trino/Session.java - Query manager
core/trino-main/src/main/java/io/trino/execution/QueryManager.java - SQL planning
core/trino-main/src/main/java/io/trino/sql/planner - Stage scheduler
core/trino-main/src/main/java/io/trino/execution/scheduler/PipelinedQueryScheduler.java
Distributed execution
- Worker tasks
core/trino-main/src/main/java/io/trino/execution - Operator pipelines
core/trino-main/src/main/java/io/trino/operator/PipelineContext.java - Distributed exchange
plugin/trino-exchange-filesystem/src/main/java/io/trino/plugin/exchange/filesystem/ExchangeStorageWriter.java
Data access
- Catalog management
core/trino-main/src/main/java/io/trino/connector/CoordinatorDynamicCatalogManager.java - Connector plugins
core/trino-main/src/main/java/io/trino/connector/ConnectorServices.java - BigQuery connector
plugin/trino-bigquery/src/main/java/io/trino/plugin/bigquery/BigQueryClient.java - Table metadata
lib/trino-metastore/src/main/java/io/trino/metastore/Storage.java
Runtime services
- Execution statistics
core/trino-main/src/main/java/io/trino/operator/PipelineContext.java - Connector type system
core/trino-spi/src/main/java/io/trino/spi/type/Type.java
Other components
- SQL user
- External data sources
Connections 21
- SQL user → Command-line client: submits SQL
- SQL user → JDBC driver: submits SQL
- Command-line client → Client protocol: runs queries
- JDBC driver → Client protocol: uses protocol
- Client protocol → Trino server: sends requests
- Trino server → Query manager: accepts queries
- Query manager → Query session: uses context
core/trino-main/src/main/java/io/trino/execution/QueryManager.java - Query manager → SQL planning: creates execution
core/trino-main/src/main/java/io/trino/execution/QueryManager.java - Query manager → Stage scheduler: manages execution
- Stage scheduler → Worker tasks: schedules tasks
core/trino-main/src/main/java/io/trino/execution/scheduler/PipelinedQueryScheduler.java - Worker tasks → Operator pipelines: runs operators
core/trino-main/src/main/java/io/trino/operator/PipelineContext.java - Operator pipelines → Execution statistics: aggregates metrics
core/trino-main/src/main/java/io/trino/operator/PipelineContext.java - Stage scheduler → Distributed exchange: coordinates exchange
- Stage scheduler → Catalog management: resolves catalogs
- Catalog management → Connector plugins: loads services
- Connector plugins → BigQuery connector: includes connector
- BigQuery connector → External data sources: accesses data
- Connector plugins → Table metadata: uses metadata
- BigQuery connector → Connector type system: maps types
plugin/trino-bigquery/src/main/java/io/trino/plugin/bigquery/BigQueryClient.java - Trino server → Query results: returns results
- Query results → Client protocol: decodes response