Microsoft/bcquality
1
0
Fork 0
mirror of https://github.com/microsoft/BCQuality.git synced 2026-10-05 14:46:55 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
bcquality/microsoft/knowledge/upgrade/datatransfer-for-bulk-init.md
Jesper Schulz-Wedde b6da405376 Improve partner onboarding and documentation navigation 
Lead with a complete plugin quick start and add task-oriented usage, troubleshooting, customization, and contribution guides. Preserve the broader plugin framing, correct conflicting contract guidance, support Agents folder reviews, and align repository validation. Convert existing sample references to clickable links without changing knowledge rules.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
2026-09-09 17:25:29 +02:00

1.8 KiB
Raw Blame History

bc-version domain keywords technologies countries application-area
21..
upgrade
datatransfer
large-dataset
bulk-update
modifyall
copyfields
new-field
al
w1
all

Use DataTransfer for bulk updates on large tables

Description

Tables that can contain more than 300,000 records, and any newly added field on an existing table, should be initialized with DataTransfer rather than a repeat ... Modify ... until Next() = 0 loop. DataTransfer issues a single set-based statement to the database; the loop/modify pattern issues one round-trip per row and accumulates write locks for the duration of the upgrade. On the volumes that drive upgrade pain — ledger entries, item ledger entries, price list lines — the difference is the upgrade running for minutes instead of hours.

Best Practice

For a bulk update use a DataTransfer variable: call SetTables(Database::"...", Database::"...") (source and destination may be the same table), add filters with AddSourceFilter, set the target value with AddConstantValue (or copy a source field with AddFieldValue), and execute with CopyFields(). To express multiple distinct updates against the same table, Clear the DataTransfer between executions and configure the next one.

See sample: datatransfer-for-bulk-init.good.al.

Anti Pattern

Iterating with FindSet(true) ... repeat ... Modify() ... until Next() = 0 to set a single field across an entire large table. On 300k+ rows this is the canonical slow-upgrade footgun.

See sample: datatransfer-for-bulk-init.bad.al.

See also

  • datatransfer-skips-triggers-and-subscribers.md — DataTransfer does not raise field validation triggers or event subscribers; if a row needs validation logic, DataTransfer is the wrong tool.