NoSQL とドキュメント ストア
MongoDB 互換のドキュメント指向データベース エンジン。柔軟な JSON データ構造を保存し、コレクションにインデックスを付け、複雑な集計パイプラインを実行します。
Aurabase ドキュメント ストア#
PostgreSQL リレーショナル エンジンに加えて、Aurabase を使用すると、プロジェクトごとに分離された NoSQL ドキュメント ストア エンジンをアクティブ化できます。 Aurabase インフラストラクチャ (バックアップ、アクセス制御、可観測性) の堅牢性を備えた半構造化ドキュメントの柔軟性を提供します。
イベントの追跡/分析、異種属性を持つ製品カタログ、リアルタイム テレメトリ、およびユーザー セッションには、NoSQL エンジンを選択してください。
収集業務#
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 — « 読み取りが拒否されました: 所有者ごとの分離を適用するユーザー ID がありません » — で拒否されます。 service_role キーは分離をバイパスします。
コレクションを誰でも読み取れるようにするには、コレクションを Studio > データベース で開き、 パブリック をクリックします (書き込みは所有者ごとに分離されたままになり、所有者フィールドは返されません)。同じスイッチは、コンソール トークン ( PUT /v1/db/{project_id}/schema/tables/{collection}/public-read と {"public_read": true}) を使用して管理プレーンで使用できます。
生産用に最適化されたエンジン#
- 柔軟なスキーマ。 動的 JSON/BSON ドキュメント。ログ、電子商取引カタログ、IoT テレメトリ、および非標準プロファイルに最適です。
- クエリ演算子。
$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) を識別できます。
{
"queryPlanner": {
"winningPlan": {
"stage": "IXSCAN",
"indexName": "metadata.country_1_timestamp_-1",
"keysExamined": 42,
"docsExamined": 42
},
"executionTimeMillis": 1.2
}
}
PostgreSQL vs NoSQL: どちらのエンジンを選択しますか?#
| 基準 | PostgreSQL (リレーショナル) | ドキュメント ストア (NoSQL) |
|---|---|---|
| 構造 | 厳密なスキーマ、バージョン管理された移行 | 厳格な制約のない動的スキーマ |
| 関係と結合 | SQL 結合と外部キー | ネストされたドキュメントまたは非正規化されたドキュメント |
| アクセス制御 | SQL の宣言的な行レベルのセキュリティ (RLS) | コレクションおよびロールトークンによるアクセス許可 |
| ベクトル検索 | HNSW を使用したネイティブ pgvector | 属性とテキストインデックスによるフィルタリング |
| こんな方に最適 | コアバンキング、B2B SaaS、権利管理 | ログ、動的カタログ、IoT、イベント |