본문으로 건너뛰기
아우라베이스 로고
아우라베이스

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 — « 읽기 거부됨: 소유자별 격리를 적용할 사용자 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-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)컬렉션 및 역할 토큰별 권한
벡터 검색HNSW를 포함한 네이티브 pgvector속성 및 텍스트 인덱스로 필터링
다음에 가장 적합코어뱅킹, B2B SaaS, 권리관리로그, 동적 카탈로그, IoT, 이벤트

더 나아가려면#