跳到内容
光环标志
光环基地

NoSQL 和文档存储

MongoDB 兼容的面向文档的数据库引擎。存储灵活的 JSON 数据结构、为集合建立索引并运行复杂的聚合管道。

说明9分钟 读取级别 中间修改于 2026年8月19日

该页面已自动翻译。英文版具有权威性。

Aurabase 文档存储#

除了 PostgreSQL 关系引擎之外,Aurabase 还允许您激活按项目隔离的 NoSQL 文档存储 引擎。它提供了半结构化文档的灵活性以及 Aurabase 基础设施(备份、访问控制、可观察性)的稳健性。

推荐使用案例

选择 NoSQL 引擎来跟踪/分析事件、具有异构属性的产品目录、实时遥测和用户会话。

收款操作#

nosql-insert.tstypescript
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-js SDK。

查询优化(解释)#

调用 aura.nosql.collection('events').explain({ type: 'user_signup' }) 获取过滤器的计划。

可以分析每个查询以检查执行步骤,确定是否请求了索引 (IXSCAN) 或者是否进行了完整扫描 (COLLSCAN):

explain-plan.jsonjson
{
  "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、权限管理日志、动态目录、物联网、事件

为了走得更远#