> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# إعداد DataStore

> إعداد محرك تنفيذ DataStore، والتسجيل، والتخزين المؤقت، والتنميط

يوفّر DataStore خيارات إعداد شاملة لاختيار محرك التنفيذ، ووضع التوافق، والتسجيل، والتخزين المؤقت، والتنميط، وتصحيح نوع البيانات.

<div id="quick-reference">
  ## مرجع مختصر
</div>

```python theme={null}
from chdb.datastore.config import config

# Quick setup presets
config.enable_debug()           # Enable verbose logging
config.use_chdb()               # Force ClickHouse engine
config.use_pandas()             # Force pandas engine
config.use_auto()               # Auto-select engine (default)
config.use_performance_mode()   # SQL-first, max throughput
config.use_pandas_compat()      # Full pandas compatibility (default)
config.enable_profiling()       # Enable performance profiling
```

<div id="all-options">
  ## جميع خيارات الإعداد
</div>

| الفئة              | الخيار                   | القيم                         | الافتراضي | الوصف                                          |
| ------------------ | ------------------------ | ----------------------------- | --------- | ---------------------------------------------- |
| **التسجيل**        | `log_level`              | DEBUG/INFO/WARNING/ERROR      | WARNING   | مستوى تفصيل السجل                              |
|                    | `log_format`             | "simple", "verbose"           | "simple"  | تنسيق رسائل السجل                              |
| **التخزين المؤقت** | `cache_enabled`          | True/False                    | True      | تمكين التخزين المؤقت للنتائج                   |
|                    | `cache_ttl`              | float (ثوانٍ)                 | 0.0       | مدة بقاء التخزين المؤقت                        |
| **المحرك**         | `execution_engine`       | "auto", "chdb", "pandas"      | "auto"    | محرك التنفيذ                                   |
|                    | `cross_datastore_engine` | "auto", "chdb", "pandas"      | "auto"    | عمليات Cross-DataStore                         |
| **التوافق**        | `compat_mode`            | "pandas", "performance"       | "pandas"  | توافق Pandas مقابل الإنتاجية المتمحورة حول SQL |
| **التنميط**        | `profiling_enabled`      | True/False                    | False     | تمكين التنميط                                  |
| **نوع البيانات**   | `correction_level`       | NONE/CRITICAL/HIGH/MEDIUM/ALL | HIGH      | مستوى تصحيح نوع البيانات                       |

***

<div id="methods">
  ## طرق الإعداد
</div>

<div id="logging">
  ### إعدادات التسجيل
</div>

```python theme={null}
from chdb.datastore.config import config
import logging

# Set log level
config.set_log_level(logging.DEBUG)
config.set_log_level(logging.INFO)
config.set_log_level(logging.WARNING)  # Default
config.set_log_level(logging.ERROR)

# Set log format
config.set_log_format("simple")   # Default
config.set_log_format("verbose")  # More details

# Quick enable debug mode
config.enable_debug()  # Sets DEBUG level + verbose format
```

راجع [التسجيل](/ar/products/chdb/debugging/logging) للاطّلاع على التفاصيل.

<div id="cache">
  ### إعداد التخزين المؤقت
</div>

```python theme={null}
# Enable/disable caching
config.set_cache_enabled(True)   # Default
config.set_cache_enabled(False)  # Disable caching

# Set cache TTL (time-to-live)
config.set_cache_ttl(60.0)  # Cache expires after 60 seconds
config.set_cache_ttl(0.0)   # No expiration (default)

# Check current settings
print(config.cache_enabled)
print(config.cache_ttl)
```

<div id="engine">
  ### إعدادات المحرك
</div>

```python theme={null}
# Set execution engine
config.set_execution_engine('auto')    # Auto-select (default)
config.set_execution_engine('chdb')    # Force ClickHouse
config.set_execution_engine('pandas')  # Force pandas

# Quick presets
config.use_auto()     # Auto-select
config.use_chdb()     # Force ClickHouse
config.use_pandas()   # Force pandas

# Cross-DataStore engine (for operations between different DataStores)
config.set_cross_datastore_engine('auto')
config.set_cross_datastore_engine('chdb')
config.set_cross_datastore_engine('pandas')

# Check current engine
print(config.execution_engine)
```

راجع [محرك التنفيذ](/ar/products/chdb/configuration/execution-engine) لمزيد من التفاصيل.

<div id="compat-mode">
  ### وضع التوافق
</div>

