Troubleshooting a mapping or mapping task

Mapping failed with a Java heap space error

When you read from or write to large data sets in Microsoft Fabric OneLake, certain mappings might fail with the following error:

[ERROR] java.lang.OutOfMemoryError: Java heap space

You must increase the heap size to run the mappings successfully. The recommended heap size is 1 GB.

Perform the following steps to configure the JVM options in the Secure Agent to increase the memory for the Java heap size:

1. 1Select Administrator > Runtime Environments.
2. 2On the Runtime Environments page, select the Secure Agent for which you want to increase memory from the list of available Secure Agents.
3. 3In the upper-right corner, click Edit.
4. 4In the System Configuration Details section, select Data Integration Server as the service and DTM as the type.
5. 5Edit the JVMOption field and set the value to -Xmx1024m.
Note: The recommended heap size is 1 GB. You can increase the heap size based on the data you want to process.
6. 6Click Save.