[SPARK-33877][SQL][FOLLOWUP] SQL reference documents for INSERT w/ a …

…column list ### What changes were proposed in this pull request? followup of apache@a3dd8da via suggestion apache#30888 (comment) ### Why are the changes needed? doc improvement ### Does this PR introduce _any_ user-facing change? no ### How was this patch tested? passing GA doc Closes apache#30909 from yaooqinn/SPARK-33877-F. Authored-by: Kent Yao <[email protected]> Signed-off-by: Dongjoon Hyun <[email protected]>
xuanyuanking · Sep 29, 2021 · 1a788e0 · 1a788e0
1 parent c8ca66c
commit 1a788e0
Show file tree

Hide file tree

Showing 2 changed files with 2 additions and 4 deletions.
diff --git a/docs/sql-ref-syntax-dml-insert-into.md b/docs/sql-ref-syntax-dml-insert-into.md
@@ -47,12 +47,11 @@ INSERT INTO [ TABLE ] table_identifier [ partition_spec ] [ ( column_list ) ]
 
 * **column_list**
 
-    An optional parameter that specifies a comma-separated list of columns belonging to the `table_identifier` table.
+    An optional parameter that specifies a comma-separated list of columns belonging to the `table_identifier` table. Spark will reorder the columns of the input query to match the table schema according to the specified column list.
 
     **Note:**The current behaviour has some limitations:
     - All specified columns should exist in the table and not be duplicated from each other. It includes all columns except the static partition columns.
     - The size of the column list should be exactly the size of the data from `VALUES` clause or query.
-    - The order of the column list is alterable and determines how the data from `VALUES` clause or query to be inserted by position.
 
 * **VALUES ( { value `|` NULL } [ , ... ] ) [ , ( ... ) ]**
 

diff --git a/docs/sql-ref-syntax-dml-insert-overwrite-table.md b/docs/sql-ref-syntax-dml-insert-overwrite-table.md
@@ -47,14 +47,13 @@ INSERT OVERWRITE [ TABLE ] table_identifier [ partition_spec [ IF NOT EXISTS ] ]
 
 * **column_list**
 
-    An optional parameter that specifies a comma-separated list of columns belonging to the `table_identifier` table.
+    An optional parameter that specifies a comma-separated list of columns belonging to the `table_identifier` table. Spark will reorder the columns of the input query to match the table schema according to the specified column list.
 
     **Note**
 
     The current behaviour has some limitations:
     - All specified columns should exist in the table and not be duplicated from each other. It includes all columns except the static partition columns.
     - The size of the column list should be exactly the size of the data from `VALUES` clause or query.
-    - The order of the column list is alterable and determines how the data from `VALUES` clause or query to be inserted by position.
 
 * **VALUES ( { value `|` NULL } [ , ... ] ) [ , ( ... ) ]**