docs: README 支持 11 种语言
|
# NewLife.Presto — Presto/Trino ADO.NET 驱动
[](https://github.com/NewLifeX/NewLife.Presto/actions/workflows/aot.yml)




[](https://github.com/NewLifeX/NewLife.Presto/actions/workflows/test.yml)
[](/NewLife/NewLife.Presto/Blob/master/Doc/多语言本地化.md)


[](https://github.com/NewLifeX/NewLife.Presto/graphs/contributors)
<!-- lang:start -->
🌐 [English](/NewLife/NewLife.Presto/Blob/master/README.md) | [繁體中文](/NewLife/NewLife.Presto/Blob/master/README.zh-TW.md) | [Español](/NewLife/NewLife.Presto/Blob/master/README.es.md) | [Deutsch](/NewLife/NewLife.Presto/Blob/master/README.de.md) | [日本語](/NewLife/NewLife.Presto/Blob/master/README.ja.md) | [Français](/NewLife/NewLife.Presto/Blob/master/README.fr.md) | [Português](/NewLife/NewLife.Presto/Blob/master/README.pt.md) | [Русский](/NewLife/NewLife.Presto/Blob/master/README.ru.md) | [한국어](/NewLife/NewLife.Presto/Blob/master/README.ko.md) | [العربية](/NewLife/NewLife.Presto/Blob/master/README.ar.md)
<!-- lang:end -->
**NewLife.Presto** 是新生命开发团队出品的纯 C# PrestoDB / Trino ADO.NET 驱动。它使用官方 HTTP REST v1 客户端协议,仅依赖 `NewLife.Core`,**零第三方依赖**,内置 **33 种运行时语言**,目标框架覆盖 `net45` ~ `net11`,`net8.0+` **支持 NativeAOT**。PrestoDB 与 Trino 共用一个包,通过 `Protocol=Trino`(或 `TrinoHeaders=true`)切换请求头。
> **项目状态**:设计与脚手架阶段。离线基础组件已实现并通过测试(连接字符串、协议头、类型映射、多语言、AOT 冒烟);网络与查询执行进度见[功能清单](/NewLife/NewLife.Presto/Blob/master/Doc/功能清单.md)。
**目录**: [快速开始](/NewLife/NewLife.Presto/Blob/master/#快速开始) · [为什么选择 NewLife.Presto](/NewLife/NewLife.Presto/Blob/master/#为什么选择-newlifepresto) · [主要功能](/NewLife/NewLife.Presto/Blob/master/#主要功能) · [平台支持](/NewLife/NewLife.Presto/Blob/master/#平台支持) · [多语言](/NewLife/NewLife.Presto/Blob/master/#多语言) · [文档](/NewLife/NewLife.Presto/Blob/master/#文档) · [参与贡献](/NewLife/NewLife.Presto/Blob/master/#参与贡献) · [生态版图](/NewLife/NewLife.Presto/Blob/master/#生态版图) · [新生命开发团队](/NewLife/NewLife.Presto/Blob/master/#新生命开发团队) · [许可证](/NewLife/NewLife.Presto/Blob/master/#许可证)
---
## 快速开始
```bash
dotnet build NewLife.Presto.slnx -c Release
dotnet test UnitTest/UnitTest.csproj -c Release
dotnet run --project AotSmoke/AotSmoke.csproj -c Release -- --no-db
```
```text
Host=localhost;Port=8080;Catalog=hive;Schema=default;User=test;Password=xxx
```
```csharp
using NewLife.Presto;
using var conn = new PrestoConnection(
"Host=localhost;Port=8080;Catalog=hive;Schema=default;User=test;Password=xxx");
await conn.OpenAsync();
using var cmd = conn.CreateCommand();
cmd.CommandText = "select count(*) from tpch.tiny.nation where nationkey > @minKey";
cmd.Parameters.Add(new PrestoParameter("@minKey", 0));
var count = await cmd.ExecuteScalarAsync();
```
---
## 为什么选择 NewLife.Presto
- **一个包同时支持 PrestoDB 与 Trino**:共用同一套协议实现,通过配置选择 `X-Presto-*` / `X-Trino-*` 请求头。
- **XCode 优先**:工厂、连接串别名、`@` 参数、元数据与能力边界围绕 XCode 的 Presto 模型设计。
- **零第三方依赖**:只依赖 `NewLife.Core`;JSON、HTTP 与日志来自 BCL 或 NewLife 技术栈。
- **全框架、全平台**:`net45` ~ `net11`,Windows / Linux / macOS,x64 / arm64,并提供 LoongArch64 与 musl 观察期构建。
- **33 种运行时语言**:异常、日志与驱动元数据均已本地化,英文为源文与兜底。
- **NativeAOT 就绪**:协议与类型编解码不使用运行时反射;各支持平台均运行 NativeAOT 冒烟。
## 主要功能
<details>
<summary><b>连接与协议</b>(6 项)</summary>
| 功能点 | 一句话特点 |
|--------|------------|
| 连接字符串别名 | `Host`/`Server`/`Data Source`、`Catalog`/`Database`、`Schema`/`Owner` 与 XCode 写法兼容 |
| PrestoDB / Trino 双协议头 | 默认 `Protocol=Presto`;Trino 351+ 用 `Protocol=Trino` 或 `TrinoHeaders=true` |
| 会话上下文 | Catalog、Schema、用户、来源、时区、会话属性与自定义请求头 |
| 认证 | Basic、JWT/Bearer 与网关自定义头,敏感信息不写日志 |
| TLS 与代理 | 默认严格校验证书;私有 CA 需显式放宽 |
| 共享 HTTP 传输 | 按端点复用 `HttpClient`,支持代理、压缩与超时 |
</details>
<details>
<summary><b>查询与类型</b>(6 项)</summary>
| 功能点 | 一句话特点 |
|--------|------------|
| 语句生命周期 | `POST /v1/statement`、`nextUri` 轮询与完成判定 |
| 前向兼容状态 | 状态按字符串保存,服务端新增状态不会破坏解析 |
| 瞬态重试 | 429/502/503/504,按 `Retry-After` 或指数退避 |
| `@name` 参数 | 客户端替换,跳过字符串、标识符与注释 |
| 类型保真 | 布尔、整数、decimal、日期时间、timestamp with time zone、UUID、IP 与二进制 |
| 复杂类型 | 首版将 `array`/`map`/`row`/`json` 返回为原始字符串 |
</details>
<details>
<summary><b>集成与诊断</b>(6 项)</summary>
| 功能点 | 一句话特点 |
|--------|------------|
| `GetSchema` | `MetaDataCollections`、`Tables`、`Columns`、`DataTypes` |
| XCode 集成 | 默认驱动切换并保留旧驱动回退;不声称支持事务、DDL 或自增 |
| 多语言 | 33 种运行时语言,编译期生成,AOT 可用 |
| 诊断 | 异常与日志保留查询 ID、错误码、SQLState 与耗时 |
| OpenTelemetry | 现代框架提供 `ActivitySource("NewLife.Presto")` |
| 打包 | 强命名、SourceLink、符号包与 README.nuget.md |
</details>
## 平台支持
| 维度 | 支持范围 |
|------|----------|
| 操作系统 | Windows、Linux(glibc 与 musl)、macOS |
| 指令集 | x64、arm64;LoongArch64 与 riscv64 由观察期构建覆盖 |
| 目标框架 | net45、net461、netstandard2.0、netstandard2.1、net6.0、net8.0、net10.0、net11.0 |
| NativeAOT | net8.0+ 裁剪/AOT 分析器零告警;win-x64、linux-x64、linux-arm64 为阻断冒烟 |
| CI 矩阵 | Windows、Linux x64、Linux arm64、musl 容器、macOS 与 Windows arm64(观察期) |
## 多语言
| 范围 | 覆盖 |
|------|------|
| 运行时消息 | 33 种语言(含英文);缺失译文回退英文 |
| README | 由 `readme-languages.json` 生成 11 种语言 |
| 元数据 | 程序集标题与描述使用英文源文,展示时翻译 |
> 词表键就是英文源文。代码新增消息后,需要在每个语言文件中补齐同名键;`tools/check-locales.ps1 -RequireTranslated` 会在 CI 中校验键集合、占位符与翻译完整度。
## 文档
- [需求文档](/NewLife/NewLife.Presto/Blob/master/Doc/需求文档.md) — 目标与范围
- [功能清单](/NewLife/NewLife.Presto/Blob/master/Doc/功能清单.md) — 实现/测试/注释三维状态
- [架构设计](/NewLife/NewLife.Presto/Blob/master/Doc/架构设计.md) — 组件、协议流程、类型映射与设计决策
- [竞品分析](/NewLife/NewLife.Presto/Blob/master/Doc/竞品分析.md) — 参考实现、功能矩阵与差距
## 参与贡献
- 构建:`dotnet build NewLife.Presto.slnx -c Release`
- 测试:`dotnet test UnitTest/UnitTest.csproj -c Release`
- 多语言:`pwsh -File tools/check-locales.ps1 -RequireTranslated`
- 遵循 NewLife C# 约定,运行时消息必须进入词表。
- 非发版流程不得修改 `ChangeLog.md` 与包发布说明。
## 生态版图
NewLife 生态按依赖分层,各项目独立版本、独立发版。下面的版图在所有 NewLife 仓库中逐字一致;每个项目链接到代码仓库与主 NuGet 包。
| 项目 | 一句话定位 | 下载量 |
| --- | --- | --- |
| **基础底座** | | |
| [NewLife.Core](https://github.com/NewLifeX/X) | 日志、配置、缓存、网络、序列化、定时调度与 APM 追踪。 | [](https://www.nuget.org/packages/NewLife.Core) |
| [NewLife.XCode](https://github.com/NewLifeX/NewLife.XCode) | 数据中间件:单表百亿级、自动分表、读写分离,支持 10 多种数据库。 | [](https://www.nuget.org/packages/NewLife.XCode) |
| [NewLife.Net](https://github.com/NewLifeX/NewLife.Net) | 高性能网络库:单机 177 万 pps、14.5 Gbps(TCP 1KB,2026-10 实测),400 万 Tcp 长连接。 | [](https://www.nuget.org/packages/NewLife.Net) |
| [NewLife.Remoting](https://github.com/NewLifeX/NewLife.Remoting) | 协议通信与 RPC 框架,面向 CS 应用与物联网设备。 | [](https://www.nuget.org/packages/NewLife.Remoting) |
| [NewLife.Agent](https://github.com/NewLifeX/NewLife.Agent) | 把 .NET 应用安装为操作系统守护进程:Windows 服务与 Linux systemd。 | [](https://www.nuget.org/packages/NewLife.Agent) |
| [NewLife.Templates](https://github.com/NewLifeX/NewLife.Zero) | `dotnet new` 项目模板:控制台、Web、WebApi、服务、数据与物联网。 | [](https://www.nuget.org/packages/NewLife.Templates) |
| **数据存储与消息** | | |
| [NewLife.Redis](https://github.com/NewLifeX/NewLife.Redis) | Redis 客户端:微秒级延迟、百万级吞吐,内置消息队列。 | [](https://www.nuget.org/packages/NewLife.Redis) |
| [NewLife.RocketMQ](https://github.com/NewLifeX/NewLife.RocketMQ) | 纯托管 RocketMQ 客户端,支持 Apache RocketMQ 与阿里云消息队列。 | [](https://www.nuget.org/packages/NewLife.RocketMQ) |
| [NewLife.MQTT](https://github.com/NewLifeX/NewLife.MQTT) | MQTT 客户端与服务端,客户端支持阿里云物联网。 | [](https://www.nuget.org/packages/NewLife.MQTT) |
| [NewLife.NovaDb](https://github.com/NewLifeX/NewLife.NovaDb) | C# 混合数据库:嵌入/网络双模,关系型、时序、消息队列与 KV 于一体。 | [](https://www.nuget.org/packages/NewLife.NovaDb) |
| [NewLife.MySql](https://github.com/NewLifeX/NewLife.MySql) | MySql 驱动与数据访问辅助层,基于 NewLife 数据栈实现。 | [](https://www.nuget.org/packages/NewLife.MySql) |
| **Web、AI 与分布式** | | |
| [NewLife.Cube](https://github.com/NewLifeX/NewLife.Cube) | 魔方快速开发平台:用户权限、SSO、OAuth 服务端与 CRUD 脚手架。 | [](https://www.nuget.org/packages/NewLife.Cube) |
| [Stardust](https://github.com/NewLifeX/Stardust) | 星尘分布式服务平台:节点管理、APM、配置中心、注册中心与发布中心。 | [](https://www.nuget.org/packages/NewLife.Stardust) |
| [AntJob](https://github.com/NewLifeX/AntJob) | 蚂蚁调度:分布式任务与实时数据平台,支持分片、重试与回溯补算。 | [](https://www.nuget.org/packages/NewLife.AntJob) |
| [NewLife.AI](https://github.com/NewLifeX/NewLife.AI) | 统一接入 46 家大模型服务商,附带开箱即用的 ChatAI Web 对话应用。 | [](https://www.nuget.org/packages/NewLife.AI) |
| **工业与物联网** | | |
| [NewLife.IoT](https://github.com/NewLifeX/NewLife.IoT) | IoT 标准库,定义物联网通信协议契约与设备抽象。 | [](https://www.nuget.org/packages/NewLife.IoT) |
| [NewLife.Modbus](https://github.com/NewLifeX/NewLife.Modbus) | Modbus TCP/RTU/ASCII,基于 NewLife.IoT 实现。 | [](https://www.nuget.org/packages/NewLife.Modbus) |
| [NewLife.Siemens](https://github.com/NewLifeX/NewLife.Siemens) | 西门子 PLC 协议,基于 NewLife.IoT 实现。 | [](https://www.nuget.org/packages/NewLife.Siemens) |
| [NewLife.Omron](https://github.com/NewLifeX/NewLife.Omron) | 欧姆龙 PLC 协议,基于 NewLife.IoT 实现。 | [](https://www.nuget.org/packages/NewLife.Omron) |
| [NewLife.Melsec](https://github.com/NewLifeX/NewLife.Melsec) | 三菱 Melsec PLC 协议,基于 NewLife.IoT 实现。 | [](https://www.nuget.org/packages/NewLife.Melsec) |
| [NewLife.OPC](https://github.com/NewLifeX/NewLife.OPC) | OPC 客户端,用于工业数据采集。 | — |
| [NewLife.BACnet](https://github.com/NewLifeX/NewLife.BACnet) | BACnet 楼宇自控协议栈。 | [](https://www.nuget.org/packages/NewLife.BACnet) |
| [ZeroIoT](https://github.com/NewLifeX/ZeroIoT) | 开源轻量级 IoT 平台,含网关与设备管理。 | — |
| **车联网** | | |
| [NewLife.JT808](https://github.com/NewLifeX/NewLife.JT808) | JT/T 808 车辆定位协议:70+ 消息体,覆盖 2011/2013/2019 三个版本。 | [](https://www.nuget.org/packages/NewLife.JT808) |
| [NewLife.JT809](https://github.com/NewLifeX/NewLife.JT809) | JT/T 809 部标平台互联协议,面向运输管理部门。 | [](https://www.nuget.org/packages/NewLife.JT809) |
| [NewLife.JT1078](https://github.com/NewLifeX/NewLife.JT1078) | JT/T 1078 车载视频:RTP 解析、FLV/fMP4 转封装与直播推送。 | [](https://www.nuget.org/packages/NewLife.JT1078) |
| **领域组件** | | |
| [NewLife.Office](https://github.com/NewLifeX/NewLife.Office) | 一个包覆盖 Excel、Word、PPT、PDF 等 15+ 文档格式。 | [](https://www.nuget.org/packages/NewLife.Office) |
| [NewLife.Audio](https://github.com/NewLifeX/NewLife.Audio) | 跨平台音频:编解码、设备 IO、DSP、容器与流式处理。 | [](https://www.nuget.org/packages/NewLife.Audio) |
| [NewLife.Video](https://github.com/NewLifeX/NewLife.Video) | 视频编解码、封装格式、帧处理与流媒体。 | [](https://www.nuget.org/packages/NewLife.Video) |
| [NewLife.Map](https://github.com/NewLifeX/NewLife.Map) | 百度/高德/腾讯/天地图统一接口,支持地理编码与坐标转换。 | [](https://www.nuget.org/packages/NewLife.Map) |
| [NewLife.IP](https://github.com/NewLifeX/NewLife.IP) | IPv4 归属地:离线内存映射库 + 在线 API 双源。 | [](https://www.nuget.org/packages/NewLife.IP) |
| **工具与产品** | | |
| [CrazyCoder](https://github.com/NewLifeX/XCoder) | 码神工具:网络、串口、加解密、正则、Modbus 与 MQTT。 | [](https://www.nuget.org/packages/NewLife.XCoder) |
| [GitCandy](https://github.com/NewLifeX/GitCandy) | 自托管 Git 源代码管理系统。 | — |
| [LuckyClover](https://github.com/NewLifeX/LuckyClover) | 从低版本宿主启动时,自动安装匹配的 .NET 运行时。 | — |
> 徽章取各项目主包;主题包、扩展包与卫星包见对应 NuGet 页面。未在表中列出的 30 多个包(FTP、LoRa、Office 扩展、各类协议驱动等)见 [NewLifeX 组织](https://github.com/NewLifeX) 与 [newlifex.com](https://newlifex.com)。
## 新生命开发团队
<img src="https://newlifex.com/logo.png" width="48" align="right" alt="NewLife" />
新生命团队成立于 2002 年,二十余年专注 .NET 与物联网技术生态,主导开源项目近百个(生态版图收录 34 个主干项目),为电力、物流、医疗、工控、互联网等行业提供软硬件一体化解决方案;以“学无先后达者为师”为信条。
开源组件在 NuGet 累计下载 <!--nuget-total:start-->6.48M<!--nuget-total:end--> 次(全生态口径,截至 2026-10)。
网站:https://newlifex.com · 开源组织:https://github.com/NewLifeX
<details>
<summary>微信公众号:智能大石头(扫码关注)</summary>

</details>
## 许可证
[MIT](/NewLife/NewLife.Presto/Blob/master/LICENSE)
|