R2D1 / 문서

백엔드를 선택한 다음 하나의 API를 사용하세요.

먼저 두 backend 역할을 이해하세요. DocumentStore는 완전한 문서를 소유하고, IndexStore는 인덱스 조회에 사용하는 필드를 소유합니다. 둘 다 설정한 뒤에는 모든 조합에서 같은 컬렉션 API를 사용합니다.

공통 API

사용법은 동일합니다.

시작하기

두 backend 역할을 설정하고 문서를 정의한 뒤 첫 인덱스 쿼리를 실행합니다.

공통 경로 시작 →

핵심 개념

컬렉션, metadata, 권위 있는 문서, 인덱스, cursor를 이해합니다.

핵심 개념 읽기 →

쿼리

인덱스 필드를 필터링하고 정렬한 뒤 opaque cursor 페이지를 이어갑니다.

쿼리 읽기 →

일관성과 복구

부분 실패를 처리하고 권위 있는 문서에서 파생 인덱스를 재구축합니다.

일관성 읽기 →
MODULES & INTEGRATIONS

모듈과 프레임워크 통합.

CORE + CLOUDFLARE

R2D1

dev.nexcraft:r2d1

공통 API와 R2 및 D1 adapter입니다.

구성 →
INDEX STORE

R2D1-JDBC

dev.nexcraft:r2d1-jdbc

H2, HSQLDB, 로컬 SQLite 인덱스 지원입니다.

JDBC 설정 →
DOCUMENT STORE

R2D1-FILESYSTEM

dev.nexcraft:r2d1-filesystem

canonical 로컬 문서 파일입니다.

Filesystem 설정 →
FRAMEWORK INTEGRATION

R2D1-MICRONAUT

dev.nexcraft:r2d1-micronaut

Micronaut 5 bean 및 resource 통합입니다.

Micronaut 설정 →
FRAMEWORK INTEGRATION

R2D1-SPRING-BOOT-STARTER

dev.nexcraft:r2d1-spring-boot-starter

Maven Central에 게시된 1.8.0 Spring Boot 4 starter와 별도 auto-configuration입니다.

Spring Boot 설정 →
FRAMEWORK INTEGRATION

R2D1-QUARKUS

dev.nexcraft:r2d1-quarkus

CDI 설정과 애플리케이션 소유 리소스를 제공하는 Quarkus 3.39.5 확장으로 R2D1 1.8.0에 포함됩니다.

Quarkus 설정 →
문서 범위

예제는 현재 코드에 맞습니다.

backend 페이지는 vendor 설정과 소유권을 설명합니다. 공통 API 페이지는 backend 선택을 바꾸지 않고 컬렉션을 정의하고 변경하고 쿼리하고 복구하는 방법을 설명합니다.