```python theme={null}
# Performance mode: SQL-first, no pandas compatibility overhead
config.use_performance_mode()
# or: config.set_compat_mode('performance')

# Pandas compatibility mode (default)
config.use_pandas_compat()
# or: config.set_compat_mode('pandas')

# Check current mode
print(config.compat_mode)  # 'pandas' or 'performance'
```

راجع [وضع الأداء](/ar/products/chdb/configuration/performance-mode) لمزيد من التفاصيل.

<div id="profiling">
  ### إعدادات التنميط
</div>

```python theme={null}
# Enable profiling
config.enable_profiling()
config.set_profiling_enabled(True)

# Disable profiling
config.set_profiling_enabled(False)

# Check if profiling is enabled
print(config.profiling_enabled)
```

راجع [التنميط](/ar/products/chdb/debugging/profiling) لمزيد من التفاصيل.

<div id="dtype">
  ### تصحيح نوع البيانات (Dtype)
</div>

```python theme={null}
from chdb.datastore.dtype_correction.config import CorrectionLevel

# Set correction level
config.set_correction_level(CorrectionLevel.NONE)      # No correction
config.set_correction_level(CorrectionLevel.CRITICAL)  # Critical types only
config.set_correction_level(CorrectionLevel.HIGH)      # Default
config.set_correction_level(CorrectionLevel.MEDIUM)    # More corrections
config.set_correction_level(CorrectionLevel.ALL)       # All corrections
```

***

<div id="config-object">
  ## استخدام الكائن config
</div>

الكائن `config` هو كائن مفرد يدير جميع الإعدادات:

```python theme={null}
from chdb.datastore.config import config

# Read settings
print(config.log_level)
print(config.execution_engine)
print(config.cache_enabled)
print(config.profiling_enabled)

# Modify settings
config.set_log_level(logging.DEBUG)
config.set_execution_engine('chdb')
config.set_cache_enabled(False)
config.enable_profiling()
```

***

<div id="in-code">
  ## الإعداد في الشيفرة
</div>

<div id="per-script">
  ### الإعداد لكل نص برمجي
</div>

```python theme={null}
from chdb import datastore as pd
from chdb.datastore.config import config

# Configure at script start
config.enable_debug()
config.use_chdb()
config.enable_profiling()

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

<div id="context-manager">
  ### مدير السياق (مستقبلًا)
</div>

```python theme={null}
# Planned feature: temporary configuration
with config.override(execution_engine='pandas'):
    result = ds.process()
# Original settings restored
```

***

<div id="scenarios">
  ## سيناريوهات الإعداد الشائعة
</div>

<div id="dev-config">
  ### التطوير/تصحيح الأخطاء
</div>

```python theme={null}
from chdb.datastore.config import config

config.enable_debug()        # Verbose logging
config.enable_profiling()    # Performance tracking
config.set_cache_enabled(False)  # Disable caching for fresh results
```

<div id="prod-config">
  ### بيئة الإنتاج
</div>

```python theme={null}
from chdb.datastore.config import config
import logging

config.set_log_level(logging.WARNING)  # Minimal logging
config.set_execution_engine('auto')    # Optimal engine selection
config.set_cache_enabled(True)         # Enable caching
config.set_profiling_enabled(False)    # Disable profiling overhead
```

<div id="max-throughput-config">
  ### أقصى إنتاجية
</div>

```python theme={null}
from chdb.datastore.config import config

config.use_performance_mode()    # SQL-first, no pandas overhead
config.set_cache_enabled(False)  # Disable cache for streaming
```

<div id="perf-config">
  ### اختبار الأداء
</div>

```python theme={null}
from chdb.datastore.config import config

config.use_chdb()            # Force ClickHouse for benchmarks
config.enable_profiling()    # Track performance
config.set_cache_enabled(False)  # Disable cache for accurate timing
```

<div id="compat-config">
  ### اختبار التوافق مع Pandas
</div>

```python theme={null}
from chdb.datastore.config import config

config.use_pandas()          # Force pandas engine
config.enable_debug()        # See what operations are used
```

***

<div id="related">
  ## وثائق ذات صلة
</div>

* [محرك التنفيذ](/ar/products/chdb/configuration/execution-engine) - تفاصيل اختيار المحرك
* [وضع الأداء](/ar/products/chdb/configuration/performance-mode) - وضع SQL أولًا لتحقيق أقصى إنتاجية
* [إعداد الدالة](/ar/products/chdb/configuration/function-config) - إعداد المحرك لكل دالة
* [التسجيل](/ar/products/chdb/debugging/logging) - إعدادات التسجيل
* [التنميط](/ar/products/chdb/debugging/profiling) - تنميط الأداء