docs: README 支持 11 种语言
大石头 authored at 2026-11-20 18:43:49
17.89 KiB
NewLife.Presto
# NewLife.Presto — Presto/Trino ADO.NET 驱动 [![AOT](https://github.com/NewLifeX/NewLife.Presto/actions/workflows/aot.yml/badge.svg?label=AOT)](https://github.com/NewLifeX/NewLife.Presto/actions/workflows/aot.yml) ![GitHub License](https://img.shields.io/github/license/NewLifeX/NewLife.Presto?logo=github) ![NuGet Downloads](https://img.shields.io/nuget/dt/NewLife.Presto?logo=nuget) ![NuGet](https://img.shields.io/nuget/v/NewLife.Presto?logo=nuget) ![NuGet prerelease](https://img.shields.io/nuget/vpre/NewLife.Presto?label=dev%20nuget&logo=nuget) [![test](https://github.com/NewLifeX/NewLife.Presto/actions/workflows/test.yml/badge.svg?branch=master)](https://github.com/NewLifeX/NewLife.Presto/actions/workflows/test.yml) [![locales](https://img.shields.io/badge/locales-33-2ea44f?logo=dotnet)](/NewLife/NewLife.Presto/Blob/master/Doc/多语言本地化.md) ![platform](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-blue) ![arch](https://img.shields.io/badge/arch-x64%20%7C%20arm64%20%7C%20loongarch64%20%7C%20riscv64-orange) [![contributors](https://img.shields.io/github/contributors/NewLifeX/NewLife.Presto?logo=github)](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 追踪。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Core?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.Core) | | [NewLife.XCode](https://github.com/NewLifeX/NewLife.XCode) | 数据中间件:单表百亿级、自动分表、读写分离,支持 10 多种数据库。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.XCode?style=flat-square&logo=nuget&label=downloads)](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 长连接。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Net?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.Net) | | [NewLife.Remoting](https://github.com/NewLifeX/NewLife.Remoting) | 协议通信与 RPC 框架,面向 CS 应用与物联网设备。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Remoting?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.Remoting) | | [NewLife.Agent](https://github.com/NewLifeX/NewLife.Agent) | 把 .NET 应用安装为操作系统守护进程:Windows 服务与 Linux systemd。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Agent?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.Agent) | | [NewLife.Templates](https://github.com/NewLifeX/NewLife.Zero) | `dotnet new` 项目模板:控制台、Web、WebApi、服务、数据与物联网。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Templates?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.Templates) | | **数据存储与消息** | | | | [NewLife.Redis](https://github.com/NewLifeX/NewLife.Redis) | Redis 客户端:微秒级延迟、百万级吞吐,内置消息队列。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Redis?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.Redis) | | [NewLife.RocketMQ](https://github.com/NewLifeX/NewLife.RocketMQ) | 纯托管 RocketMQ 客户端,支持 Apache RocketMQ 与阿里云消息队列。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.RocketMQ?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.RocketMQ) | | [NewLife.MQTT](https://github.com/NewLifeX/NewLife.MQTT) | MQTT 客户端与服务端,客户端支持阿里云物联网。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.MQTT?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.MQTT) | | [NewLife.NovaDb](https://github.com/NewLifeX/NewLife.NovaDb) | C# 混合数据库:嵌入/网络双模,关系型、时序、消息队列与 KV 于一体。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.NovaDb?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.NovaDb) | | [NewLife.MySql](https://github.com/NewLifeX/NewLife.MySql) | MySql 驱动与数据访问辅助层,基于 NewLife 数据栈实现。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.MySql?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.MySql) | | **Web、AI 与分布式** | | | | [NewLife.Cube](https://github.com/NewLifeX/NewLife.Cube) | 魔方快速开发平台:用户权限、SSO、OAuth 服务端与 CRUD 脚手架。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Cube?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.Cube) | | [Stardust](https://github.com/NewLifeX/Stardust) | 星尘分布式服务平台:节点管理、APM、配置中心、注册中心与发布中心。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Stardust?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.Stardust) | | [AntJob](https://github.com/NewLifeX/AntJob) | 蚂蚁调度:分布式任务与实时数据平台,支持分片、重试与回溯补算。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.AntJob?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.AntJob) | | [NewLife.AI](https://github.com/NewLifeX/NewLife.AI) | 统一接入 46 家大模型服务商,附带开箱即用的 ChatAI Web 对话应用。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.AI?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.AI) | | **工业与物联网** | | | | [NewLife.IoT](https://github.com/NewLifeX/NewLife.IoT) | IoT 标准库,定义物联网通信协议契约与设备抽象。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.IoT?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.IoT) | | [NewLife.Modbus](https://github.com/NewLifeX/NewLife.Modbus) | Modbus TCP/RTU/ASCII,基于 NewLife.IoT 实现。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Modbus?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.Modbus) | | [NewLife.Siemens](https://github.com/NewLifeX/NewLife.Siemens) | 西门子 PLC 协议,基于 NewLife.IoT 实现。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Siemens?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.Siemens) | | [NewLife.Omron](https://github.com/NewLifeX/NewLife.Omron) | 欧姆龙 PLC 协议,基于 NewLife.IoT 实现。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Omron?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.Omron) | | [NewLife.Melsec](https://github.com/NewLifeX/NewLife.Melsec) | 三菱 Melsec PLC 协议,基于 NewLife.IoT 实现。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Melsec?style=flat-square&logo=nuget&label=downloads)](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 楼宇自控协议栈。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.BACnet?style=flat-square&logo=nuget&label=downloads)](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 三个版本。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.JT808?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.JT808) | | [NewLife.JT809](https://github.com/NewLifeX/NewLife.JT809) | JT/T 809 部标平台互联协议,面向运输管理部门。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.JT809?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.JT809) | | [NewLife.JT1078](https://github.com/NewLifeX/NewLife.JT1078) | JT/T 1078 车载视频:RTP 解析、FLV/fMP4 转封装与直播推送。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.JT1078?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.JT1078) | | **领域组件** | | | | [NewLife.Office](https://github.com/NewLifeX/NewLife.Office) | 一个包覆盖 Excel、Word、PPT、PDF 等 15+ 文档格式。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Office?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.Office) | | [NewLife.Audio](https://github.com/NewLifeX/NewLife.Audio) | 跨平台音频:编解码、设备 IO、DSP、容器与流式处理。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Audio?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.Audio) | | [NewLife.Video](https://github.com/NewLifeX/NewLife.Video) | 视频编解码、封装格式、帧处理与流媒体。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Video?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.Video) | | [NewLife.Map](https://github.com/NewLifeX/NewLife.Map) | 百度/高德/腾讯/天地图统一接口,支持地理编码与坐标转换。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.Map?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.Map) | | [NewLife.IP](https://github.com/NewLifeX/NewLife.IP) | IPv4 归属地:离线内存映射库 + 在线 API 双源。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.IP?style=flat-square&logo=nuget&label=downloads)](https://www.nuget.org/packages/NewLife.IP) | | **工具与产品** | | | | [CrazyCoder](https://github.com/NewLifeX/XCoder) | 码神工具:网络、串口、加解密、正则、Modbus 与 MQTT。 | [![NuGet](https://img.shields.io/nuget/dt/NewLife.XCoder?style=flat-square&logo=nuget&label=downloads)](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> ![智能大石头](https://newlifex.com/stone.jpg) </details> ## 许可证 [MIT](/NewLife/NewLife.Presto/Blob/master/LICENSE)