pgrust 快速入门：用 psql 连接并执行你的第一条 SQL 查询

pgrust 快速入门用 psql 连接并执行你的第一条 SQL 查询【免费下载链接】pgrustPostgres rewritten in Rust, now faster than Postgres and Clickhouse项目地址: https://gitcode.com/GitHub_Trending/pg/pgrust想要体验比 Postgres 更快的 Postgres这份pgrust 快速入门教程将带你零基础起步如何用psql连接 pgrust 服务器并执行你的第一条 SQL 查询。pgrust 是一个用 Rust 重写 PostgreSQL 的开源项目目标兼容 Postgres 18.3已通过 46,000 条回归查询验证磁盘格式与原生 Postgres 完全兼容新版本在分析型负载上的目标是超越 Clickhouse。下文每一步都附有可直接复制的命令跟着做就能跑通。pgrust 是什么为什么值得一试简单说pgrust 把 PostgreSQL 用 Rust 从零重写了一遍但保持 Postgres 的行为和生态。这意味着亮点说明✅ 兼容 Postgres 18.3通过 46,000 条 Postgres 回归查询测试✅ 磁盘格式兼容可以直接挂载并启动现有 Postgres 18.3 数据目录✅ psql 无缝连接标准 psql 客户端即可连接无需特殊驱动⚡ 性能潜力新版本事务负载比 Postgres 快约 50%分析型负载快约 300 倍它甚至可以用--initdb参数自己完成数据目录的初始化整个过程不依赖 C 版的initdb。第一步快速启动 pgrust 的两种方式方式一Docker 一键启动新手首选这是最快的方式一条命令即可拉起一个 pgrust 服务器docker run -d --name pgrust -e POSTGRES_PASSWORDsecret malisper/pgrust:v0.1等服务器就绪后直接用镜像内置的 psql 进入交互模式until docker exec -e PGPASSWORDsecret pgrust psql -h 127.0.0.1 -U postgres -c \q /dev/null 21; do sleep 1; done docker exec -it -e PGPASSWORDsecret pgrust psql -h 127.0.0.1 -U postgres该镜像完全遵循官方postgres镜像的约定支持POSTGRES_USER、POSTGRES_DB、PGDATA等环境变量默认端口 5432还支持/docker-entrypoint-initdb.d首次初始化脚本迁移成本几乎为零。方式二从源码编译 pgrust进阶路线想深入源码或者本地调试可以克隆仓库并编译git clone https://gitcode.com/GitHub_Trending/pg/pgrust cd pgrustDebian/Ubuntu 系统先安装依赖sudo apt-get update sudo apt-get install -y build-essential pkg-config libicu-dev libssl-dev libldap2-dev libpam0g-dev postgresql-client-18编译服务器二进制PGRUST_PGSHAREDIR$PWD/vendor/postgres-18.3/share \ cargo build --release --locked --bin postgres然后初始化数据目录target/release/postgres --initdb \ -D /tmp/pgrust-data \ -L $PWD/vendor/postgres-18.3/share \ --no-locale \ --encoding UTF8 \ -U postgres最后启动服务器注意 pgrust 需要较大的线程栈命令里已经处理好了ulimit -s 65520 RUST_MIN_STACK33554432 target/release/postgres \ -D /tmp/pgrust-data \ -F \ -c listen_addresses \ -k /tmp \ -p 5432 \ -c io_methodsync \ -c max_stack_depth60000第二步用 psql 连接 pgrust服务器跑起来后就到了本文的核心环节psql 连接。psql 是 PostgreSQL 官方的命令行客户端pgrust 完全兼容它。psql 连接 Docker 版 pgrust在宿主机上需要本机装有 psql用连接串方式最直观psql postgres://postgres:secretlocalhost:5432/postgres \ -c select version(), 1 1 as twopsql 连接源码版 pgrustUnix Socket 方式源码版默认监听 Unix socket目录为/tmp连接命令如下psql -h /tmp -p 5432 -U postgres -d postgres \ -c select version(), 1 1 as two看到类似下面的输出就说明 psql 已经成功连上 pgrust 了 version | two ----------------------------------------------------------------------------------- PostgreSQL 18.3 (pgrust) on ... | 2psql 连接参数速查表参数含义示例-h主机或 socket 目录-h 127.0.0.1或-h /tmp-p端口号-p 5432-U用户名-U postgres-d数据库名-d postgres-c执行单条 SQL 后退出-c select 1第三步执行你的第一条 SQL 查询连接成功后就可以开始执行 SQL 了。先来一条最经典的验证语句SELECT version(), 1 1 AS two;再试试完整的建表、插入、查询流程CREATE TABLE users ( id SERIAL PRIMARY KEY, name TEXT NOT NULL, age INT ); INSERT INTO users (name, age) VALUES (alice, 25), (bob, 30); SELECT * FROM users WHERE age 25 ORDER BY age;pgrust 对 SQL 语法和系统函数高度兼容日常开发中常用的SELECT、INSERT、UPDATE、JOIN、聚合函数、窗口函数等都可以放心使用。常见问题与注意事项 ⚠️认证方式当前版本 pgrust 尚未完全移植密码认证逻辑Docker 镜像的 TCP 连接默认使用trust认证密码会写入数据库但不强制校验。所以连接时即使密码不对也能进入这属于正常现象后续版本会补全。端口冲突如果本机 5432 已被占用启动时用-p 5433换端口psql 连接时保持端口一致即可。ulimit / 栈大小源码方式运行时务必执行ulimit -s 65520并设置RUST_MIN_STACK否则 pgrust 可能因栈不足而无法启动。环境要求需要 PostgreSQL 18 的 psql 客户端Docker 镜像已内置宿主机需自行安装。延伸阅读相关源码路径想进一步研究 pgrust 的实现可以从这些模块入手crates/backend/main/main_main服务器主入口跟踪启动流程crates/backend/main/initdbpgrust 自研的 initdb 驱动crates/backend/libpq/pqcomm客户端连接与通信协议crates/backend/libpq/auth认证相关逻辑docker/entrypoint.shDocker 容器的完整启动脚本Dockerfile镜像的构建细节含 psql 打包方式总结到这里你已经完成了 pgrust 的完整初体验启动服务器 → psql 连接 → 执行第一条 SQL 查询。整个过程与原生 PostgreSQL 几乎无差别但底层引擎已经换成了 Rust。如果你对用 Rust 重写 Postgres 还能跑得更快这件事感兴趣不妨把 pgrust 跑起来亲手感受一下这条技术路线的潜力。【免费下载链接】pgrustPostgres rewritten in Rust, now faster than Postgres and Clickhouse项目地址: https://gitcode.com/GitHub_Trending/pg/pgrust创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考