NoSQL 和文档存储
MongoDB 兼容的面向文档的数据库引擎。存储灵活的 JSON 数据结构、为集合建立索引并运行复杂的聚合管道。
该页面已自动翻译。英文版具有权威性。
Aurabase 文档存储#
除了 PostgreSQL 关系引擎之外,Aurabase 还允许您激活按项目隔离的 NoSQL 文档存储 引擎。它提供了半结构化文档的灵活性以及 Aurabase 基础设施(备份、访问控制、可观察性)的稳健性。
推荐使用案例
选择 NoSQL 引擎来跟踪/分析事件、具有异构属性的产品目录、实时遥测和用户会话。
收款操作#
typescript
const { data, error } = await aura.nosql
.collection('events')
.insertOne({
type: 'user_signup',
userId: 'usr_9482',
metadata: { country: 'FR', plan: 'pro' },
timestamp: new Date(),
})
谁可以读写集合#
默认情况下,访问权限是私有的,并且每个所有者都是隔离的。每个文档都带有编写该文档的用户的标记,登录用户只能读取和写入自己的文档。没有用户(仅 anon 密钥)的请求会被 403 拒绝 - “读取被拒绝:没有用户身份来应用每个所有者隔离” - 除非该集合明确公开可读。 service_role 密钥绕过隔离。
要使集合可供所有人读取,请在 Studio › 数据库 中打开它,然后单击 公开 (写入对每个所有者保持隔离,并且所有者字段永远不会返回)。管理平面上提供相同的交换机,并具有控制台令牌: PUT /v1/db/{project_id}/schema/tables/{collection}/public-read 和 {"public_read": true}。
针对生产优化的发动机#
- 灵活的模式。 动态 JSON/BSON 文档。非常适合日志、电子商务目录、物联网遥测和非标准化配置文件。
- 查询运算符。
$eq、$ne、$gt、$gte、$lt、$lte、$in、$nin、$regex(简单模式)和$exists,在顶级字段和嵌套路径上,例如'metadata.country'。引擎不支持的运算符会被 拒绝,并显示显式错误,并且永远不会被忽略,因此过滤器永远不会默默地返回超出您要求的内容。 - 聚合管道。 具有 $match、$project、$group、$sort、$unwind 和流式度量计算的多步转换。
- 索引。 用于全文搜索的简单复合文本索引和自动清除过期文档的 TTL 索引。
- 解释和分析。 每个查询的详细执行计划(COLLSCAN 与 IXSCAN、执行时间、使用的索引)。
- REST API 和 SDK。 通过 REST 端点
/v1/nosql/{collection}直接访问(在项目的 URL 上,使用apikey)或@aurabase/aurabase-jsSDK。
查询优化(解释)#
调用 aura.nosql.collection('events').explain({ type: 'user_signup' }) 获取过滤器的计划。
可以分析每个查询以检查执行步骤,确定是否请求了索引 (IXSCAN) 或者是否进行了完整扫描 (COLLSCAN):
json
{
"queryPlanner": {
"winningPlan": {
"stage": "IXSCAN",
"indexName": "metadata.country_1_timestamp_-1",
"keysExamined": 42,
"docsExamined": 42
},
"executionTimeMillis": 1.2
}
}
PostgreSQL 与 NoSQL:选择哪个引擎?#
| 标准 | PostgreSQL(关系) | 文档存储 (NoSQL) |
|---|---|---|
| 结构 | 严格的架构、版本化迁移 | 无严格约束的动态模式 |
| 关系和连接 | SQL 连接和外键 | 嵌套或非规范化文档 |
| 访问控制 | SQL 中的声明性行级安全性 (RLS) | 按集合和角色令牌划分的权限 |
| 矢量搜索 | 本机 pgvector 与 HNSW | 按属性和文本索引过滤 |
| 最适合 | 核心银行、B2B SaaS、权限管理 | 日志、动态目录、物联网、事件 |