Improve ExternalSorter ResourcesExhausted Error Message

[erenavsarogullari]

Which issue does this PR close?

• Closes Improve ExternalSorter ResourcesExhausted Error Message #20225.

Rationale for this change

What changes are included in this PR?

When there is not enough memory to continue external sort, either increasing the memory limit or decreasing sort_spill_reservation_bytes need to be applied. It can be useful to guide the user with clearer error message by highlighting required configs for the consistency because expected settings are as follows:

SET datafusion.runtime.memory_limit = '10G'
SET datafusion.execution.sort_spill_reservation_bytes = 10485760

Current:

Not enough memory to continue external sort. Consider increasing the memory limit, 
or decreasing sort_spill_reservation_bytes

New:

Not enough memory to continue external sort. Consider increasing the memory limit config: 
'datafusion.runtime.memory_limit', or decreasing the config: 'datafusion.execution.sort_spill_reservation_bytes'.

Are these changes tested?

A new UT case has been added to cover this use-case and it has been tested locally successfully.

For updated snapshot files:
Following integration tests have been successful by DataFusion Test Pipeline:

test test_cli_top_memory_consumers::case_1 ... ok
test test_cli_top_memory_consumers::case_2 ... ok
test test_cli_top_memory_consumers::case_3 ... ok

Ref: https://github.com/apache/datafusion/actions/runs/21811797863/job/62925363536?pr=20226

Are there any user-facing changes?

Yes, improving legacy ExternalSorter ResourcesExhausted Error Message.

[kosiew]

@erenavsarogullari

Thanks for working on this.

Left some non-blocking comments.

[erenavsarogullari]

Thanks @kosiew and @martin-g for the reviews. All comments have been addressed.

[alamb]

🚀