> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 서버 응답 캐싱

> Weave 서버 응답 캐싱으로 반복 쿼리 및 제한된 대역폭 환경에서 성능 향상

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

<h2 id="when-to-use-caching">
  캐싱을 사용해야 하는 경우
</h2>

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

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

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

<h2 id="how-to-enable-caching">
  캐싱 활성화 방법
</h2>

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

```bash theme={"system"}
# 서버 응답 캐싱 활성화
export WEAVE_USE_SERVER_CACHE=true

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

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

<h2 id="caching-behavior">
  캐싱 동작
</h2>

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

* `obj_read`
* `table_query`
* `table_query_stats`
* `refs_read_batch`
* `file_content_read`

<h2 id="cache-size-and-storage-details">
  캐시 크기 및 저장소 세부 정보
</h2>

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

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

사용되는 총 디스크 공간:

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

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

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


## Related topics

- [Weave 환경 변수 설정](/ko/products/wandb/weave/guides/core-types/env-vars.md)