성능 모드를 사용하면 실행 엔진이 자동으로
chdb로 설정되므로 config.use_chdb()를 별도로 호출할 필요가 없습니다.다음과 같은 경우 성능 모드를 사용하세요:
- 대규모 데이터셋을 처리하는 경우(수십만~수백만 개의 행)
- 집계 비중이 큰 워크로드를 실행하는 경우(groupby, sum, mean, count)
- 행 순서가 중요하지 않은 경우(예: 집계된 결과, 보고서, 대시보드)
- SQL 처리량을 최대화하고 오버헤드를 최소화하려는 경우
- 메모리 사용량이 우려되는 경우(병렬 Parquet 읽기, 중간 DataFrame 없음)
- pandas의 동작을 정확히 따라야 하는 경우(행 순서, MultiIndex, dtypes)
first()/last()가 실제 첫 번째/마지막 행을 반환해야 하는 경우- 행 순서에 의존하는
shift(),diff(),cumsum()를 사용하는 경우 - DataStore 출력과 pandas를 비교하는 테스트를 작성하는 경우
성능 모드에서는 어떤 작업을 수행하더라도 행 순서가 보장되지 않습니다. 여기에는 다음이 포함됩니다.
- 필터 결과
- GroupBy 집계 결과
- 명시적인
sort_values()없이 사용하는head()/tail() first()/last()집계
sort_values()를 추가하십시오:
ColumnExpr groupby 집계(예: ds[condition].groupby('col')['val'].sum())가 pandas 모드의 2단계 처리 방식 대신 하나의 SQL 쿼리로 실행됩니다:
성능 모드(
compat_mode)와 실행 엔진(execution_engine)은 서로 독립적인 구성 요소입니다:
성능 모드는 SQL 실행용으로 설계되었으므로,
compat_mode='performance'로 설정하면 execution_engine='chdb'도 자동으로 설정됩니다.
성능 모드용 테스트를 작성할 때 결과는 행 순서나 구조적 포맷 면에서 pandas와 다를 수 있습니다. 다음 전략을 사용하세요:
- 실행 엔진 — 엔진 선택(auto/chdb/pandas)
- 성능 가이드 — 전반적인 최적화 팁
- pandas와의 주요 차이점 — 동작상의 차이점