From 07be9eb9358c70bac67ec8985c38d4349fffa552 Mon Sep 17 00:00:00 2001
From: boluor <boluor@gmail.com>
Date: Tue, 2 Jun 2026 07:27:31 +0000
Subject: [PATCH] [fix](sql-functions) provide setup data for numeric-function
 examples querying an undefined table

ROUND_BANKERS and UNIFORM each show a `SELECT ... FROM <table>` example with an
expected result, but never define the table on the page, so the examples cannot be
run or reproduced ("table does not exist").

Add the missing CREATE TABLE + INSERT for each table (`test_enhanced_round` for
ROUND_BANKERS; `it` and `fn_test` for UNIFORM), carried in a standard HTML comment
(`<!-- setup-sql ... -->`) before the example. As an HTML comment it does not change
the rendered page, and no documented expected output is modified.

Table contents were reverse-derived from the printed output and verified end-to-end
on the matching release cluster for each doc tree: ROUND_BANKERS on 4.1.1 / 3.1.4 /
2.1.11 / master; UNIFORM (dev + version-4.x only) on 4.1.1 / master. The deterministic
examples now resolve and match the documented output (UNIFORM's random()-seeded
examples remain inherently non-deterministic, as the doc itself notes).

ROUND_BANKERS updated in EN + ZH across dev/current, version-4.x, version-3.x and
version-2.1; UNIFORM in EN + ZH across dev/current and version-4.x.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../scalar-functions/numeric-functions/round-bankers.md    | 5 +++++
 .../scalar-functions/numeric-functions/uniform.md          | 7 +++++++
 .../scalar-functions/numeric-functions/round-bankers.md    | 5 +++++
 .../scalar-functions/numeric-functions/uniform.md          | 7 +++++++
 .../scalar-functions/numeric-functions/round-bankers.md    | 5 +++++
 .../scalar-functions/numeric-functions/round-bankers.md    | 5 +++++
 .../scalar-functions/numeric-functions/round-bankers.md    | 5 +++++
 .../scalar-functions/numeric-functions/uniform.md          | 7 +++++++
 .../scalar-functions/numeric-functions/round-bankers.md    | 5 +++++
 .../scalar-functions/numeric-functions/round-bankers.md    | 5 +++++
 .../scalar-functions/numeric-functions/round-bankers.md    | 5 +++++
 .../scalar-functions/numeric-functions/uniform.md          | 7 +++++++
 12 files changed, 68 insertions(+)

diff --git a/docs/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md b/docs/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
index b9cf554e37bee..081381d5f736a 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
@@ -59,6 +59,11 @@ Returns an integer or a float-point number:
 
 ## Example
 
+<!-- setup-sql
+CREATE TABLE test_enhanced_round (rid INT, number INT) DISTRIBUTED BY HASH(rid) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO test_enhanced_round VALUES (1,1);
+-->
+
 ```sql
 select round_bankers(0.4);
 ```
diff --git a/docs/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md b/docs/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md
index 498998fa4a724..91c51f8a8807c 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md
@@ -32,6 +32,13 @@ Note that unlike Snowflake's [common usage](https://docs.snowflake.com/en/sql-re
 
 ## Example
 
+<!-- setup-sql
+CREATE TABLE it (k0 INT) DISTRIBUTED BY HASH(k0) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO it VALUES (NULL),(1),(2),(3),(4),(5);
+CREATE TABLE fn_test (ksint INT) DISTRIBUTED BY HASH(ksint) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO fn_test VALUES (1);
+-->
+
 When all input parameters are integers, return an integer:
 
 ```sql
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
index eac21af0b1a84..c0053250986ed 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
@@ -59,6 +59,11 @@ ROUND_BANKERS(<x> [ , <d>])
 
 ## 举例
 
+<!-- setup-sql
+CREATE TABLE test_enhanced_round (rid INT, number INT) DISTRIBUTED BY HASH(rid) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO test_enhanced_round VALUES (1,1);
+-->
+
 ```sql
 select round_bankers(0.4);
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md
index d4aa3aa04a28a..389da1c2502c0 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md
@@ -32,6 +32,13 @@ UNIFORM( <min> , <max> , <gen> )
 
 ## 举例
 
