Microsoft/bcquality
1
0
Fork 0
mirror of https://github.com/microsoft/BCQuality.git synced 2026-08-06 17:36:53 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions
bcquality/microsoft/knowledge/performance/use-setautocalcfields-for-per-row-flowfields.md
Jesper Schulz-Wedde 078b869e33
Add per-row AL performance guidance (#97) 
* Add per-row performance guidance

Document SetAutoCalcFields for per-row FlowFields and direct writes on iterated records, with focused reviewer retrieval cues.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 85be3fc4-5253-47b8-ba1b-6b8fd188fcea

* Bound commit checkpoints by key range

Use a capped ordered query to discover each checkpoint watermark before locking and processing only that key range.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 85be3fc4-5253-47b8-ba1b-6b8fd188fcea

* Address performance retrieval review

Retrieve Commit-in-loop guidance precisely, process exact checkpoint key lists, and narrow clone-before-write discovery.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot-Session: 85be3fc4-5253-47b8-ba1b-6b8fd188fcea

---------

Co-authored-by: Jesper Schulz-Wedde <jesper.schulzwedde@microsoft.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
2026-07-14 12:51:39 +02:00

1.6 KiB
Raw Permalink Blame History

bc-version domain keywords technologies countries application-area
all
performance
setautocalcfields
calcfields
calcsums
flowfield
loop
per-row
al
w1
all

Use SetAutoCalcFields when each iterated row needs a FlowField

Description

Record.SetAutoCalcFields has been available since runtime 1.0 and makes the specified FlowFields calculate as records are retrieved. Microsoft's AL database-method performance guidance uses it to remove an explicit CalcFields call from every iteration when each row's FlowField drives a branch. This is different from CalcSums, which returns a total for the filtered set rather than a value for each row.

Best Practice

Call SetAutoCalcFields before FindSet when every returned row needs the same FlowField for a comparison, branch, or per-record action. Use CalcSums instead when the required result is one aggregate over the filtered set (see calcsums-instead-of-calcfields-in-loop.md).

See sample: use-setautocalcfields-for-per-row-flowfields.good.al.

Anti Pattern

Calling CalcFields inside the loop when every iteration reads the same FlowField. Each CalcFields request requires a separate SQL statement unless a compatible recent result is cached. Do not replace row-specific decisions with CalcSums; an aggregate cannot preserve which rows met the condition.

See sample: use-setautocalcfields-for-per-row-flowfields.bad.al.