Revert "Revert "fix comments""

This reverts commit 33e932e.

Author: soyeric128

docs/en/guides/54-query/08-stored-procedure.md

@@ -6,83 +6,7 @@ A stored procedure is a set of executable commands or logic blocks stored within
 
 ## Supported Languages
 
-**Databend currently supports [SQL Scripting](#sql-scripting) only**. Using SQL scripting, users can define procedures with control flow constructs like loops (FOR, WHILE, REPEAT) and conditionals (IF, CASE), enabling complex logic and effective multi-step operations.
-
-### SQL Scripting
-
-In Databend, stored procedures support a rich set of features to allow users to define complex operations through SQL scripting. Here are the supported capabilities:
-
-- **Variable Declaration**: Variables can be declared using the `LET` keyword, followed by the variable name, an optional type, and the initial value.
-
-    ```sql title='Examples:'
-    LET x := 100;
-    ```
-
-- **Query Execution**: SQL queries can be executed within the script, and results can be stored in variables or result sets.
-
-    ```sql title='Examples:'
-    LET result RESULTSET := SELECT * FROM t1;
-    ```
-
-- **Control Flow Constructs**
-  - **FOR Loop**: Iterates over a range or a result set.
-
-    ```sql title='Examples:'
-    FOR i IN 1..10 DO ... END FOR;
-    ```
-
-  - **WHILE Loop**: Executes a block of code as long as a specified condition is true.
-
-    ```sql title='Examples:'
-    WHILE condition DO ... END WHILE;
-    ```
-
-  - **REPEAT Loop**: Executes a block of code until a condition is met.
-
-    ```sql title='Examples:'
-    REPEAT ... UNTIL condition END REPEAT;
-    ```
-
-  - **LOOP**: Executes a block of code indefinitely until a `BREAK` statement is encountered.
-
-    ```sql title='Examples:'
-    LOOP ... END LOOP;
-    ```
-
-  - **CASE Statement**: Allows conditional execution of code blocks based on different conditions.
-
-    ```sql title='Examples:'
-    CASE [operand]
-    WHEN condition1 THEN ...
-    WHEN condition2 THEN ...
-    ELSE ...
-    END;
-    ```
-
-  - **IF Statement**: Executes a block of code based on a condition.
-
-    ```sql title='Examples:'
-    IF condition THEN ...
-    ELSEIF condition THEN ...
-    ELSE ...
-    END IF;
-    ```
-
-- **RETURN**: Returns from the script with an optional value.
-
-    ```sql title='Examples:'
-    RETURN [expr];
-    ```
-
-- **RETURN TABLE**: Returns from the script with a table result.
-
-    ```sql title='Examples:'
-    RETURN TABLE(result_set_name | SELECT ...);
-    ```
-
-- **Comments**
-  - **Single-line comments**: `-- comment`
-  - **Multi-line comments**: `/* comment */`
+**Databend currently supports [SQL Scripting](/sql/sql-reference/sql-scripting) only**. Using SQL scripting, users can define procedures with control flow constructs like loops (FOR, WHILE, REPEAT) and conditionals (IF, CASE), enabling complex logic and effective multi-step operations.
 
 ## Limitations
 

docs/en/sql-reference/00-sql-reference/98-sql-scripting.md

@@ -0,0 +1,108 @@
+---
+title: SQL Scripting
+---
+
+This page outlines the SQL scripting options available in Databend. You can use SQL scripting with either of the following query methods:
+
+- [Stored Procedure](/guides/query/stored-procedure)
+- [Execute Immediate](/sql/sql-commands/administration-cmds/execute-immediate)
+
+### Variable Declaration
+
+Variables can be declared using the `LET` keyword, followed by the variable name, an optional type, and the initial value.
+
+```sql title='Examples:'
+LET x := 100;
+```
+
+### Query Execution
+
+SQL queries can be executed within the script, and results can be stored in variables or result sets.
+
+```sql title='Examples:'
+LET result RESULTSET := SELECT * FROM t1;
+```
+
+### Control Flow Constructs
+
+- **FOR Loop**: Iterates over a range or a result set.
+
+    ```sql title='Examples:'
+    FOR i IN 1..10 DO ... END FOR;
+    ```
+
+- **WHILE Loop**: Executes a block of code as long as a specified condition is true.
+
+    ```sql title='Examples:'
+    WHILE condition DO ... END WHILE;
+    ```
+
+- **REPEAT Loop**: Executes a block of code until a condition is met.
+
+    ```sql title='Examples:'
+    REPEAT ... UNTIL condition END REPEAT;
+    ```
+
+- **LOOP**: Executes a block of code indefinitely until a `BREAK` statement is encountered.
+
+    ```sql title='Examples:'
+    LOOP ... END LOOP;
+    ```
+
+- **CASE Statement**: Allows conditional execution of code blocks based on different conditions.
+
+    ```sql title='Examples:'
+    CASE [operand]
+    WHEN condition1 THEN ...
+    WHEN condition2 THEN ...
+    ELSE ...
+    END;
+    ```
+
+- **IF Statement**: Executes a block of code based on a condition.
+
+    ```sql title='Examples:'
+    IF condition THEN ...
+    ELSEIF condition THEN ...
+    ELSE ...
+    END IF;
+    ```
+
+### RETURN
+
+Returns from the script with an optional value.
+
+```sql title='Examples:'
+RETURN [expr];
+```
+
+### RETURN TABLE
+
+Returns from the script with a table result as a String column.
+
+```sql title='Examples:'
+EXECUTE IMMEDIATE $$
+BEGIN
+    CREATE OR REPLACE TABLE t1 (a INT, b FLOAT, c STRING);
+    INSERT INTO t1 VALUES (1, 2.0, '3');
+    RETURN TABLE(select * from t1);
+END;
+$$;
+
+┌─────────────────────────────────────────────┐
+│                    Result                   │
+│                    String                   │
+├─────────────────────────────────────────────┤
+│ ┌─────────────────────────────────────────┐ │
+│ │      a     │       b      │      c      │ │
+│ │ Int32 NULL │ Float32 NULL │ String NULL │ │
+│ ├────────────┼──────────────┼─────────────┤ │
+│ │ 1          │ 2            │ '3'         │ │
+│ └─────────────────────────────────────────┘ │
+└─────────────────────────────────────────────┘
+```
+
+### Comments
+
+- **Single-line comments**: `-- comment`
+- **Multi-line comments**: `/* comment */`

docs/en/sql-reference/10-sql-commands/00-ddl/18-procedure/create-procedure.md

@@ -17,7 +17,9 @@ LANGUAGE <language>
 AS $$
 BEGIN
     <procedure_body>
-    RETURN <return_value>;
+    RETURN <return_value>;             -- Use to return a single value
+    -- OR
+    RETURN TABLE(<select_query>);      -- Use to return a table
 END;
 $$;
 ```

docs/en/sql-reference/10-sql-commands/50-administration-cmds/execute-immediate.md

@@ -0,0 +1,68 @@
+---
+title: EXECUTE IMMEDIATE
+---
+import FunctionDescription from '@site/src/components/FunctionDescription';
+
+<FunctionDescription description="Introduced or updated: v1.2.452"/>
+
+Executes a SQL script. For how to write SQL scripts for Databend, see [SQL Scripting](/sql/sql-reference/sql-scripting).
+
+## Syntax
+
+```sql
+EXECUTE IMMEDIATE $$
+BEGIN
+    <procedure_body>
+    RETURN <return_value>;             -- Use to return a single value
+    -- OR
+    RETURN TABLE(<select_query>);      -- Use to return a table
+END;
+$$;
+```
+
+## Examples
+
+This example uses a loop to increment sum by iterating from -1 to 2, and the result is the sum (2):
+
+```sql
+EXECUTE IMMEDIATE $$
+BEGIN
+    LET x := -1;
+    LET sum := 0;
+    FOR x IN x TO x + 3 DO
+        sum := sum + x;
+    END FOR;
+    RETURN sum;
+END;
+$$;
+
+┌────────┐
+│ Result │
+│ String │
+├────────┤
+│ 2      │
+└────────┘
+```
+
+The following example returns a table with a column `1 + 1` and the value 2:
+
+```sql
+EXECUTE IMMEDIATE $$
+BEGIN
+    LET x := 1;
+    RETURN TABLE(SELECT :x + 1);
+END;
+$$;
+
+┌───────────┐
+│   Result  │
+│   String  │
+├───────────┤
+│ ┌───────┐ │
+│ │ 1 + 1 │ │
+│ │ UInt8 │ │
+│ ├───────┤ │
+│ │     2 │ │
+│ └───────┘ │
+└───────────┘
+```