tabulario/trino

Trino (Tabular runtime with Iceberg) 镜像文档

镜像概述

本镜像基于Trino构建，集成Tabular运行时并默认配置Iceberg，旨在简化Trino与Iceberg数据湖的集成部署。通过预配置Iceberg连接器，用户可直接使用Trino进行Iceberg表的查询、创建与管理，无需手动配置复杂依赖，实现开箱即用的大数据分析能力。

核心功能与特性

• Trino核心能力：支持分布式SQL查询，兼容ANSI SQL，可查询多种数据源（Hive、PostgreSQL、Kafka等）
• Tabular运行时集成：优化Trino性能，提供增强的查询执行与资源管理能力
• 默认Iceberg配置：预配置Iceberg连接器，支持Iceberg表的元数据管理、快照操作及时间旅行查询
• 轻量级部署：容器化封装，简化环境依赖，支持快速启动与水平扩展
• Web监控界面：内置Trino Web UI，可实时监控查询状态、集群性能与资源使用情况

使用场景与适用范围

• 数据湖分析：直接查询基于Iceberg的数据湖，支持复杂分析与聚合操作
• Iceberg表管理：创建、修改、删除Iceberg表，执行快照管理与数据维护
• 即席查询：为数据分析师提供快速SQL查询能力，无需复杂环境配置
• ETL流程集成：作为数据处理管道的查询引擎，对接上游数据摄取与下游数据消费
• 开发测试环境：快速搭建Trino+Iceberg开发环境，验证查询逻辑与数据处理流程

使用方法与配置说明

快速启动容器

通过docker run命令直接启动镜像：

bash
docker run -d -p 8080:8080 --name trino-iceberg tabular/trino:latest

• -p 8080:8080：映射Trino Web UI端口
• --name trino-iceberg：指定容器名称，便于后续管理

访问Trino Web UI

容器启动后，通过浏览器访问 http://localhost:8080 进入Trino Web UI，默认用户名为admin，可查看集群状态、查询历史与资源使用情况。

环境变量配置

通过环境变量自定义容器配置，常用参数如下：

示例：自定义内存与节点ID

bash
docker run -d -p 8080:8080 \
  -e TRINO_NODE_ID=trino-worker-1 \
  -e TRINO_MAX_MEMORY=16G \
  --name trino-iceberg tabular/trino:latest

Docker Compose部署

创建docker-compose.yml文件，配置Trino服务：

yaml
version: '3.8'
services:
  trino:
    image: tabular/trino:latest
    container_name: trino-iceberg
    ports:
      - "8080:8080"
    environment:
      - TRINO_NODE_ID=trino-primary
      - TRINO_MAX_MEMORY=16G
      - ICEBERG_CATALOG_NAME=my_iceberg
    volumes:
      - ./trino-config:/etc/trino  # 挂载自定义配置文件（可选）
    restart: unless-stopped

执行docker-compose up -d启动服务。

连接Trino CLI

通过容器内CLI工具连接Trino服务：

bash
# 进入容器
docker exec -it trino-iceberg bash

# 连接Trino（默认使用Iceberg目录）
trino --server localhost:8080 --catalog iceberg --schema default

成功连接后，可执行SQL命令操作Iceberg表，例如：

sql
-- 创建Iceberg表
CREATE TABLE iceberg.default.sample_table (
  id INT,
  name VARCHAR,
  ts TIMESTAMP
) WITH (
  format = 'PARQUET',
  location = '/tmp/iceberg/warehouse/sample_table'
);

-- 插入数据
INSERT INTO iceberg.default.sample_table VALUES (1, 'test', CURRENT_TIMESTAMP);

-- 查询数据
SELECT * FROM iceberg.default.sample_table;

自定义配置

如需修改Trino配置（如添加数据源、调整性能参数），可通过挂载配置目录实现：

1. 本地创建trino-config目录，包含config.properties、catalog/等配置文件
2. 启动容器时挂载该目录：-v ./trino-config:/etc/trino
3. 配置文件结构参考Trino官方文档，确保包含Iceberg连接器配置（默认已内置）