(paimon) branch master updated: [core] Improve sort buffer overflow message (#7995)

[lzljs3620320]

This is an automated email from the ASF dual-hosted git repository.

JingsongLi pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/paimon.git


The following commit(s) were added to refs/heads/master by this push:
     new 1f9dba508f [core] Improve sort buffer overflow message (#7995)
1f9dba508f is described below

commit 1f9dba508fecf452d4fb036d3d98767332cf6e55
Author: huangxiaoping <1754789...@qq.com>
AuthorDate: Fri May 29 22:12:31 2026 +0800

    [core] Improve sort buffer overflow message (#7995)
    
    Improve the error message thrown when a single record exceeds the
    available sort buffer in `BinaryExternalSortBuffer`, so users can more
    easily understand that the failure is caused by an oversized row and
    know to check the input data or increase `write-buffer-size`.
---
 .../main/java/org/apache/paimon/sort/BinaryExternalSortBuffer.java  | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git 
a/paimon-core/src/main/java/org/apache/paimon/sort/BinaryExternalSortBuffer.java
 
b/paimon-core/src/main/java/org/apache/paimon/sort/BinaryExternalSortBuffer.java
index 31963420e7..5521295ea3 100644
--- 
a/paimon-core/src/main/java/org/apache/paimon/sort/BinaryExternalSortBuffer.java
+++ 
b/paimon-core/src/main/java/org/apache/paimon/sort/BinaryExternalSortBuffer.java
@@ -178,7 +178,11 @@ public class BinaryExternalSortBuffer implements 
SortBuffer {
             }
             if (inMemorySortBuffer.isEmpty()) {
                 // did not fit in a fresh buffer, must be large...
-                throw new IOException("The record exceeds the maximum size of 
a sort buffer.");
+                throw new IOException(
+                        "The record exceeds the maximum size of a Paimon write 
sort buffer. "
+                                + "A single serialized record cannot fit into 
an empty write buffer. "
+                                + "Please check whether the input contains an 
oversized row, "
+                                + "or increase the table option 
'write-buffer-size'.");
             } else {
                 spill();