Ir para o conteúdo
Aura Logo
aurabase

NoSQL e armazenamento de documentos

Mecanismo de banco de dados orientado a documentos compatível com MongoDB. Armazene estruturas de dados JSON flexíveis, indexe suas coleções e execute pipelines de agregação complexos.

Explicação9 min lidoNível intermediárioRevisado em 19 de ago. de 2026

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

O armazenamento de documentos Aurabase#

Além do mecanismo relacional PostgreSQL, Aurabase permite ativar um mecanismo NoSQL Document Store isolado por projeto. Oferece a flexibilidade de documentos semiestruturados com a robustez da infraestrutura Aurabase (backups, controle de acesso, observabilidade).

Casos de uso recomendados

Escolha o mecanismo NoSQL para eventos de rastreamento/análise, catálogos de produtos com atributos heterogêneos, telemetria em tempo real e sessões de usuário.

Operações de cobrança#

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(),
  })

Quem pode ler e escrever uma coleção#

O acesso é privado por padrão e isolado por proprietário. Cada documento é carimbado com o usuário que o escreveu, e um usuário conectado apenas lê e grava seus próprios documentos. Uma solicitação sem usuário (somente a chave anon) é recusada com 403 — «Leitura recusada: nenhuma identidade de usuário para aplicar isolamento por proprietário» — a menos que a coleção seja explicitamente tornada legível publicamente. Uma chave service_role ignora o isolamento.

Para tornar uma coleção legível para todos, abra-a em Studio › Banco de dados e clique em Tornar público (as gravações permanecem isoladas por proprietário e o campo proprietário nunca é retornado). O mesmo switch está disponível no plano de gerenciamento, com um token de console: PUT /v1/db/{project_id}/schema/tables/{collection}/public-read com {"public_read": true}.

Motor otimizado para produção#

  • Esquema flexível. Documentos JSON/BSON dinâmicos. Ideal para logs, catálogos de e-commerce, telemetria IoT e perfis não padronizados.
  • Operadores de consulta. $eq, $ne, $gt, $gte, $lt, $lte, $in, $nin, $regex (padrões simples) e $exists, em campos de nível superior e caminhos aninhados, como 'metadata.country'. Um operador que o mecanismo não suporta é rejeitado com um erro explícito, nunca ignorado, portanto, um filtro nunca retorna silenciosamente mais do que você solicitou.
  • Pipelines de agregação. Transformações de várias etapas com $match, $project, $group, $sort, $unwind e cálculos de métricas de streaming.
  • Indexação. Índices de texto simples e compostos para pesquisa de texto completo e índices TTL com eliminação automática de documentos expirados.
  • Explique e crie um perfil. Plano de execução detalhado para cada consulta (COLLSCAN vs IXSCAN, tempo de execução, índices utilizados).
  • API REST e SDK. Acesso direto via endpoints REST /v1/nosql/{collection} (na URL do seu projeto, com seu apikey) ou o SDK @aurabase/aurabase-js.

Otimização de consulta (explicar)#

Chame aura.nosql.collection('events').explain({ type: 'user_signup' }) para obter o plano de um filtro.

Cada consulta pode ser analisada para inspecionar as etapas de execução, identificar se um índice foi solicitado (IXSCAN) ou se ocorreu uma varredura completa (COLLSCAN):

explain-plan.jsonjson
{
  "queryPlanner": {
    "winningPlan": {
      "stage": "IXSCAN",
      "indexName": "metadata.country_1_timestamp_-1",
      "keysExamined": 42,
      "docsExamined": 42
    },
    "executionTimeMillis": 1.2
  }
}

PostgreSQL vs NoSQL: Qual mecanismo escolher?#

CritérioPostgreSQL (relacional)Armazenamento de documentos (NoSQL)
EstruturaEsquema estrito, migrações versionadasEsquema dinâmico sem restrições rígidas
Relações e junçõesJunções SQL e chaves estrangeirasDocumentos aninhados ou desnormalizados
Controle de acessoSegurança declarativa em nível de linha (RLS) em SQLPermissões por coleção e token de função
Pesquisa vetorialpgvector nativo com HNSWFiltrando por atributos e índices de texto
Melhor paraCore banking, SaaS B2B, gerenciamento de direitosLogs, catálogos dinâmicos, IoT, eventos

Para ir mais longe#