From a6359111b43b9dde4db7511d0a539ebc653eef17 Mon Sep 17 00:00:00 2001
From: huangxiaoping <1754789345@qq.com>
Date: Fri, 16 Jan 2026 00:29:13 +0800
Subject: [PATCH] [doc] Improve `BY NAME` statement doc

---
 docs/content/spark/sql-write.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/content/spark/sql-write.md b/docs/content/spark/sql-write.md
index 0516f5f325a8..e6291c14ecdb 100644
--- a/docs/content/spark/sql-write.md
+++ b/docs/content/spark/sql-write.md
@@ -288,11 +288,11 @@ Here list the configurations.
 This mode also supports Spark SQL. Here is an example:
 
 ```sql
-set `spark.paimon.write.merge-schema` = true;
+SET `spark.paimon.write.merge-schema` = true;
 
 CREATE TABLE t (a INT, b STRING);
 INSERT INTO t VALUES (1, '1'), (2, '2');
 
--- need using by name mode
+-- Need using `BY NAME` statement (requires Spark 3.5+)
 INSERT INTO t BY NAME SELECT 3 AS a, '3' AS b, 3 AS c;
 ```