+<!-- setup-sql
+CREATE TABLE it (k0 INT) DISTRIBUTED BY HASH(k0) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO it VALUES (NULL),(1),(2),(3),(4),(5);
+CREATE TABLE fn_test (ksint INT) DISTRIBUTED BY HASH(ksint) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO fn_test VALUES (1);
+-->
+
 输入参数全为整数时，返回整数：
 
 ```sql
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
index eac21af0b1a84..c0053250986ed 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
@@ -59,6 +59,11 @@ ROUND_BANKERS(<x> [ , <d>])
 
 ## 举例
 
+<!-- setup-sql
+CREATE TABLE test_enhanced_round (rid INT, number INT) DISTRIBUTED BY HASH(rid) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO test_enhanced_round VALUES (1,1);
+-->
+
 ```sql
 select round_bankers(0.4);
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
index eac21af0b1a84..c0053250986ed 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
@@ -59,6 +59,11 @@ ROUND_BANKERS(<x> [ , <d>])
 
 ## 举例
 
+<!-- setup-sql
+CREATE TABLE test_enhanced_round (rid INT, number INT) DISTRIBUTED BY HASH(rid) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO test_enhanced_round VALUES (1,1);
+-->
+
 ```sql
 select round_bankers(0.4);
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
index eac21af0b1a84..c0053250986ed 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
@@ -59,6 +59,11 @@ ROUND_BANKERS(<x> [ , <d>])
 
 ## 举例
 
+<!-- setup-sql
+CREATE TABLE test_enhanced_round (rid INT, number INT) DISTRIBUTED BY HASH(rid) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO test_enhanced_round VALUES (1,1);
+-->
+
 ```sql
 select round_bankers(0.4);
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md
index d4aa3aa04a28a..389da1c2502c0 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md
@@ -32,6 +32,13 @@ UNIFORM( <min> , <max> , <gen> )
 
 ## 举例
 
+<!-- setup-sql
+CREATE TABLE it (k0 INT) DISTRIBUTED BY HASH(k0) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO it VALUES (NULL),(1),(2),(3),(4),(5);
+CREATE TABLE fn_test (ksint INT) DISTRIBUTED BY HASH(ksint) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO fn_test VALUES (1);
+-->
+
 输入参数全为整数时，返回整数：
 
 ```sql
diff --git a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
index b9cf554e37bee..081381d5f736a 100644
--- a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
+++ b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
@@ -59,6 +59,11 @@ Returns an integer or a float-point number:
 
 ## Example
 
+<!-- setup-sql
+CREATE TABLE test_enhanced_round (rid INT, number INT) DISTRIBUTED BY HASH(rid) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO test_enhanced_round VALUES (1,1);
+-->
+
 ```sql
 select round_bankers(0.4);
 ```
diff --git a/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md b/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
index b9cf554e37bee..081381d5f736a 100644
--- a/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
+++ b/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
@@ -59,6 +59,11 @@ Returns an integer or a float-point number:
 
 ## Example
 
+<!-- setup-sql
+CREATE TABLE test_enhanced_round (rid INT, number INT) DISTRIBUTED BY HASH(rid) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO test_enhanced_round VALUES (1,1);
+-->
+
 ```sql
 select round_bankers(0.4);
 ```
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
index b9cf554e37bee..081381d5f736a 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/round-bankers.md
@@ -59,6 +59,11 @@ Returns an integer or a float-point number:
 
 ## Example
 
+<!-- setup-sql
+CREATE TABLE test_enhanced_round (rid INT, number INT) DISTRIBUTED BY HASH(rid) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO test_enhanced_round VALUES (1,1);
+-->
+
 ```sql
 select round_bankers(0.4);
 ```
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md
index 498998fa4a724..91c51f8a8807c 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/numeric-functions/uniform.md
@@ -32,6 +32,13 @@ Note that unlike Snowflake's [common usage](https://docs.snowflake.com/en/sql-re
 
 ## Example
 
+<!-- setup-sql
+CREATE TABLE it (k0 INT) DISTRIBUTED BY HASH(k0) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO it VALUES (NULL),(1),(2),(3),(4),(5);
+CREATE TABLE fn_test (ksint INT) DISTRIBUTED BY HASH(ksint) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO fn_test VALUES (1);
+-->
+
 When all input parameters are integers, return an integer:
 
 ```sql