docs: nextval(seq) as a column default value (#1737)

* Update nextval.md

* Update 10-ddl-create-table.md

* Update 10-ddl-create-table.md

* Update docs/en/sql-reference/10-sql-commands/00-ddl/01-table/10-ddl-create-table.md

Co-authored-by: Yang Xiufeng <[email protected]>

* Update docs/en/sql-reference/10-sql-commands/00-ddl/01-table/10-ddl-create-table.md

Co-authored-by: Yang Xiufeng <[email protected]>

* Update docs/en/sql-reference/10-sql-commands/00-ddl/01-table/10-ddl-create-table.md

Co-authored-by: Yang Xiufeng <[email protected]>

* Update docs/en/sql-reference/10-sql-commands/00-ddl/01-table/10-ddl-create-table.md

Co-authored-by: Yang Xiufeng <[email protected]>

* Update docs/en/sql-reference/10-sql-commands/00-ddl/01-table/10-ddl-create-table.md

Co-authored-by: Yang Xiufeng <[email protected]>

---------

Co-authored-by: z <[email protected]>
Co-authored-by: Yang Xiufeng <[email protected]>

Author: 3 people

docs/en/sql-reference/10-sql-commands/00-ddl/01-table/10-ddl-create-table.md

@@ -5,7 +5,7 @@ sidebar_position: 1
 
 import FunctionDescription from '@site/src/components/FunctionDescription';
 
-<FunctionDescription description="Introduced or updated: v1.2.666"/>
+<FunctionDescription description="Introduced or updated: v1.2.714"/>
 
 import EEFeature from '@site/src/components/EEFeature';
 
@@ -106,46 +106,30 @@ create table t_new compression='lz4' as select * from t_old;
 
 By default, **all columns are nullable(NULL)** in Databend. If you need a column that does not allow NULL values, use the NOT NULL constraint. For more information, see [NULL Values and NOT NULL Constraint](../../../00-sql-reference/10-data-types/index.md).
 
-## Default Values
+## Column Default Values
 
-```sql
-DEFAULT <expr>
-```
-
-Specify a default value inserted in the column if a value is not specified via an `INSERT` or `CREATE TABLE AS SELECT` statement.
-
-For example:
-
-```sql
-CREATE TABLE t_default_value(a TINYINT UNSIGNED, b VARCHAR DEFAULT 'b');
-```
+`DEFAULT <expr>` sets a default value for the column when no explicit expression is provided. The default expression can be:
 
-Desc the `t_default_value` table:
+- A fixed constant, such as `Marketing` for the `department` column in the example below.
+- An expression with no input arguments and returns a scalar value, such as `1 + 1`, `NOW()` or `UUID()`.
+- A dynamically generated value from a sequence, such as `NEXTVAL(staff_id_seq)` for the `staff_id` column in the example below.
+  - NEXTVAL must be used as a standalone default value; expressions like `NEXTVAL(seq1) + 1` are not supported.
 
 ```sql
-DESC t_default_value;
+CREATE SEQUENCE staff_id_seq;
 
-Field|Type            |Null|Default|Extra|
------+----------------+----+-------+-----+
-a    |TINYINT UNSIGNED|YES |NULL   |     |
-b    |VARCHAR         |YES |'b'    |     |
-```
-
-Insert a value:
-
-```sql
-INSERT INTO T_default_value(a) VALUES(1);
-```
+CREATE TABLE staff (
+    staff_id INT DEFAULT NEXTVAL(staff_id_seq), -- Assigns the next number from the sequence 'staff_id_seq' if no value is provided
+    name VARCHAR(50),
+    department VARCHAR(50) DEFAULT 'Marketing' -- Defaults to 'Marketing' if no value is provided
+);
 
-Check the table values:
+-- staff_id is auto-generated when not included in COPY INTO  
+COPY INTO staff(name, department) FROM @stage ...
 
-```sql
-SELECT * FROM t_default_value;
-+------+------+
-| a    | b    |
-+------+------+
-|    1 | b    |
-+------+------+
+-- staff_id is loaded from the staged file  
+COPY INTO staff FROM @stage ...
+COPY INTO staff(staff_id, name, department) FROM @stage ...
 ```
 
 ## Computed Columns

docs/en/sql-reference/20-sql-functions/18-sequence-functions/nextval.md

@@ -42,27 +42,27 @@ This example showcases how sequences and the NEXTVAL function are employed to au
 -- Create a new sequence named staff_id_seq
 CREATE SEQUENCE staff_id_seq;
 
--- Create a new table named staff with columns for staff_id, name, and department
+-- Create a new table named staff with an auto-generated staff_id
 CREATE TABLE staff (
-    staff_id INT,
+    staff_id INT DEFAULT NEXTVAL(staff_id_seq),
     name VARCHAR(50),
     department VARCHAR(50)
 );
 
--- Insert a new row into the staff table, using the next value from the staff_id_seq sequence for the staff_id column
-INSERT INTO staff (staff_id, name, department)
-VALUES (NEXTVAL(staff_id_seq), 'John Doe', 'HR');
+--  Insert a new staff member with an auto-generated staff_id into the staff table
+INSERT INTO staff (name, department)
+VALUES ('John Doe', 'HR');
 
--- Insert another row into the staff table, using the next value from the staff_id_seq sequence for the staff_id column
-INSERT INTO staff (staff_id, name, department)
-VALUES (NEXTVAL(staff_id_seq), 'Jane Smith', 'Finance');
+-- Insert another row
+INSERT INTO staff (name, department)
+VALUES ('Jane Smith', 'Finance');
 
 SELECT * FROM staff;
 
 ┌───────────────────────────────────────────────────────┐
 │     staff_id    │       name       │    department    │
 ├─────────────────┼──────────────────┼──────────────────┤
-│               2 │ Jane Smith       │ Finance          │
-│               1 │ John Doe         │ HR               │
+│               3 │ Jane Smith       │ Finance          │
+│               2 │ John Doe         │ HR               │
 └───────────────────────────────────────────────────────┘
 ```