SurrealDB 完整实战：用 1 个数据库搞定文档、图与实时协作

SurrealDB 完整实战用 1 个数据库搞定文档、图与实时协作【免费下载链接】surrealdbA scalable, distributed, collaborative, document-graph database, for the realtime web项目地址: https://gitcode.com/GitHub_Trending/su/surrealdb你正在做一个实时协作应用文档要放一个文档库关系表要放一个关系库推荐关系还得再上一个图库外加自己写 API 和行级权限逻辑。三套进程、三套连接池、一个只为鉴权存在的后端服务光画架构图就让人头大。SurrealDB 是一个用 Rust 编写的多模型数据库把你应用里的文档、关系、图、键值数据全部收进一个引擎处理。核心关键词SurrealDB 多模型数据库、文档图数据库、实时 Live 查询、行级权限控制、单二进制部署长尾关键词SurrealDB 快速入门、SurrealDB Docker 部署教程、SurrealQL 语法示例、SurrealDB 实时同步、多模型数据库怎么选、SurrealDB 嵌入式用法、SurrealDB 与多库方案对比 它到底动了什么把三种数据库塞进同一个引擎一句话原理SurrealDB 不是把 3 个数据库粘在一起的壳而是一个 Rust 二进制文件引擎原生存储文档、关系、图、键值、地理和向量数据还内置了 HTTP/WebSocket API 层与行级权限。它改的是你要维护几套数据库而不是你怎么写查询——你写的仍然像 SQL只是这门语言叫 SurrealQL。接入前后的差异10 秒看懂场景传统做法引入 SurrealDB 后数据存储文档 关系 图三套进程1 个二进制、1 套表查询方式3 种查询语言来回切换SurrealQL 全包图遍历用-API 与鉴权单独写后端服务 权限中间件内置 HTTP/WebSocket 接口行级权限前端同步轮询或自己写 websocketLive 查询实时推送数据变化部署方式多个容器 编排1 个surreal二进制还能嵌进应用最常碰到的只有两个参数启动时选存储引擎memory进程内存开发用和rocksdb持久化以及--user/--pass设置 root 账号。其余功能等你跑通后再说。原理看清了下面动手跑起来。 从零跑通10 分钟连上第一个库第一步拿到并启动最顺的路径是直接用 Docker 跑官方镜像把 8000 端口映射出来docker run --rm -p 8000:8000 --name surrealdb surrealdb/surrealdb:latest start --log info --user root --pass root memory怎么确认成功终端日志最后一行出现Started server没有红色报错服务就在127.0.0.1:8000上待命了。第二步打开图形界面浏览器直接访问http://127.0.0.1:8000。SurrealDB 自带一个叫 Surrealist 的 Web 界面上图就是它不需要再装任何工具。校验方法页面能看到表列表和 Query 输入框就说明连上了。第三步写第一条查询在 Query 面板输入下面两行并运行CREATE person SET name Ada, role engineer; SELECT * FROM person;怎么确认成功第二行返回一条 JSON 记录其中id形如person:xxxx是自动生成的。把 SELECT 后面加上LIVE再跑另一个连接写入数据时你会看到结果实时刷新——这就是它主打的实时能力。接口层面它提供三种连接方式HTTP 走普通 CRUDWebSocket 走 JSON-RPC 和 Live 查询用 SDK 嵌入的话甚至不用自己跑服务器。macOS 用户不想用 Docker 的话可以走 Homebrew 装二进制brew install surrealdb/tap/surreal surreal start --user root --pass root memoryWindows 和 Linux 是同一个思路一条命令装好surreal二进制再用start拉起服务三种安装方式的完整说明都在 README.md 里。⚠️memory存储只活在进程内存里重启 Docker 或进程你写的数据全部消失。开发演示够用接近真实使用就换成rocksdb ./data的持久化目录。️ 版本兼容 坑位地图跑通之后真正花时间的是兼容性和坑。先看支持哪些环境环境是否支持备注macOSIntel / Apple Silicon✅brew 一条命令另有 nightly 版Linux x86_64 / ARM64✅官方安装脚本或 DockerWindows 10/1164 位✅一行安装脚本或 Docker32 位系统❌无 32 位构建可用 WASM 版替代浏览器WASM✅前端直接执行查询无需本地安装嵌入式调用✅Rust、JS、Python、Go、.NET 等官方 SDK旧版本数据目录⚠️先跑surreal upgrade迁移再启动更新后失效怎么办新版启动报数据目录格式不匹配时两步恢复运行surreal upgrade ./data把旧版数据目录迁移到当前格式用start rocksdb ./data重启服务检查日志里有无 schema 或索引相关警告。⚠️ 执行 upgrade 之前先给./data目录做个备份压缩复制一份即可这一步不可逆。32 位 vs 64 位一句话规则SurrealDB 只提供 64 位构建x86_64 与 ARM6432 位系统不在支持范围。用uname -m判断你的机器输出x86_64或aarch64/arm64就按常规装输出i686或armv7l就改用浏览器 WASM 版或直接使用托管服务。还有三个高频坑看到都能两分钟内解决8000 端口被占用终端报address already in use时给启动命令加--port 8010换个端口即可SCHEMAFULL 表丢字段DEFINE FIELD没声明过的字段写入时会被静默丢弃从 schemaless 表迁数据时要先补全字段定义忘了鉴权HTTP 接口需要携带 root 或账户 token请求返回 401 基本都是 token 没带上。 用前必做升级前备份数据目录先在测试环境验证查询开 --log info 盯错误SurrealDB 是一个既能单进程跑、也能扩成分布式集群的多模型数据库适合想把数据库数量从好几个砍到一个、做实时应用、AI 数据层或知识图谱的团队。延伸阅读仓库内文档README.md安装方式与功能速览language-tests/tests/大量 SurrealQL 测试用例可当语法参考doc/BUILDING.md想从源码构建时的操作说明【免费下载链接】surrealdbA scalable, distributed, collaborative, document-graph database, for the realtime web项目地址: https://gitcode.com/GitHub_Trending/su/surrealdb创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考