DataStore 구성

DataStore 실행 엔진, 로깅, 캐싱, 프로파일링 및 Dtype 보정을 구성합니다

DataStore는 실행 엔진 선택, 호환성 모드, 로깅, 캐싱, 프로파일링, Dtype 보정을 위한 다양한 구성 옵션을 제공합니다.

​

빠른 참고

from chdb.datastore.config import config

# 빠른 설정 프리셋
config.enable_debug()           # 상세 로깅 활성화
config.use_chdb()               # ClickHouse 엔진 강제 사용
config.use_pandas()             # pandas 엔진 강제 사용
config.use_auto()               # 엔진 자동 선택 (기본값)
config.use_performance_mode()   # SQL 우선, 최대 처리량
config.use_pandas_compat()      # 완전한 pandas 호환성 (기본값)
config.enable_profiling()       # 성능 프로파일링 활성화

​

모든 구성 옵션

범주	옵션	값	기본값	설명
로깅	log_level	DEBUG/INFO/WARNING/ERROR	WARNING	로그 상세 수준
	log_format	”simple”, “verbose"	"simple”	로그 메시지 포맷
캐시	cache_enabled	True/False	True	결과 캐싱 활성화
	cache_ttl	float (seconds)	0.0	캐시 TTL
엔진	execution_engine	”auto”, “chdb”, “pandas"	"auto”	실행 엔진
	cross_datastore_engine	”auto”, “chdb”, “pandas"	"auto”	DataStore 간 작업
호환성	compat_mode	”pandas”, “performance"	"pandas”	Pandas 호환성 또는 SQL 우선 처리량
프로파일링	profiling_enabled	True/False	False	프로파일링 활성화
Dtype	correction_level	NONE/CRITICAL/HIGH/MEDIUM/ALL	HIGH	Dtype 보정 수준

---

​

구성 방법

​

로깅 구성

from chdb.datastore.config import config
import logging

# 로그 레벨 설정
config.set_log_level(logging.DEBUG)
config.set_log_level(logging.INFO)
config.set_log_level(logging.WARNING)  # 기본값
config.set_log_level(logging.ERROR)

# 로그 포맷 설정
config.set_log_format("simple")   # 기본값
config.set_log_format("verbose")  # 더 자세한 정보 표시

# 디버그 모드 빠르게 활성화
config.enable_debug()  # DEBUG 레벨과 verbose 포맷으로 설정

자세한 내용은 로깅 문서를 참조하십시오.

​

캐시 구성

# 캐싱 활성화/비활성화
config.set_cache_enabled(True)   # 기본값
config.set_cache_enabled(False)  # 캐싱 비활성화

# 캐시 TTL(time-to-live) 설정
config.set_cache_ttl(60.0)  # 60초 후 캐시 만료
config.set_cache_ttl(0.0)   # 만료 없음 (기본값)

# 현재 설정 확인
print(config.cache_enabled)
print(config.cache_ttl)

​

엔진 구성

# 실행 엔진 설정
config.set_execution_engine('auto')    # 자동 선택 (기본값)
config.set_execution_engine('chdb')    # ClickHouse 강제 사용
config.set_execution_engine('pandas')  # pandas 강제 사용

# 빠른 프리셋
config.use_auto()     # 자동 선택
config.use_chdb()     # ClickHouse 강제 사용
config.use_pandas()   # pandas 강제 사용

# Cross-DataStore 엔진 (서로 다른 DataStore 간 작업에 사용)
config.set_cross_datastore_engine('auto')
config.set_cross_datastore_engine('chdb')
config.set_cross_datastore_engine('pandas')

# 현재 엔진 확인
print(config.execution_engine)

자세한 내용은 실행 엔진을 참고하십시오.

​

호환성 모드

# 성능 모드: SQL 우선, pandas 호환성 오버헤드 없음
config.use_performance_mode()
# 또는: config.set_compat_mode('performance')

# Pandas 호환성 모드 (기본값)
config.use_pandas_compat()
# 또는: config.set_compat_mode('pandas')

# 현재 모드 확인
print(config.compat_mode)  # 'pandas' 또는 'performance'

자세한 내용은 성능 모드를 참조하십시오.

​

프로파일링 구성

# 프로파일링 활성화
config.enable_profiling()
config.set_profiling_enabled(True)

# 프로파일링 비활성화
config.set_profiling_enabled(False)

# 프로파일링 활성화 여부 확인
print(config.profiling_enabled)

자세한 내용은 프로파일링을 참조하십시오.

​

Dtype 보정

from chdb.datastore.dtype_correction.config import CorrectionLevel

# 보정 수준 설정
config.set_correction_level(CorrectionLevel.NONE)      # 보정 없음
config.set_correction_level(CorrectionLevel.CRITICAL)  # 중요 타입만
config.set_correction_level(CorrectionLevel.HIGH)      # 기본값
config.set_correction_level(CorrectionLevel.MEDIUM)    # 추가 보정
config.set_correction_level(CorrectionLevel.ALL)       # 모든 보정

---

​

config 객체 사용하기

config 객체는 모든 설정을 관리하는 단일 인스턴스입니다:

from chdb.datastore.config import config

# 설정 읽기
print(config.log_level)
print(config.execution_engine)
print(config.cache_enabled)
print(config.profiling_enabled)

# 설정 수정
config.set_log_level(logging.DEBUG)
config.set_execution_engine('chdb')
config.set_cache_enabled(False)
config.enable_profiling()

---

​

코드 내 구성

​

스크립트별 구성

from chdb import datastore as pd
from chdb.datastore.config import config

# 스크립트 시작 시 구성
config.enable_debug()
config.use_chdb()
config.enable_profiling()

# DataStore 코드
ds = pd.read_csv("data.csv")
result = ds.filter(ds['age'] > 25).groupby('city').agg({'salary': 'mean'})

​

Context Manager(향후 지원)

# 계획된 기능: 임시 구성
with config.override(execution_engine='pandas'):
    result = ds.process()
# 원래 설정 복원됨

---

​

일반적으로 사용되는 구성 시나리오

​

개발/디버깅

from chdb.datastore.config import config

config.enable_debug()        # 상세 로깅
config.enable_profiling()    # 성능 추적
config.set_cache_enabled(False)  # 최신 결과를 위해 캐싱 비활성화

​

프로덕션 환경

from chdb.datastore.config import config
import logging

config.set_log_level(logging.WARNING)  # 최소 로깅
config.set_execution_engine('auto')    # 최적 엔진 선택
config.set_cache_enabled(True)         # 캐싱 활성화
config.set_profiling_enabled(False)    # 프로파일링 오버헤드 비활성화

​

최대 처리량

from chdb.datastore.config import config

config.use_performance_mode()    # SQL 우선, pandas 오버헤드 없음
config.set_cache_enabled(False)  # 스트리밍용 캐시 비활성화

​

성능 테스트

from chdb.datastore.config import config

config.use_chdb()            # 벤치마크를 위해 ClickHouse 강제 사용
config.enable_profiling()    # 성능 추적
config.set_cache_enabled(False)  # 정확한 시간 측정을 위해 캐시 비활성화

​

Pandas 호환성 테스트

from chdb.datastore.config import config

config.use_pandas()          # pandas 엔진 강제 사용
config.enable_debug()        # 사용되는 작업 확인

---

​

관련 문서

• 실행 엔진 - 엔진 선택에 대한 자세한 정보
• 성능 모드 - 최대 처리량을 위한 SQL 우선 모드
• 함수 구성 - 함수별 엔진 구성
• 로깅 - 로깅 구성
• 프로파일링 - 성능 프로파일링