R2D1 / 문서

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

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

문서 저장소

완전한 문서

권위 있는 직렬화 문서를 저장할 위치를 선택하세요.

R2 DocumentStore →Filesystem DocumentStore →

인덱스 저장소

인덱스 조회

문서 식별자와 인덱스 필드를 투영할 위치를 선택하세요.

D1 IndexStore →JDBC IndexStore →

공통 API

사용법은 동일합니다.

시작하기

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

공통 경로 시작 →

핵심 개념

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

핵심 개념 읽기 →

쿼리

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

쿼리 읽기 →

일관성과 복구

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

일관성 읽기 →

공개 모듈

공개된 네 가지 artifact.

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 설정 →

문서 범위

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

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