[robfrank]

Documents ArcadeData/arcadedb#11475 (PR ArcadeData/arcadedb#11545), shipping in 26.12.1.

Changes

• how-to/data-modeling/materialized-views.adoc: new "Per-record views" section under INCREMENTAL. It covers:

  • which queries qualify;
  • the _sourceRID column and its UNIQUE index;
  • link and edge columns that refresh only with their own row;
  • the delta cap;
  • failure recovery on the scheduler;
  • the ALTER ... REFRESH INCREMENTAL upgrade;
  • the downgrade and re-upgrade case;
  • a warning to run REFRESH MATERIALIZED VIEW after a crash or a leader change (Materialized view: per-record views do not self-heal after a crash or a leader failover arcadedb#11550).

  The stale "per-record is planned for a future release" lines are replaced, and the isSimpleQuery() comment no longer claims it means per-record.

• reference/sql/sql-materialized-views.adoc: CREATE ... REFRESH INCREMENTAL points to per-record views. ALTER ... REFRESH INCREMENTAL describes the upgrade and what a failed upgrade leaves.

• reference/settings.adoc: new materializedViewPerRecordMaxDelta (Integer, default 10000).

python3 docs-validator.py passes.

Added 2026-11-12

• Materialized view: an undeclared _sourceRID field on a schemaless source collides with the per-record link column arcadedb#11552 (PR fix(#11552): _sourceRID is a reserved column of a per-record materialized view; the link always wins arcadedb#11554): _sourceRID is reserved on a per-record view; the link always wins over a source field of that name.
• Materialized view: per-record views do not self-heal after a crash or a leader failover arcadedb#11550 (PR fix(#11550): per-record materialized views self-heal after a crash or a leader failover arcadedb#11558): the "run REFRESH after a crash or leader change" warning is replaced by the automatic recovery (open after an unclean shutdown, new Raft leader); the remaining HA gap is Materialized view: per-record views of a database opened after a leader change are not recovered arcadedb#11555.

🤖 Generated with Claude Code

[mergify]

Tick the box to add this pull request to the merge queue (same as @mergifyio queue). If it does not match the queue conditions yet, it enters the queue once it does.

• Queue this pull request

[robfrank]

Suggested addition to the per-record _sourceRID bullet in how-to/data-modeling/materialized-views.adoc (from ArcadeData/arcadedb#11552, PR ArcadeData/arcadedb#11554):

_sourceRID is reserved on a per-record view. A schemaless source record that carries an undeclared _sourceRID field, or a property of that name declared after the view was created, does not keep its value in the view: under SELECT * the link to the source record always wins.