一个数据库搞定文档、图谱与实时协作SurrealDB 快速上手完整指南【免费下载链接】surrealdbA scalable, distributed, collaborative, document-graph database, for the realtime web项目地址: https://gitcode.com/GitHub_Trending/su/surrealdbSurrealDB 是一个用 Rust 编写的多模态数据库把文档、图、关系型与向量检索统一进同一个引擎并自带行级权限和实时推送支持浏览器直连查询。 效果先行多模态数据库用起来是什么体验场景一做协作笔记应用用户 A 在一端改了正文另一端在线页面一两秒内就变了。不用自己写轮询、也不用自己搭 WebSocket 推送数据库里的 LIVE 查询会直接把变更推到客户端。场景二做知识图谱人、文章、以及谁写了哪篇之间的关系都存在同一个实例里。查某人写过哪些文章时直接沿着记录链接走不用 JOIN也不需要在应用代码里拼 N1 查询。⚙️ 原理速览引擎如何统一文档、图谱与 API 层一句话单个 Rust 二进制内运行统一存储引擎用类 SQL 的查询语言 SurrealQL 同时解析文档、图边、索引与权限。数据库层、查询层、API 层被合进同一个进程权限规则定义在表上、在存储层强制执行所以浏览器可以直接连接且只拿得到它有权拿到的数据。想看核心引擎实现可以看 surrealdb/core/ 目录查询解析器在 surrealdb/parser/。 快速上手三步启动第一个 SurrealDB 实例第一步选安装方式。macOS 走 HomebrewLinux 和 Windows 有一行安装脚本官方 README 里分平台列了命令也可以不装任何东西直接用 Docker 镜像。第二步启动开发实例。下面这个命令用内存存储、监听 8000 端口重启后数据清空适合先试玩docker run -p 8000:8000 \ surrealdb/surrealdb:latest start --user root --pass root memory第三步写第一条语句。在浏览器打开内置的 Web 控制台或用surreal isql命令行CREATE post SET title Hello, published true; SELECT * FROM post WHERE published true; 核心功能拆解三个最值得上手的能力图谱查询免 JOIN记录是节点RELATE语句建出边边本身可以带属性。朋友的朋友这类多跳遍历可以一条查询写完数据不用拉到应用端RELATE user:alice-wrote-article:rust; SELECT -wrote-article FROM user:alice;行级权限当安全阀权限规则直接写在表上比如已发布的帖子可读或只能读自己的帖子DEFINE TABLE post PERMISSIONS FOR select WHERE published true OR user $auth.id;。正因为权限在数据库内执行浏览器直连才敢用——不需要单独搭 API 网关做二次过滤。实时 Live 查询同步到浏览器用LIVE SELECT * FROM post;订阅后任何新增、修改、删除都会经 WebSocket 实时推给客户端还能按条件只订阅自己关心的子集。多人在线、评论更新、实时看板这类功能都靠它打底。⚠️ 避坑指南高频现象与处理方式连不上 / 认证失败服务器默认要求用户名密码启动时加上--user与--pass参数。重启后数据没了memory参数是内存存储要持久化请改用文件存储引擎或给容器挂卷。写了数据却查不出来多半是行级权限在过滤检查表的 PERMISSIONS 定义和当前认证身份。数据量上来后查询慢没建索引按查询类型用DEFINE INDEX加普通、全文或向量索引。想从源码构建跑测试看 doc/BUILDING.md 和 tests/README.md工具链对 Rust 版本有要求。 适用边界SurrealDB 适合谁引入适合实时协作应用以及想省掉 API 服务层、文档加图谱加检索一个实例全做的中小项目。适合嵌入式与边缘场景单个 Rust 二进制可以嵌进应用也能经 WebAssembly 跑在浏览器里。谨慎已有成熟的关系库加缓存加搜索的组合、数据模型稳定时迁移成本未必划算建议用真实查询逐条评估。谨慎需要完整托管云服务、或有严格合规审计时先确认核心代码的 BSL 1.1 许可和官方云方案再上。✅ 收尾什么情况下选 SurrealDB如果你想把数据库 API 网关 权限中间件这套组合砍掉一半同时还有图谱关系、实时推送的需求SurrealDB 值得一试——它最契合独立开发者、小团队和实时协作类产品的场景。【免费下载链接】surrealdbA scalable, distributed, collaborative, document-graph database, for the realtime web项目地址: https://gitcode.com/GitHub_Trending/su/surrealdb创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 一个数据库搞定文档、图谱与实时协作：SurrealDB 快速上手完整指南
一个数据库搞定文档、图谱与实时协作SurrealDB 快速上手完整指南【免费下载链接】surrealdbA scalable, distributed, collaborative, document-graph database, for the realtime web项目地址: https://gitcode.com/GitHub_Trending/su/surrealdbSurrealDB 是一个用 Rust 编写的多模态数据库把文档、图、关系型与向量检索统一进同一个引擎并自带行级权限和实时推送支持浏览器直连查询。 效果先行多模态数据库用起来是什么体验场景一做协作笔记应用用户 A 在一端改了正文另一端在线页面一两秒内就变了。不用自己写轮询、也不用自己搭 WebSocket 推送数据库里的 LIVE 查询会直接把变更推到客户端。场景二做知识图谱人、文章、以及谁写了哪篇之间的关系都存在同一个实例里。查某人写过哪些文章时直接沿着记录链接走不用 JOIN也不需要在应用代码里拼 N1 查询。⚙️ 原理速览引擎如何统一文档、图谱与 API 层一句话单个 Rust 二进制内运行统一存储引擎用类 SQL 的查询语言 SurrealQL 同时解析文档、图边、索引与权限。数据库层、查询层、API 层被合进同一个进程权限规则定义在表上、在存储层强制执行所以浏览器可以直接连接且只拿得到它有权拿到的数据。想看核心引擎实现可以看 surrealdb/core/ 目录查询解析器在 surrealdb/parser/。 快速上手三步启动第一个 SurrealDB 实例第一步选安装方式。macOS 走 HomebrewLinux 和 Windows 有一行安装脚本官方 README 里分平台列了命令也可以不装任何东西直接用 Docker 镜像。第二步启动开发实例。下面这个命令用内存存储、监听 8000 端口重启后数据清空适合先试玩docker run -p 8000:8000 \ surrealdb/surrealdb:latest start --user root --pass root memory第三步写第一条语句。在浏览器打开内置的 Web 控制台或用surreal isql命令行CREATE post SET title Hello, published true; SELECT * FROM post WHERE published true; 核心功能拆解三个最值得上手的能力图谱查询免 JOIN记录是节点RELATE语句建出边边本身可以带属性。朋友的朋友这类多跳遍历可以一条查询写完数据不用拉到应用端RELATE user:alice-wrote-article:rust; SELECT -wrote-article FROM user:alice;行级权限当安全阀权限规则直接写在表上比如已发布的帖子可读或只能读自己的帖子DEFINE TABLE post PERMISSIONS FOR select WHERE published true OR user $auth.id;。正因为权限在数据库内执行浏览器直连才敢用——不需要单独搭 API 网关做二次过滤。实时 Live 查询同步到浏览器用LIVE SELECT * FROM post;订阅后任何新增、修改、删除都会经 WebSocket 实时推给客户端还能按条件只订阅自己关心的子集。多人在线、评论更新、实时看板这类功能都靠它打底。⚠️ 避坑指南高频现象与处理方式连不上 / 认证失败服务器默认要求用户名密码启动时加上--user与--pass参数。重启后数据没了memory参数是内存存储要持久化请改用文件存储引擎或给容器挂卷。写了数据却查不出来多半是行级权限在过滤检查表的 PERMISSIONS 定义和当前认证身份。数据量上来后查询慢没建索引按查询类型用DEFINE INDEX加普通、全文或向量索引。想从源码构建跑测试看 doc/BUILDING.md 和 tests/README.md工具链对 Rust 版本有要求。 适用边界SurrealDB 适合谁引入适合实时协作应用以及想省掉 API 服务层、文档加图谱加检索一个实例全做的中小项目。适合嵌入式与边缘场景单个 Rust 二进制可以嵌进应用也能经 WebAssembly 跑在浏览器里。谨慎已有成熟的关系库加缓存加搜索的组合、数据模型稳定时迁移成本未必划算建议用真实查询逐条评估。谨慎需要完整托管云服务、或有严格合规审计时先确认核心代码的 BSL 1.1 许可和官方云方案再上。✅ 收尾什么情况下选 SurrealDB如果你想把数据库 API 网关 权限中间件这套组合砍掉一半同时还有图谱关系、实时推送的需求SurrealDB 值得一试——它最契合独立开发者、小团队和实时协作类产品的场景。【免费下载链接】surrealdbA scalable, distributed, collaborative, document-graph database, for the realtime web项目地址: https://gitcode.com/GitHub_Trending/su/surrealdb创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 RELATED READING
延伸阅读
更多一线实战笔记与深度复盘，助您持续精进
