docs: README 支持 11 种语言
|
# NewLife.Presto — controlador ADO.NET para Presto/Trino
[](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-CN.md) | [繁體中文](/NewLife/NewLife.Presto/Blob/master/README.zh-TW.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** es un controlador ADO.NET en C# puro para PrestoDB y Trino del equipo NewLife. Usa el protocolo cliente HTTP REST v1 oficial, depende solo de `NewLife.Core` con **cero dependencias de terceros**, incluye **33 idiomas de ejecución**, es compatible con `net45` a `net11` y está **listo para NativeAOT** en `net8.0+`. PrestoDB y Trino comparten un paquete; `Protocol=Trino` (o `TrinoHeaders=true`) cambia los encabezados de solicitud.
> **Estado del proyecto**: fase de diseño y andamiaje. Los componentes sin conexión (cadena de conexión, encabezados de protocolo, asignación de tipos, localización, prueba AOT) están implementados y probados; la red y la ejecución de consultas se siguen en la [lista de funciones](/NewLife/NewLife.Presto/Blob/master/Doc/功能清单.md).
**Contenido**: [Inicio rápido](/NewLife/NewLife.Presto/Blob/master/#inicio-rápido) · [Por qué NewLife.Presto](/NewLife/NewLife.Presto/Blob/master/#por-qué-newlifepresto) · [Funciones principales](/NewLife/NewLife.Presto/Blob/master/#funciones-principales) · [Compatibilidad de plataformas](/NewLife/NewLife.Presto/Blob/master/#compatibilidad-de-plataformas) · [Localización](/NewLife/NewLife.Presto/Blob/master/#localización) · [Documentación](/NewLife/NewLife.Presto/Blob/master/#documentación) · [Contribuir](/NewLife/NewLife.Presto/Blob/master/#contribuir) · [Mapa del ecosistema](/NewLife/NewLife.Presto/Blob/master/#mapa-del-ecosistema) · [Equipo](/NewLife/NewLife.Presto/Blob/master/#equipo) · [Licencia](/NewLife/NewLife.Presto/Blob/master/#licencia)
---
## Inicio rápido
```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();
```
---
## Por qué NewLife.Presto
- **Un paquete para PrestoDB y Trino**: la misma implementación de protocolo, con encabezados `X-Presto-*` / `X-Trino-*` seleccionados por configuración.
- **XCode primero**: fábrica, alias de cadena de conexión, parámetros `@`, metadatos y límites de capacidad diseñados para el modelo Presto de XCode.
- **Cero dependencias de terceros**: solo `NewLife.Core`; JSON, HTTP y registro provienen de la BCL o de la pila NewLife.
- **Todas las plataformas y frameworks**: `net45` ~ `net11`, Windows / Linux / macOS, x64 / arm64, más LoongArch64 y musl como compilaciones de observación.
- **33 idiomas de ejecución**: excepciones, registros y metadatos del controlador localizados, con inglés como origen y respaldo.
- **Listo para NativeAOT**: sin reflexión en tiempo de ejecución en los códecs de protocolo o tipos; prueba AOT en cada plataforma compatible.
## Funciones principales
<details>
<summary><b>Conexión y protocolo</b> (6 elementos)</summary>
| Función | Valor |
|---------|-------|
| Alias de cadena de conexión | `Host`/`Server`/`Data Source`, `Catalog`/`Database`, `Schema`/`Owner` y sintaxis de XCode |
| Encabezados PrestoDB / Trino | `Protocol=Presto` por defecto; `Protocol=Trino` o `TrinoHeaders=true` para Trino 351+ |
| Contexto de sesión | Catalog, esquema, usuario, origen, zona horaria, propiedades de sesión y encabezados personalizados |
| Autenticación | Basic, JWT/Bearer y encabezados de puerta de enlace personalizados, sin secretos en los registros |
| TLS y proxies | Validación estricta de certificados por defecto; excepción explícita para CA privadas |
| Transporte HTTP compartido | Reutiliza `HttpClient` por punto de conexión, con proxy, compresión y tiempos de espera |
</details>
<details>
<summary><b>Consultas y tipos</b> (6 elementos)</summary>
| Función | Valor |
|---------|-------|
| Ciclo de vida de la instrucción | `POST /v1/statement`, sondeo de `nextUri` y detección de finalización |
| Estados compatibles hacia adelante | Los estados son cadenas, los nuevos estados del servidor no rompen el análisis |
| Reintento transitorio | 429/502/503/504 con `Retry-After` o retroceso exponencial |
| Parámetros `@name` | Sustitución en el cliente que omite cadenas, identificadores y comentarios |
| Fidelidad de tipos | Booleano, entero, decimal, fecha/hora, timestamp with time zone, UUID, IP y binario |
| Tipos complejos | `array`/`map`/`row`/`json` se devuelven como cadenas sin formato en v1 |
</details>
<details>
<summary><b>Integración y diagnóstico</b> (6 elementos)</summary>
| Función | Valor |
|---------|-------|
| `GetSchema` | `MetaDataCollections`, `Tables`, `Columns`, `DataTypes` |
| Integración con XCode | Cambio al controlador predeterminado con respaldo al anterior; sin promesas de transacción, DDL o autoincremento |
| Localización | 33 idiomas de ejecución, generados en tiempo de compilación y compatibles con AOT |
| Diagnóstico | ID de consulta, código de error, SQLState y duración conservados en excepciones y registros |
| OpenTelemetry | `ActivitySource("NewLife.Presto")` en frameworks modernos |
| Empaquetado | Nombre fuerte, SourceLink, paquete de símbolos y README.nuget.md |
</details>
## Compatibilidad de plataformas
| Área | Compatible |
|------|------------|
| Sistemas operativos | Windows, Linux (glibc y musl), macOS |
| Arquitecturas | x64, arm64; LoongArch64 y riscv64 mediante compilaciones de observación |
| Frameworks de destino | net45, net461, netstandard2.0, netstandard2.1, net6.0, net8.0, net10.0, net11.0 |
| NativeAOT | net8.0+ sin advertencias del analizador de recorte/AOT; prueba bloqueante en win-x64, linux-x64, linux-arm64 |
| Matriz CI | Windows, Linux x64, Linux arm64, contenedores musl, macOS y Windows arm64 (observación) |
## Localización
| Ámbito | Cobertura |
|--------|-----------|
| Mensajes de ejecución | 33 idiomas incluido inglés; las traducciones ausentes vuelven al inglés |
| README | 11 idiomas generados desde `readme-languages.json` |
| Metadatos | El título y la descripción del ensamblado son texto origen en inglés y se traducen al mostrarse |
> Las claves de traducción son el texto origen en inglés. Tras añadir un mensaje en el código, añada la misma clave en cada archivo de idioma; `tools/check-locales.ps1 -RequireTranslated` valida claves, marcadores y completitud en CI.
## Documentación
- [需求文档](/NewLife/NewLife.Presto/Blob/master/Doc/需求文档.md) — requisitos y alcance
- [功能清单](/NewLife/NewLife.Presto/Blob/master/Doc/功能清单.md) — estado de implementación/pruebas/comentarios
- [架构设计](/NewLife/NewLife.Presto/Blob/master/Doc/架构设计.md) — componentes, flujo del protocolo, asignación de tipos, decisiones
- [竞品分析](/NewLife/NewLife.Presto/Blob/master/Doc/竞品分析.md) — proyectos de referencia, matriz de funciones, brechas
## Contribuir
- Compilar: `dotnet build NewLife.Presto.slnx -c Release`
- Probar: `dotnet test UnitTest/UnitTest.csproj -c Release`
- Localización: `pwsh -File tools/check-locales.ps1 -RequireTranslated`
- Siga las convenciones C# de NewLife y añada cada mensaje de ejecución a las tablas de idioma.
- No modifique `ChangeLog.md` ni las notas de versión del paquete fuera del proceso de publicación.
## Mapa del ecosistema
NewLife es un ecosistema por capas de proyectos de código abierto con versionado independiente. El mapa siguiente se comparte literalmente en todos los repositorios de NewLife; cada proyecto enlaza a su repositorio y a su paquete principal de NuGet.
| Proyecto | Qué hace | Descargas |
| --- | --- | --- |
| **Fundación** | | |
| [NewLife.Core](https://github.com/NewLifeX/X) | Registro de logs, configuración, caché, red, serialización, programación de tareas y seguimiento APM. | [](https://www.nuget.org/packages/NewLife.Core) |
| [NewLife.XCode](https://github.com/NewLifeX/NewLife.XCode) | Middleware de datos: tablas únicas a escala de decenas de miles de millones, particionado automático, separación lectura/escritura y más de 10 bases de datos. | [](https://www.nuget.org/packages/NewLife.XCode) |
| [NewLife.Net](https://github.com/NewLifeX/NewLife.Net) | Biblioteca de red de alto rendimiento: 1,77 M pps / 14,5 Gbps en una máquina (TCP 1KB, 2026-10), 4 M conexiones TCP persistentes. | [](https://www.nuget.org/packages/NewLife.Net) |
| [NewLife.Remoting](https://github.com/NewLifeX/NewLife.Remoting) | Framework de comunicación por protocolo y RPC para aplicaciones cliente/servidor y dispositivos IoT. | [](https://www.nuget.org/packages/NewLife.Remoting) |
| [NewLife.Agent](https://github.com/NewLifeX/NewLife.Agent) | Instala aplicaciones .NET como demonios del sistema operativo: servicios de Windows y systemd de Linux. | [](https://www.nuget.org/packages/NewLife.Agent) |
| [NewLife.Templates](https://github.com/NewLifeX/NewLife.Zero) | Plantillas de proyecto `dotnet new` para consola, web, API, servicio, datos e IoT. | [](https://www.nuget.org/packages/NewLife.Templates) |
| **Datos y mensajería** | | |
| [NewLife.Redis](https://github.com/NewLifeX/NewLife.Redis) | Cliente Redis con latencia de microsegundos, millones de operaciones por segundo y colas de mensajes integradas. | [](https://www.nuget.org/packages/NewLife.Redis) |
| [NewLife.RocketMQ](https://github.com/NewLifeX/NewLife.RocketMQ) | Cliente RocketMQ totalmente administrado para Apache RocketMQ y Alibaba Cloud Message Queue. | [](https://www.nuget.org/packages/NewLife.RocketMQ) |
| [NewLife.MQTT](https://github.com/NewLifeX/NewLife.MQTT) | Cliente y servidor MQTT, incluida la conectividad con Alibaba Cloud IoT. | [](https://www.nuget.org/packages/NewLife.MQTT) |
| [NewLife.NovaDb](https://github.com/NewLifeX/NewLife.NovaDb) | Base de datos híbrida en C#: embebida o en red, relacional, series temporales, cola de mensajes y KV en una sola. | [](https://www.nuget.org/packages/NewLife.NovaDb) |
| [NewLife.MySql](https://github.com/NewLifeX/NewLife.MySql) | Controlador y capa de ayuda de MySql construidos sobre la pila de datos de NewLife. | [](https://www.nuget.org/packages/NewLife.MySql) |
| **Web, IA y distribuido** | | |
| [NewLife.Cube](https://github.com/NewLifeX/NewLife.Cube) | Framework rápido para plataformas de administración: permisos, SSO, servidor OAuth y andamiaje CRUD. | [](https://www.nuget.org/packages/NewLife.Cube) |
| [Stardust](https://github.com/NewLifeX/Stardust) | Plataforma distribuida de servicios: gestión de nodos, APM, centro de configuración, registro y centro de despliegues. | [](https://www.nuget.org/packages/NewLife.Stardust) |
| [AntJob](https://github.com/NewLifeX/AntJob) | Plataforma de tareas distribuidas y programación de datos en tiempo real con particionado, reintentos y relleno histórico. | [](https://www.nuget.org/packages/NewLife.AntJob) |
| [NewLife.AI](https://github.com/NewLifeX/NewLife.AI) | Cliente unificado para 46 proveedores de LLM más ChatAI, una aplicación web de chat lista para usar. | [](https://www.nuget.org/packages/NewLife.AI) |
| **Industrial e IoT** | | |
| [NewLife.IoT](https://github.com/NewLifeX/NewLife.IoT) | Biblioteca estándar de IoT que define contratos de protocolo y abstracciones de dispositivos. | [](https://www.nuget.org/packages/NewLife.IoT) |
| [NewLife.Modbus](https://github.com/NewLifeX/NewLife.Modbus) | Implementación de Modbus TCP/RTU/ASCII sobre NewLife.IoT. | [](https://www.nuget.org/packages/NewLife.Modbus) |
| [NewLife.Siemens](https://github.com/NewLifeX/NewLife.Siemens) | Protocolo para PLC Siemens sobre NewLife.IoT. | [](https://www.nuget.org/packages/NewLife.Siemens) |
| [NewLife.Omron](https://github.com/NewLifeX/NewLife.Omron) | Protocolo para PLC Omron sobre NewLife.IoT. | [](https://www.nuget.org/packages/NewLife.Omron) |
| [NewLife.Melsec](https://github.com/NewLifeX/NewLife.Melsec) | Protocolo para PLC Mitsubishi Melsec sobre NewLife.IoT. | [](https://www.nuget.org/packages/NewLife.Melsec) |
| [NewLife.OPC](https://github.com/NewLifeX/NewLife.OPC) | Cliente OPC para el acceso a datos industriales. | — |
| [NewLife.BACnet](https://github.com/NewLifeX/NewLife.BACnet) | Pila de protocolo BACnet para la automatización de edificios. | [](https://www.nuget.org/packages/NewLife.BACnet) |
| [ZeroIoT](https://github.com/NewLifeX/ZeroIoT) | Plataforma IoT de código abierto y ligera con gestión de pasarelas y dispositivos. | — |
| **Telemática vehicular** | | |
| [NewLife.JT808](https://github.com/NewLifeX/NewLife.JT808) | Protocolo de posicionamiento vehicular JT/T 808: más de 70 cuerpos de mensaje, 2011/2013/2019. | [](https://www.nuget.org/packages/NewLife.JT808) |
| [NewLife.JT809](https://github.com/NewLifeX/NewLife.JT809) | Protocolo plataforma a plataforma JT/T 809 para autoridades de transporte. | [](https://www.nuget.org/packages/NewLife.JT809) |
| [NewLife.JT1078](https://github.com/NewLifeX/NewLife.JT1078) | Vídeo a bordo JT/T 1078: análisis RTP, remultiplexado FLV/fMP4 y transmisión en directo. | [](https://www.nuget.org/packages/NewLife.JT1078) |
| **Componentes de dominio** | | |
| [NewLife.Office](https://github.com/NewLifeX/NewLife.Office) | Un solo paquete para Excel, Word, PPT, PDF y más de 15 formatos de documento. | [](https://www.nuget.org/packages/NewLife.Office) |
| [NewLife.Audio](https://github.com/NewLifeX/NewLife.Audio) | Audio multiplataforma: códecs, E/S de dispositivos, DSP, contenedores y streaming. | [](https://www.nuget.org/packages/NewLife.Audio) |
| [NewLife.Video](https://github.com/NewLifeX/NewLife.Video) | Códecs de vídeo, formatos de contenedor, procesamiento de fotogramas y streaming. | [](https://www.nuget.org/packages/NewLife.Video) |
| [NewLife.Map](https://github.com/NewLifeX/NewLife.Map) | Interfaz unificada sobre Baidu, AMap, Tencent y Tianditu con geocodificación y conversión de coordenadas. | [](https://www.nuget.org/packages/NewLife.Map) |
| [NewLife.IP](https://github.com/NewLifeX/NewLife.IP) | Geolocalización IPv4 con una base de datos offline mapeada en memoria y una API en línea de respaldo. | [](https://www.nuget.org/packages/NewLife.IP) |
| **Herramientas y productos** | | |
| [CrazyCoder](https://github.com/NewLifeX/XCoder) | Caja de herramientas del desarrollador: red, puerto serie, criptografía, expresiones regulares, Modbus y MQTT. | [](https://www.nuget.org/packages/NewLife.XCoder) |
| [GitCandy](https://github.com/NewLifeX/GitCandy) | Sistema de gestión de código fuente Git autoalojado. | — |
| [LuckyClover](https://github.com/NewLifeX/LuckyClover) | Instala automáticamente el runtime de .NET correspondiente cuando se ejecuta desde un host más antiguo. | — |
> Las insignias muestran el paquete principal de cada proyecto; los paquetes de temas, extensiones y satélites figuran en sus páginas de NuGet. Los más de 30 paquetes no listados aquí (FTP, LoRa, extensiones de Office, controladores de protocolo, etc.) están disponibles en la [organización NewLifeX](https://github.com/NewLifeX) y en [newlifex.com](https://newlifex.com).
## Equipo
<img src="https://newlifex.com/logo.png" width="48" align="right" alt="NewLife" />
NewLife se fundó en 2002 y lleva más de dos décadas dedicado al ecosistema .NET e IoT, mantiene cerca de 100 proyectos de código abierto (34 de ellos principales en este mapa) y ofrece soluciones integradas de software y hardware para los sectores de energía, logística, salud, control industrial e Internet. Nos guía el lema «en el aprendizaje no hay antigüedad: quien domina es maestro».
Los componentes de código abierto acumulan <!--nuget-total:start-->6.48M<!--nuget-total:end--> descargas en NuGet (ecosistema completo, a fecha de 2026-10).
Sitio web: https://newlifex.com · Organización de código abierto: https://github.com/NewLifeX
<details>
<summary>Cuenta oficial de WeChat: 智能大石头 (escanea para seguir)</summary>

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