{
  "topic": "config.schema",
  "path": [
    "config",
    "schema"
  ],
  "title": "schema configuration",
  "synopsis": "config.schema — schema-extension log tuning.",
  "body": "# config.schema\n\n## NAME\n\nconfig.schema — schema-extension log tuning.\n\n## SYNOPSIS\n\ncyoda maintains a schema-extension log for tracking model schema changes over time. These\nvariables control savepoint frequency and retry behaviour when extending schemas on storage\nbackends.\n\n## OPTIONS\n\n- `CYODA_SCHEMA_SAVEPOINT_INTERVAL` — number of schema extensions between savepoint rows in\n  the schema-extension log (default: `64`, minimum: `1`). Lower values increase write\n  amplification but reduce recovery time after a crash.\n- `CYODA_SCHEMA_EXTEND_MAX_RETRIES` — plugin-layer retry budget for `ExtendSchema` on\n  backends that support native schema extension with optimistic concurrency\n  (default: `8`, minimum: `1`). Increase if you observe contention under high concurrency.\n\n## EXAMPLES\n\n**High-write workload (more frequent savepoints):**\n\n```\nCYODA_SCHEMA_SAVEPOINT_INTERVAL=16\nCYODA_SCHEMA_EXTEND_MAX_RETRIES=16\n```\n\n**Default:**\n\n```\nCYODA_SCHEMA_SAVEPOINT_INTERVAL=64\nCYODA_SCHEMA_EXTEND_MAX_RETRIES=8\n```\n\n## SEE ALSO\n\n- config\n- models\n- run\n",
  "sections": [
    {
      "name": "NAME",
      "body": "config.schema — schema-extension log tuning."
    },
    {
      "name": "SYNOPSIS",
      "body": "cyoda maintains a schema-extension log for tracking model schema changes over time. These\nvariables control savepoint frequency and retry behaviour when extending schemas on storage\nbackends."
    },
    {
      "name": "OPTIONS",
      "body": "- `CYODA_SCHEMA_SAVEPOINT_INTERVAL` — number of schema extensions between savepoint rows in\n  the schema-extension log (default: `64`, minimum: `1`). Lower values increase write\n  amplification but reduce recovery time after a crash.\n- `CYODA_SCHEMA_EXTEND_MAX_RETRIES` — plugin-layer retry budget for `ExtendSchema` on\n  backends that support native schema extension with optimistic concurrency\n  (default: `8`, minimum: `1`). Increase if you observe contention under high concurrency."
    },
    {
      "name": "EXAMPLES",
      "body": "**High-write workload (more frequent savepoints):**\n\n```\nCYODA_SCHEMA_SAVEPOINT_INTERVAL=16\nCYODA_SCHEMA_EXTEND_MAX_RETRIES=16\n```\n\n**Default:**\n\n```\nCYODA_SCHEMA_SAVEPOINT_INTERVAL=64\nCYODA_SCHEMA_EXTEND_MAX_RETRIES=8\n```"
    },
    {
      "name": "SEE ALSO",
      "body": "- config\n- models\n- run"
    }
  ],
  "see_also": [
    "config",
    "models",
    "run"
  ],
  "stability": "stable",
  "actions": []
}