クイックリファレンス
from chdb.datastore.config import config
# クイックセットアッププリセット
config.enable_debug() # 詳細ログを有効化
config.use_chdb() # ClickHouse engineを強制使用
config.use_pandas() # pandas engineを強制使用
config.use_auto() # engineを自動選択（デフォルト）
config.use_performance_mode() # SQL優先、最大throughput
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 | cache の有効期限 (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フォーマットを設定する
Cache の設定
# キャッシュの有効化/無効化
config.set_cache_enabled(True) # デフォルト
config.set_cache_enabled(False) # キャッシュを無効化
# cache の有効期限 (TTL) を設定
config.set_cache_ttl(60.0) # 60秒後にcacheが期限切れになる
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 を強制使用
# クロス 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'})
コンテキストマネージャー (今後対応予定)
# 計画中の機能: 一時的な設定
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) # ストリーミング用にcacheを無効化
性能テスト
from chdb.datastore.config import config
config.use_chdb() # ベンチマーク用にClickHouseを強制使用
config.enable_profiling() # パフォーマンスを計測
config.set_cache_enabled(False) # 正確な計測のためcacheを無効化
Pandas 互換性テスト
from chdb.datastore.config import config
config.use_pandas() # pandasエンジンを強制使用
config.enable_debug() # 使用される操作を確認
関連ドキュメント
- 実行エンジン - エンジン選択の詳細
- パフォーマンスモード - 最大スループットを実現する SQL ファーストモード
- 関数設定 - 関数ごとのエンジン設定
- ログ - ログ設定
- プロファイリング - パフォーマンスプロファイリング