SurrealDB 多模型数据库入门：一个引擎同时支持文档、图与向量搜索的 5 步上手指南

SurrealDB 多模型数据库入门一个引擎同时支持文档、图与向量搜索的 5 步上手指南【免费下载链接】surrealdbA scalable, distributed, collaborative, document-graph database, for the realtime web项目地址: https://gitcode.com/GitHub_Trending/su/surrealdbSurrealDB 是一个用 Rust 编写的多模型数据库把文档、图、关系、时序、地理和键值类型统一在一个引擎里并提供全文、向量、混合检索以及实时订阅能力。它只编译出一个二进制既能当独立服务器跑也能作为嵌入式库放进你的应用。读完本文你会完成安装、启动服务器、写入并查询第一组数据、给表加行级权限以及排查新手最常遇到的启动问题。先解决什么多个数据模型只用一个引擎做应用时常见的尴尬是用户资料适合文档关系链路需要图搜索要倒排索引向量检索又得再引一个服务——多套系统意味着多套同步、多套备份、多套权限。SurrealDB 的主张是把这些放进同一个引擎用同一门类 SQL 的查询语言 SurrealQL 操作并内置实时查询和行级权限让你少写一层后端代码。原理一句话SurrealQL 解析成 AST 后交给核心执行器读写落到可插拔的存储后端内存、RocksDB、SurrealKV权限与校验在同一层执行所以浏览器或客户端直连时数据库也能保证只能看到自己该看的数据。安装 SurrealDB四种方式任选其一安装方式有四种装的都是同一个surreal可执行文件macOS 用 Homebrewbrew install surrealdb/tap/surrealLinux 用官方安装脚本按屏幕提示完成curl --proto https --tlsv1.2 -sSf https://install.surrealdb.com | shWindows 在 PowerShell 中执行iwr https://windows.surrealdb.com -useb | iex不想装命令行工具时用 Docker一条命令拉起服务并映射 8000 端口docker run --rm --pull always --name surrealdb -p 8000:8000 surrealdb/surrealdb:latest start前三条命令分别对应 macOS、Linux、Windows 本机安装都会得到带交互式 SQL 终端的 CLIDocker 方式适合不想污染本机环境的场景容器里同样自带完整 CLI。以上命令均为 README 中给出的官方安装方式。启动第一个服务器写第一组数据最简单的启动方式本地开发数据存内存surreal start --log info --user root --pass root memory这条命令以 info 日志级别启动设置 root 用户密码为 rootmemory表示使用内存后端。服务默认监听 8000 端口HTTP 与 WebSocket 都可用。想换持久化后端用 RocksDB 或 SurrealKV 对应的本地文件/目录路径替换最后的memory参数即可具体写法见 README 安装与运行章节。服务起来之后直接运行surreal会进入交互式终端也可以新开一个终端用surreal sql连接 8000 端口。下面这组语句建议按顺序执行覆盖建表、定义字段、写数据和读取DEFINE TABLE user SCHEMAFULL; DEFINE FIELD name, email ON TABLE user TYPE string; DEFINE INDEX email ON TABLE user COLUMNS email UNIQUE; CREATE user SET name Ada, email adaexample.com; SELECT * FROM user WHERE email adaexample.com;前四句创建带模式校验的user表两个字段限定为字符串email建了唯一索引重复写入会被拒绝。CREATE插入一条记录记录 ID 自动生成SELECT立刻按邮箱查回来。把记录连成图只需一条RELATERELATE user:ada-wrote-article:surrealdb这会创建一条从user:ada指向article:surrealdb的有向边。查询时可以用箭头语法沿关系多跳遍历比如某用户认识的人中再向外找两层SELECT -knows-(? AS f1)-knows-(? AS f2) FROM person:tobie;不需要 JOIN也不需要把中间结果拉回客户端。仓库里还有大量现成的可运行例子可以照着练language-tests 测试集 下有 600 多个.surql文件按 statements、functions、graph、indexes 等主题分类可以直接在交互式终端里执行对照结果。按需进阶权限、实时查询与部署行级权限写在表定义里而不是代码里DEFINE TABLE post SCHEMALESS PERMISSIONS FOR select WHERE published true OR user $auth.id FOR create, update, delete WHERE user $auth.id;含义已发布的文章任何人可读未发布的只有作者$auth.id能读写。权限由数据库在服务端执行客户端拿到什么就只看得到什么浏览器直连也是同一套规则。实时查询让数据变更推到前端通过 SDK 的 live 查询订阅某张表之后任何客户端写入变更都会经 WebSocket 实时推给订阅方支持 JSON Diff/Patch 的增量同步格式适合协作编辑、在线状态这类场景。从客户端连上来各语言驱动Rust、JavaScript/TypeScript、Python、Go、.NET、PHP、Java 等都通过 WebSocket、REST 或二进制协议连到同一个服务端官方驱动指南 说明了三类协议的差异。最轻量的验证方式是用 curl 直接对 HTTP 端点发一条 SurrealQL 查询先确认服务端通了再引入 SDK。想读源码或本地构建仓库是一个 Rust workspace主要 crate 有 surrealdb/core/执行引擎、surrealdb/parser/SurrealQL 解析、surrealdb/kvs 相关存储层 和 surrealdb/server/HTTP/WS 服务层surrealdb 根 crate 是 SDK 入口。本地构建需要 stable 版 Rust流程见 构建文档在仓库根目录执行cargo build --release首次编译依赖较多、耗时较长。排障要点启动后最常见的四个问题端口被占用启动时提示 8000 端口已用用 Docker 的-p改映射或改用其他可用端口并同步修改客户端连接地址。重启后数据没了大概率用的是内存后端memory。开发阶段没问题需要落盘就换成 RocksDB 或 SurrealKV 后端。连接被拒绝或 401启动时指定了--user/--pass的话客户端必须带同一凭据做 root 登录忘了密码就重启服务并重新指定。安装脚本执行失败先确认本机有 curl 和网络代理正常Windows 上请在 PowerShell 而非旧版 CMD 执行。提示内存模式适合演示和测试生产环境请在启动参数中固定使用持久化后端并保留启动命令不变方便重启与扩容时复用。适合谁用下一步做什么如果你需要在一套引擎里同时处理文档、图关系、地理与向量数据并且希望权限和实时同步由数据库层直接提供比如协作类应用、AI 数据层、嵌入式设备端存储SurrealDB 值得优先评估。下一步建议用 Docker 命令把服务拉起来把上文第一组数据的语句完整跑一遍再挑 language-tests 测试集 里一个 graph 或 indexes 目录的文件照做基本就能建立对 SurrealQL 的整体手感。核心关键词SurrealDB 多模型数据库长尾关键词SurrealDB 安装与启动SurrealQL 查询语言入门SurrealDB Docker 部署SurrealDB 实时查询与行级权限SurrealDB 嵌入 Rust 应用【免费下载链接】surrealdbA scalable, distributed, collaborative, document-graph database, for the realtime web项目地址: https://gitcode.com/GitHub_Trending/su/surrealdb创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考