bcquality/community/knowledge/performance/dataaccessintent-readonly-on-analytical-objects.md
Stefano Demiliani ebceff2332 knowledge(performance): add community rules for JIT, locks, and false positives
These articles capture BC-specific mechanics agents still invert: partial-record JIT on writes, Reset clearing SetLoadFields, HttpClient inside write transactions, and batched number series, plus negative guidance that stops over-eager Query and IsEmpty "fixes".

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-20 15:57:58 +02:00

1.2 KiB

bc-version domain keywords technologies countries application-area
all
performance
dataaccessintent
read-only
read-scale-out
report
api-page
query
al
w1
all

Set DataAccessIntent ReadOnly on analytical objects

Contributions welcome — open a PR to refine or extend this article.

Description

Reports, API pages, and queries that only read can run against a read replica when DataAccessIntent = ReadOnly. Without the property they hit the primary replica and compete with posting. Agents omit it because the default is read-write and the object "only reads" in AL. The replica routing is a metadata switch, not something the compiler infers from the absence of Modify.

Best Practice

On report, query, and API page objects that never write, set DataAccessIntent = ReadOnly. Keep the default on objects that insert, modify, or call a write codeunit from a processing-only report.

See sample: dataaccessintent-readonly-on-analytical-objects.good.al.

Anti Pattern

A listing report or API query with no DataAccessIntent that scans G/L or sales lines. The object is read-only in practice and still loads the primary.

See sample: dataaccessintent-readonly-on-analytical-objects.bad.al.