인덱스

DocStore 인덱스는 컬렉션 옆의 .storh/indexes 아래에 저장됩니다. 일반 파일이며 레코드에서만 파생되므로 언제든 다시 빌드할 수 있습니다. 유창한 방식이나 스키마를 통해 선언하세요:

$docs->indexes()
    ->field('slug')->unique()
    ->field('kind')
    ->field('publishedAt')->range()
    ->sync();

인덱스 유형:

• kind 또는 status 같은 필드에 대한 동등성 인덱스: 고유 값마다 파일 하나를 사용하므로 해당 값 파일만 읽어 개별 조회합니다.
• slug 같은 필드에 대한 고유 인덱스: 쓰기 시 고유성을 적용하며 중복 값이 있으면 쓰기 전에 put()이 실패합니다.
• 스칼라 값에 대한 범위 인덱스: 희소 탐색 체크포인트가 있는 정렬 파일로, gt, gte, lt, lte, between 및 prefix을 처리합니다.

범위 인덱스는 인덱스 순서를 사용해 같은 필드의 orderBy도 limit로 처리할 수 있습니다. 결과 전체를 메모리에 올려 정렬할 필요 없이 오름차순이나 내림차순으로 처리합니다.

쿼리에서 고유하지 않은 동등성 인덱스 필드에 대한 eq 조건자를 두 개 결합하면 storh은 해당 필드 쌍에 자동 복합 버킷을 사용할 수 있습니다. 별도의 인덱스 선언 없이도 선택적인 2개 필드 필터를 빠르게 처리합니다.

일관성 및 복구

쓰기 잠금 아래에서 레코드 파일을 원자적으로 교체한 후 인덱스 항목을 업데이트하므로 레코드와 인덱스가 함께 변경됩니다. verify()은 전체 레코드 스캔 결과와 모든 인덱스를 비교해 불일치를 보고합니다. reindex()은 레코드 파일에서 설정된 모든 인덱스를 다시 빌드하고, repair()는 손상된 레코드를 격리한 다음 인덱스를 다시 빌드합니다.

$docs->reindex();

$plan = $docs
    ->query()
    ->where('slug')->eq('home')
    ->explain();

explain()은 쿼리 계획자가 설정된 인덱스를 사용할 수 있으면 index_scan을 반환하고, 그렇지 않으면 full_scan를 반환합니다.