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.
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).
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#
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 seuapikey) 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):
{
"queryPlanner": {
"winningPlan": {
"stage": "IXSCAN",
"indexName": "metadata.country_1_timestamp_-1",
"keysExamined": 42,
"docsExamined": 42
},
"executionTimeMillis": 1.2
}
}
PostgreSQL vs NoSQL: Qual mecanismo escolher?#
| Critério | PostgreSQL (relacional) | Armazenamento de documentos (NoSQL) |
|---|---|---|
| Estrutura | Esquema estrito, migrações versionadas | Esquema dinâmico sem restrições rígidas |
| Relações e junções | Junções SQL e chaves estrangeiras | Documentos aninhados ou desnormalizados |
| Controle de acesso | Segurança declarativa em nível de linha (RLS) em SQL | Permissões por coleção e token de função |
| Pesquisa vetorial | pgvector nativo com HNSW | Filtrando por atributos e índices de texto |
| Melhor para | Core banking, SaaS B2B, gerenciamento de direitos | Logs, catálogos dinâmicos, IoT, eventos |