概览
- 查询语言
- SurrealQL
- 驱动
- 首次使用时下载
- 连接方式
- 主机和端口, SSH 隧道, SSL/TLS
- 默认端口
- 8000
- 最低版本
- 2.0,强制执行:拒绝旧版服务器


连接和登录
选择 认证级别 (Auth Level):Root、Namespace、Database、Record Access 或 Token。Namespace 和 Database 需要填写其名称,Record Access 还需要访问方式和登录字段,Token 接受已有的 JWT。
驱动通过 HTTP RPC 端点传输 CBOR,因此记录链接、日期时间、时长、小数和 UUID 都保留其类型。surrealdb:// 链接会打开已填好的连接表单。
SSL 默认为 Disabled,即明文 HTTP;其他所有模式都使用 HTTPS。Verify CA 和 Verify Identity 对照系统信任库验证证书,并忽略 SSL/TLS 面板中设置的 CA 文件,因此请先在 macOS 中安装私有 CA。
SurrealQL 和记录
运行完整的 SurrealQL 脚本(包括 RELATE),支持语句补全。Explain 和 Explain Full 使用 EXPLAIN 运行查询,并返回文本计划。
命名空间位于侧边栏顶层,其中包含各自的数据库。切换两者都不会重新连接,因为它们随每个请求发送;只有根用户能看到所有命名空间。
单元格编辑以带类型的参数仅更新已更改的字段,因此计算得出的 FUTURE 字段和其他写入者的更改都会保留。将 id 留空即可自动生成 ID;SCHEMALESS 表的列来自已获取的记录。
筛选会转换为 SurrealQL,Raw SQL 行接受一个条件,例如图遍历。会写入、包含 ; 或注释,或调用 fn:: 或 http:: 的条件会被拒绝;请在编辑器中运行它。
Structure
Structure 标签页只读:请在编辑器中用 DEFINE FIELD 和 DEFINE INDEX 创建和修改字段及索引。命名空间或数据库可从其菜单删除,多选时只会对全部项目确认一次。
本页介绍 SurrealDB 特有的内容。Safe Mode、AI 助手、MCP 服务器以及 TablePro 的其他功能请见功能页面。
其他
移动数据
不提供导入。将表或 SurrealQL 结果导出为 CSV、JSON、SQL、XLSX、Markdown、HTML 和 XML。
限制
- 编辑器不对 SurrealQL 提供语法高亮。
- 不支持实时查询。请重新运行查询查看新记录。
可以运行事务吗?
在单个查询内可以。HTTP RPC 不会在请求之间保留事务,因此请将
BEGIN TRANSACTION; … COMMIT TRANSACTION;作为一条编辑器查询发送。如何修改关系的 in 或 out?
无法从网格修改:保存会停止,指出该字段,并保留所有待处理的编辑。
UPDATE也不会移动关系,因此请删除它,再用RELATE关联新的一对记录。