ExecutionConfig

relationalai.config.config_fields

Configure execution middleware behavior.

This controls client-side middleware features such as metrics/logging and (optionally) automatic retries with exponential backoff.

Examples

Minimal YAML (in raiconfig.yaml):

default_connection: sf
connections:
    sf:
        type: snowflake
        # ...
execution:
    metrics: true
    retries:
        enabled: true
        max_attempts: 5
        base_delay_s: 0.5
        max_delay_s: 10.0

Configure execution settings using a dict:

from relationalai.config import create_config
cfg = create_config(
    execution={
        "metrics": True,
        "retries": {"enabled": True, "max_attempts": 5, "base_delay_s": 0.5, "max_delay_s": 10.0},
    },
)

Configure execution settings using an explicit ExecutionConfig instance:

from relationalai.config import create_config, ExecutionConfig
cfg = create_config(
    execution=ExecutionConfig(
        metrics=True,
        retries=ExecutionConfig.RetriesConfig(enabled=True, max_attempts=5, base_delay_s=0.5, max_delay_s=10.0),
    ),
)

Attributes

.metrics

ExecutionConfig.metrics: bool

Enable execution metrics collection.

.logging

ExecutionConfig.logging: bool

Enable structured execution logging.

.retries

ExecutionConfig.retries: ExecutionConfig.RetriesConfig

Retry and backoff policy.

Inheritance Hierarchy

Referenced By

RelationalAI Documentation
└──  Build With RelationalAI
    └──  Understand how PyRel works > Configure PyRel
        └──  Configure execution behavior
            ├──  Enable or disable execution logs
            └──  Enable or disable metrics collection