서버 응답 캐싱 - CoreWeave Docs

Weave는 서버 응답 캐싱을 제공하여, 동일한 쿼리를 반복 수행하거나 네트워크 대역폭이 제한된 환경에서 작업할 때 성능이 향상되도록 합니다. 이 기능은 현재 기본적으로 비활성화되어 있지만, 향후 릴리스에서 기본 동작으로 적용될 예정입니다.

캐싱을 사용해야 하는 경우

서버 응답 캐싱은 특히 다음과 같은 경우에 유용합니다.

동일한 쿼리를 자주 실행하는 경우
네트워크 대역폭이 제한된 경우
지연 시간이 긴 환경에서 작업하는 경우
오프라인으로 개발하면서 나중에 사용할 수 있도록 응답을 캐시하려는 경우

이 기능은 run 간에 데이터셋을 캐시할 수 있으므로, 같은 데이터셋으로 평가를 반복 실행할 때 특히 유용합니다.

캐싱 활성화 방법

캐싱을 활성화하려면 다음 환경 변수를 설정하세요.

# 서버 응답 캐싱 활성화
export WEAVE_USE_SERVER_CACHE=true

# 캐시 크기 제한 설정 (기본값: 1GB)
export WEAVE_SERVER_CACHE_SIZE_LIMIT=1000000000

# 캐시 디렉터리 설정 (선택 사항, 기본값: 임시 디렉터리)
export WEAVE_SERVER_CACHE_DIR=/path/to/cache

캐싱 동작

기술적으로 설명하면, 이 기능은 서버로 보내는 멱등(idempotent) 요청을 캐시합니다. 캐시되는 요청은 다음과 같습니다.

obj_read
table_query
table_query_stats
refs_read_batch
file_content_read

캐시 크기 및 저장소 세부 정보

캐시 크기는 WEAVE_SERVER_CACHE_SIZE_LIMIT(바이트 단위)로 제어합니다. 실제로 사용되는 디스크 공간은 다음 세 가지 컴포넌트로 구성됩니다.

32KB 고정 크기의 체크섬 파일
실행 중인 클라이언트당 최대 약 4MB의 쓰기 전 로그(WAL) 파일(프로그램 종료 시 자동으로 삭제됨)
최소 32KB에서 최대 WEAVE_SERVER_CACHE_SIZE_LIMIT까지의 메인 데이터베이스 파일

사용되는 총 디스크 공간:

실행 중: >= 32KB + 약 4MB + 캐시 크기
종료 후: >= 32KB + 캐시 크기

예를 들어 캐시 한도가 5MB인 경우:

실행 중: 최대 약 9MB
종료 후: 최대 약 5MB

마지막 수정일 2026년 9월 30일