From 574c155c953ec162b70b3b857fdb2da948a33a3f Mon Sep 17 00:00:00 2001
From: boluor <boluor@gmail.com>
Date: Tue, 2 Jun 2026 06:02:20 +0000
Subject: [PATCH 1/3] [fix](sql-functions) provide setup data for examples
 querying an undefined table
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Several SQL-function reference pages show examples of the form
`SELECT ... FROM <table>` with an expected result, but never define `<table>`
on the page, so the examples cannot be run or reproduced (a reader copying
them gets `Table [...] does not exist`).

Add the missing CREATE TABLE + INSERT for each such table, carried in a
standard HTML comment (`<!-- setup-sql ... -->`) just before the first example
that uses the table. As an HTML comment it does not change the rendered page,
and no documented expected output is modified — it only records the data the
examples already assume, making each example self-contained and reproducible.

Table contents were reverse-derived from the output already printed on each
page and verified end-to-end on a Doris 4.1.1 cluster: every example now
resolves its table and matches the documented output cell-for-cell.

Pages (EN + ZH, version-4.x): GET_FORMAT, MAKETIME, CONVERT_TO,
IPV4_NUM_TO_STRING, IPV4_STRING_TO_NUM_OR_NULL.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../scalar-functions/date-time-functions/get-format.md       | 5 +++++
 .../scalar-functions/date-time-functions/maketime.md         | 5 +++++
 .../scalar-functions/ip-functions/ipv4-num-to-string.md      | 5 +++++
 .../ip-functions/ipv4-string-to-num-or-null.md               | 5 +++++
 .../scalar-functions/other-functions/convert-to.md           | 5 +++++
 .../scalar-functions/date-time-functions/get-format.md       | 5 +++++
 .../scalar-functions/date-time-functions/maketime.md         | 5 +++++
 .../scalar-functions/ip-functions/ipv4-num-to-string.md      | 5 +++++
 .../ip-functions/ipv4-string-to-num-or-null.md               | 5 +++++
 .../scalar-functions/other-functions/convert-to.md           | 5 +++++
 10 files changed, 50 insertions(+)

diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md
index 80756308c97a8..ac3398fdb7a5c 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md
@@ -43,6 +43,11 @@ GET_FORMAT({DATE|DATETIME|TIME}, {'EUR'|'USA'|'JIS'|'ISO'|'INTERNAL'})
 当第二个参数不为 `'USA', 'JIS', 'ISO', 'EUR', 'INTERNAL'` 之一或者为 NULL 时返回 NULL
 
 ## 举例
+<!-- setup-sql
+CREATE TABLE get_format_test (id INT, lc VARCHAR(20)) DISTRIBUTED BY HASH(id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO get_format_test VALUES (1,'USA'),(2,'JIS'),(3,'ISO'),(4,'EUR'),(5,'INTERNAL'),(6,'Doris');
+-->
+
 ```sql
 SELECT * FROM get_format_test
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md
index 61b93e30fe176..087e5fe439861 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md
@@ -35,6 +35,11 @@ MAKETIME(`<hour>`, `<minute>`, `<second>`)
 
 ## 举例
 
+<!-- setup-sql
+CREATE TABLE test_maketime (id INT, `hour` BIGINT, `minute` BIGINT, sec FLOAT) DISTRIBUTED BY HASH(id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO test_maketime VALUES (1,12,15,30),(2,14,56,12.5789),(3,1234,11,4),(4,-1234,6,52),(5,20,60,12),(6,14,51,66),(7,NULL,15,16),(8,7,NULL,8),(9,1,2,NULL),(10,23,-40,12),(11,20,6,-12);
+-->
+
 ```sql
 SELECT `hour`, `minute`, `sec`, MAKETIME(`hour`, `minute`, `sec`) AS ans FROM `test_maketime`;
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
index fd38cb1dab6f4..e403cd46a6977 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
@@ -40,6 +40,11 @@ select ipv4_num_to_string(3232235521);
 | 192.168.0.1                    |
 +--------------------------------+
 ```
+<!-- setup-sql
+CREATE TABLE ipv4_bi (num BIGINT) DISTRIBUTED BY HASH(num) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_bi VALUES (-1),(0),(2130706433),(4294967295),(4294967296);
+-->
+
 ```sql
 select num,ipv4_num_to_string(num) from ipv4_bi;
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
index 04509d6fbc067..642249f98fdc8 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
@@ -37,6 +37,11 @@ select ipv4_string_to_num_or_null('192.168.0.1');
 | 3232235521                                | 
 +-------------------------------------------+ 
 ```
+<!-- setup-sql
+CREATE TABLE ipv4_str (str VARCHAR(50)) DISTRIBUTED BY HASH(str) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_str VALUES ('0.0.0.0'),('127.0.0.1'),('255.255.255.255'),('invalid');
+-->
+
 ```sql
 select str, ipv4_string_to_num_or_null(str) from ipv4_str; 
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
index f5b18d9fe2573..71c1976eee0bc 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
@@ -29,6 +29,11 @@ CONVERT_TO(<column>, <character>)
 
 ## 举例
 
+<!-- setup-sql
+CREATE TABLE class_test (class_id INT, class_name VARCHAR(50), student_ids ARRAY<INT>) DISTRIBUTED BY HASH(class_id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO class_test VALUES (1,'啊',[1]),(2,'哈',[2]),(3,'哦',[3]),(4,'张',[4]),(5,'我',[5]),(6,'asd',[6]),(7,'qwe',[7]),(8,'z',[8]);
+-->
+
 ```sql
 SELECT * FROM class_test ORDER BY class_name;
 ```
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md
index 563b7293b5160..4bf44009832bd 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md
@@ -43,6 +43,11 @@ Returns a format string. The results for different arguments are shown in the ta
 If the second argument is not one of `'USA', 'JIS', 'ISO', 'EUR', 'INTERNAL'` or is NULL, the function returns NULL.
 
 ## Examples
+<!-- setup-sql
+CREATE TABLE get_format_test (id INT, lc VARCHAR(20)) DISTRIBUTED BY HASH(id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO get_format_test VALUES (1,'USA'),(2,'JIS'),(3,'ISO'),(4,'EUR'),(5,'INTERNAL'),(6,'Doris');
+-->
+
 ```sql
 SELECT * FROM get_format_test
 ```
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md
index 917544453f597..b20b2aee8899c 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md
@@ -35,6 +35,11 @@ Returns a value of type TIME, in the format `hour:minute:second`. When the input
 
 ## Example
 
+<!-- setup-sql
+CREATE TABLE test_maketime (id INT, `hour` BIGINT, `minute` BIGINT, sec FLOAT) DISTRIBUTED BY HASH(id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO test_maketime VALUES (1,12,15,30),(2,14,56,12.5789),(3,1234,11,4),(4,-1234,6,52),(5,20,60,12),(6,14,51,66),(7,NULL,15,16),(8,7,NULL,8),(9,1,2,NULL),(10,23,-40,12),(11,20,6,-12);
+-->
+
 ```sql
 SELECT `hour`, `minute`, `sec`, MAKETIME(`hour`, `minute`, `sec`) AS ans FROM `test_maketime`;
 ```
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
index a98326ae0612d..f3fa898986278 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
@@ -43,6 +43,11 @@ select ipv4_num_to_string(3232235521);
 +--------------------------------+
 ```
 
+<!-- setup-sql
+CREATE TABLE ipv4_bi (num BIGINT) DISTRIBUTED BY HASH(num) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_bi VALUES (-1),(0),(2130706433),(4294967295),(4294967296);
+-->
+
 ```sql
 select num,ipv4_num_to_string(num) from ipv4_bi;
 ```
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
index e7bfd48ca0474..84da1f95dfb42 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
@@ -38,6 +38,11 @@ select ipv4_string_to_num_or_null('192.168.0.1');
 +-------------------------------------------+ 
 ```
 
+<!-- setup-sql
+CREATE TABLE ipv4_str (str VARCHAR(50)) DISTRIBUTED BY HASH(str) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_str VALUES ('0.0.0.0'),('127.0.0.1'),('255.255.255.255'),('invalid');
+-->
+
 ```sql
 select str, ipv4_string_to_num_or_null(str) from ipv4_str; 
 ```
diff --git a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
index 6186c52f763db..7d459b515aa41 100644
--- a/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
+++ b/versioned_docs/version-4.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
@@ -29,6 +29,11 @@ Returns a VARCHAR value with the converted encoding, allowing proper pinyin-base
 
 ## Examples
 
+<!-- setup-sql
+CREATE TABLE class_test (class_id INT, class_name VARCHAR(50), student_ids ARRAY<INT>) DISTRIBUTED BY HASH(class_id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO class_test VALUES (1,'啊',[1]),(2,'哈',[2]),(3,'哦',[3]),(4,'张',[4]),(5,'我',[5]),(6,'asd',[6]),(7,'qwe',[7]),(8,'z',[8]);
+-->
+
 ```sql
 SELECT * FROM class_test ORDER BY class_name;
 ```

From fd9834f9a6400c1807e9e8fed273e7d9b49bef8a Mon Sep 17 00:00:00 2001
From: boluor <boluor@gmail.com>
Date: Tue, 2 Jun 2026 06:13:19 +0000
Subject: [PATCH 2/3] [fix](sql-functions) apply the same phantom-table setup
 to dev (current) docs

Mirror the version-4.x change onto the dev/current copies of the same five
pages (docs/ EN + i18n/.../current ZH). These files were byte-identical to the
version-4.x originals, so the same `<!-- setup-sql ... -->` CREATE+INSERT
applies unchanged.

Verified end-to-end on a master build (doris-0.0.0, daily output): before the
change every `... FROM <table>` example failed with "table does not exist"; after
it, all examples resolve their table and match the documented output. Rendered
page and documented expected output are unchanged (HTML comment only).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../scalar-functions/date-time-functions/get-format.md       | 5 +++++
 .../scalar-functions/date-time-functions/maketime.md         | 5 +++++
 .../scalar-functions/ip-functions/ipv4-num-to-string.md      | 5 +++++
 .../ip-functions/ipv4-string-to-num-or-null.md               | 5 +++++
 .../scalar-functions/other-functions/convert-to.md           | 5 +++++
 .../scalar-functions/date-time-functions/get-format.md       | 5 +++++
 .../scalar-functions/date-time-functions/maketime.md         | 5 +++++
 .../scalar-functions/ip-functions/ipv4-num-to-string.md      | 5 +++++
 .../ip-functions/ipv4-string-to-num-or-null.md               | 5 +++++
 .../scalar-functions/other-functions/convert-to.md           | 5 +++++
 10 files changed, 50 insertions(+)

diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md
index 563b7293b5160..4bf44009832bd 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md
@@ -43,6 +43,11 @@ Returns a format string. The results for different arguments are shown in the ta
 If the second argument is not one of `'USA', 'JIS', 'ISO', 'EUR', 'INTERNAL'` or is NULL, the function returns NULL.
 
 ## Examples
+<!-- setup-sql
+CREATE TABLE get_format_test (id INT, lc VARCHAR(20)) DISTRIBUTED BY HASH(id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO get_format_test VALUES (1,'USA'),(2,'JIS'),(3,'ISO'),(4,'EUR'),(5,'INTERNAL'),(6,'Doris');
+-->
+
 ```sql
 SELECT * FROM get_format_test
 ```
diff --git a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md
index 917544453f597..b20b2aee8899c 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md
@@ -35,6 +35,11 @@ Returns a value of type TIME, in the format `hour:minute:second`. When the input
 
 ## Example
 
+<!-- setup-sql
+CREATE TABLE test_maketime (id INT, `hour` BIGINT, `minute` BIGINT, sec FLOAT) DISTRIBUTED BY HASH(id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO test_maketime VALUES (1,12,15,30),(2,14,56,12.5789),(3,1234,11,4),(4,-1234,6,52),(5,20,60,12),(6,14,51,66),(7,NULL,15,16),(8,7,NULL,8),(9,1,2,NULL),(10,23,-40,12),(11,20,6,-12);
+-->
+
 ```sql
 SELECT `hour`, `minute`, `sec`, MAKETIME(`hour`, `minute`, `sec`) AS ans FROM `test_maketime`;
 ```
diff --git a/docs/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md b/docs/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
index a98326ae0612d..f3fa898986278 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
@@ -43,6 +43,11 @@ select ipv4_num_to_string(3232235521);
 +--------------------------------+
 ```
 
+<!-- setup-sql
+CREATE TABLE ipv4_bi (num BIGINT) DISTRIBUTED BY HASH(num) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_bi VALUES (-1),(0),(2130706433),(4294967295),(4294967296);
+-->
+
 ```sql
 select num,ipv4_num_to_string(num) from ipv4_bi;
 ```
diff --git a/docs/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md b/docs/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
index e7bfd48ca0474..84da1f95dfb42 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
@@ -38,6 +38,11 @@ select ipv4_string_to_num_or_null('192.168.0.1');
 +-------------------------------------------+ 
 ```
 
+<!-- setup-sql
+CREATE TABLE ipv4_str (str VARCHAR(50)) DISTRIBUTED BY HASH(str) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_str VALUES ('0.0.0.0'),('127.0.0.1'),('255.255.255.255'),('invalid');
+-->
+
 ```sql
 select str, ipv4_string_to_num_or_null(str) from ipv4_str; 
 ```
diff --git a/docs/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md b/docs/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
index 6186c52f763db..7d459b515aa41 100644
--- a/docs/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
+++ b/docs/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
@@ -29,6 +29,11 @@ Returns a VARCHAR value with the converted encoding, allowing proper pinyin-base
 
 ## Examples
 
+<!-- setup-sql
+CREATE TABLE class_test (class_id INT, class_name VARCHAR(50), student_ids ARRAY<INT>) DISTRIBUTED BY HASH(class_id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO class_test VALUES (1,'啊',[1]),(2,'哈',[2]),(3,'哦',[3]),(4,'张',[4]),(5,'我',[5]),(6,'asd',[6]),(7,'qwe',[7]),(8,'z',[8]);
+-->
+
 ```sql
 SELECT * FROM class_test ORDER BY class_name;
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md
index 80756308c97a8..ac3398fdb7a5c 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/get-format.md
@@ -43,6 +43,11 @@ GET_FORMAT({DATE|DATETIME|TIME}, {'EUR'|'USA'|'JIS'|'ISO'|'INTERNAL'})
 当第二个参数不为 `'USA', 'JIS', 'ISO', 'EUR', 'INTERNAL'` 之一或者为 NULL 时返回 NULL
 
 ## 举例
+<!-- setup-sql
+CREATE TABLE get_format_test (id INT, lc VARCHAR(20)) DISTRIBUTED BY HASH(id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO get_format_test VALUES (1,'USA'),(2,'JIS'),(3,'ISO'),(4,'EUR'),(5,'INTERNAL'),(6,'Doris');
+-->
+
 ```sql
 SELECT * FROM get_format_test
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md
index 61b93e30fe176..087e5fe439861 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/date-time-functions/maketime.md
@@ -35,6 +35,11 @@ MAKETIME(`<hour>`, `<minute>`, `<second>`)
 
 ## 举例
 
+<!-- setup-sql
+CREATE TABLE test_maketime (id INT, `hour` BIGINT, `minute` BIGINT, sec FLOAT) DISTRIBUTED BY HASH(id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO test_maketime VALUES (1,12,15,30),(2,14,56,12.5789),(3,1234,11,4),(4,-1234,6,52),(5,20,60,12),(6,14,51,66),(7,NULL,15,16),(8,7,NULL,8),(9,1,2,NULL),(10,23,-40,12),(11,20,6,-12);
+-->
+
 ```sql
 SELECT `hour`, `minute`, `sec`, MAKETIME(`hour`, `minute`, `sec`) AS ans FROM `test_maketime`;
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
index fd38cb1dab6f4..e403cd46a6977 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
@@ -40,6 +40,11 @@ select ipv4_num_to_string(3232235521);
 | 192.168.0.1                    |
 +--------------------------------+
 ```
+<!-- setup-sql
+CREATE TABLE ipv4_bi (num BIGINT) DISTRIBUTED BY HASH(num) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_bi VALUES (-1),(0),(2130706433),(4294967295),(4294967296);
+-->
+
 ```sql
 select num,ipv4_num_to_string(num) from ipv4_bi;
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
index 04509d6fbc067..642249f98fdc8 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
@@ -37,6 +37,11 @@ select ipv4_string_to_num_or_null('192.168.0.1');
 | 3232235521                                | 
 +-------------------------------------------+ 
 ```
+<!-- setup-sql
+CREATE TABLE ipv4_str (str VARCHAR(50)) DISTRIBUTED BY HASH(str) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_str VALUES ('0.0.0.0'),('127.0.0.1'),('255.255.255.255'),('invalid');
+-->
+
 ```sql
 select str, ipv4_string_to_num_or_null(str) from ipv4_str; 
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
index f5b18d9fe2573..71c1976eee0bc 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/current/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
@@ -29,6 +29,11 @@ CONVERT_TO(<column>, <character>)
 
 ## 举例
 
+<!-- setup-sql
+CREATE TABLE class_test (class_id INT, class_name VARCHAR(50), student_ids ARRAY<INT>) DISTRIBUTED BY HASH(class_id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO class_test VALUES (1,'啊',[1]),(2,'哈',[2]),(3,'哦',[3]),(4,'张',[4]),(5,'我',[5]),(6,'asd',[6]),(7,'qwe',[7]),(8,'z',[8]);
+-->
+
 ```sql
 SELECT * FROM class_test ORDER BY class_name;
 ```

From e3f907c267c7c7d58af1060759998d574436ad03 Mon Sep 17 00:00:00 2001
From: boluor <boluor@gmail.com>
Date: Tue, 2 Jun 2026 06:26:51 +0000
Subject: [PATCH 3/3] [fix](sql-functions) apply phantom-table setup to
 version-3.x and version-2.1

Extend the same fix to the three affected pages that also exist in the 3.x and
2.1 doc trees (EN + ZH): CONVERT_TO, IPV4_NUM_TO_STRING, IPV4_STRING_TO_NUM_OR_NULL.
GET_FORMAT and MAKETIME do not exist in 3.x/2.1, so they are not touched.

For CONVERT_TO and IPV4_STRING_TO_NUM_OR_NULL the pages are byte-identical to
version-4.x, so the same `<!-- setup-sql ... -->` block applies. For
IPV4_NUM_TO_STRING the 3.x/2.1 pages differ from 4.x only in frontmatter/heading,
so the setup block was inserted at the same example anchor without touching the
rest of the page.

Verified end-to-end on the matching release clusters: version-3.x docs on a
3.1.4 cluster, version-2.1 docs on a 2.1.11 cluster. Every example now resolves
its table and matches the documented output; no rendered output or expected
result is modified.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
---
 .../scalar-functions/ip-functions/ipv4-num-to-string.md      | 5 +++++
 .../ip-functions/ipv4-string-to-num-or-null.md               | 5 +++++
 .../scalar-functions/other-functions/convert-to.md           | 5 +++++
 .../scalar-functions/ip-functions/ipv4-num-to-string.md      | 5 +++++
 .../ip-functions/ipv4-string-to-num-or-null.md               | 5 +++++
 .../scalar-functions/other-functions/convert-to.md           | 5 +++++
 .../scalar-functions/ip-functions/ipv4-num-to-string.md      | 5 +++++
 .../ip-functions/ipv4-string-to-num-or-null.md               | 5 +++++
 .../scalar-functions/other-functions/convert-to.md           | 5 +++++
 .../scalar-functions/ip-functions/ipv4-num-to-string.md      | 5 +++++
 .../ip-functions/ipv4-string-to-num-or-null.md               | 5 +++++
 .../scalar-functions/other-functions/convert-to.md           | 5 +++++
 12 files changed, 60 insertions(+)

diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
index 503d6584ef96d..3e771b16ccdd0 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
@@ -37,6 +37,11 @@ select ipv4_num_to_string(3232235521);
 | 192.168.0.1                    |
 +--------------------------------+
 ```
+<!-- setup-sql
+CREATE TABLE ipv4_bi (num BIGINT) DISTRIBUTED BY HASH(num) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_bi VALUES (-1),(0),(2130706433),(4294967295),(4294967296);
+-->
+
 ```sql
 select num,ipv4_num_to_string(num) from ipv4_bi;
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
index 04509d6fbc067..642249f98fdc8 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
@@ -37,6 +37,11 @@ select ipv4_string_to_num_or_null('192.168.0.1');
 | 3232235521                                | 
 +-------------------------------------------+ 
 ```
+<!-- setup-sql
+CREATE TABLE ipv4_str (str VARCHAR(50)) DISTRIBUTED BY HASH(str) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_str VALUES ('0.0.0.0'),('127.0.0.1'),('255.255.255.255'),('invalid');
+-->
+
 ```sql
 select str, ipv4_string_to_num_or_null(str) from ipv4_str; 
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
index f5b18d9fe2573..71c1976eee0bc 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
@@ -29,6 +29,11 @@ CONVERT_TO(<column>, <character>)
 
 ## 举例
 
+<!-- setup-sql
+CREATE TABLE class_test (class_id INT, class_name VARCHAR(50), student_ids ARRAY<INT>) DISTRIBUTED BY HASH(class_id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO class_test VALUES (1,'啊',[1]),(2,'哈',[2]),(3,'哦',[3]),(4,'张',[4]),(5,'我',[5]),(6,'asd',[6]),(7,'qwe',[7]),(8,'z',[8]);
+-->
+
 ```sql
 SELECT * FROM class_test ORDER BY class_name;
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
index 503d6584ef96d..3e771b16ccdd0 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
@@ -37,6 +37,11 @@ select ipv4_num_to_string(3232235521);
 | 192.168.0.1                    |
 +--------------------------------+
 ```
+<!-- setup-sql
+CREATE TABLE ipv4_bi (num BIGINT) DISTRIBUTED BY HASH(num) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_bi VALUES (-1),(0),(2130706433),(4294967295),(4294967296);
+-->
+
 ```sql
 select num,ipv4_num_to_string(num) from ipv4_bi;
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
index 04509d6fbc067..642249f98fdc8 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
@@ -37,6 +37,11 @@ select ipv4_string_to_num_or_null('192.168.0.1');
 | 3232235521                                | 
 +-------------------------------------------+ 
 ```
+<!-- setup-sql
+CREATE TABLE ipv4_str (str VARCHAR(50)) DISTRIBUTED BY HASH(str) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_str VALUES ('0.0.0.0'),('127.0.0.1'),('255.255.255.255'),('invalid');
+-->
+
 ```sql
 select str, ipv4_string_to_num_or_null(str) from ipv4_str; 
 ```
diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
index f5b18d9fe2573..71c1976eee0bc 100644
--- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
+++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
@@ -29,6 +29,11 @@ CONVERT_TO(<column>, <character>)
 
 ## 举例
 
+<!-- setup-sql
+CREATE TABLE class_test (class_id INT, class_name VARCHAR(50), student_ids ARRAY<INT>) DISTRIBUTED BY HASH(class_id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO class_test VALUES (1,'啊',[1]),(2,'哈',[2]),(3,'哦',[3]),(4,'张',[4]),(5,'我',[5]),(6,'asd',[6]),(7,'qwe',[7]),(8,'z',[8]);
+-->
+
 ```sql
 SELECT * FROM class_test ORDER BY class_name;
 ```
diff --git a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
index f3efbdf05e62b..b45d772eaaec4 100644
--- a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
+++ b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
@@ -40,6 +40,11 @@ select ipv4_num_to_string(3232235521);
 +--------------------------------+
 ```
 
+<!-- setup-sql
+CREATE TABLE ipv4_bi (num BIGINT) DISTRIBUTED BY HASH(num) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_bi VALUES (-1),(0),(2130706433),(4294967295),(4294967296);
+-->
+
 ```sql
 select num,ipv4_num_to_string(num) from ipv4_bi;
 ```
diff --git a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
index e7bfd48ca0474..84da1f95dfb42 100644
--- a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
+++ b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
@@ -38,6 +38,11 @@ select ipv4_string_to_num_or_null('192.168.0.1');
 +-------------------------------------------+ 
 ```
 
+<!-- setup-sql
+CREATE TABLE ipv4_str (str VARCHAR(50)) DISTRIBUTED BY HASH(str) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_str VALUES ('0.0.0.0'),('127.0.0.1'),('255.255.255.255'),('invalid');
+-->
+
 ```sql
 select str, ipv4_string_to_num_or_null(str) from ipv4_str; 
 ```
diff --git a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
index 6186c52f763db..7d459b515aa41 100644
--- a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
+++ b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
@@ -29,6 +29,11 @@ Returns a VARCHAR value with the converted encoding, allowing proper pinyin-base
 
 ## Examples
 
+<!-- setup-sql
+CREATE TABLE class_test (class_id INT, class_name VARCHAR(50), student_ids ARRAY<INT>) DISTRIBUTED BY HASH(class_id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO class_test VALUES (1,'啊',[1]),(2,'哈',[2]),(3,'哦',[3]),(4,'张',[4]),(5,'我',[5]),(6,'asd',[6]),(7,'qwe',[7]),(8,'z',[8]);
+-->
+
 ```sql
 SELECT * FROM class_test ORDER BY class_name;
 ```
diff --git a/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md b/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
index f3efbdf05e62b..b45d772eaaec4 100644
--- a/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
+++ b/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-num-to-string.md
@@ -40,6 +40,11 @@ select ipv4_num_to_string(3232235521);
 +--------------------------------+
 ```
 
+<!-- setup-sql
+CREATE TABLE ipv4_bi (num BIGINT) DISTRIBUTED BY HASH(num) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_bi VALUES (-1),(0),(2130706433),(4294967295),(4294967296);
+-->
+
 ```sql
 select num,ipv4_num_to_string(num) from ipv4_bi;
 ```
diff --git a/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md b/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
index e7bfd48ca0474..84da1f95dfb42 100644
--- a/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
+++ b/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/ip-functions/ipv4-string-to-num-or-null.md
@@ -38,6 +38,11 @@ select ipv4_string_to_num_or_null('192.168.0.1');
 +-------------------------------------------+ 
 ```
 
+<!-- setup-sql
+CREATE TABLE ipv4_str (str VARCHAR(50)) DISTRIBUTED BY HASH(str) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO ipv4_str VALUES ('0.0.0.0'),('127.0.0.1'),('255.255.255.255'),('invalid');
+-->
+
 ```sql
 select str, ipv4_string_to_num_or_null(str) from ipv4_str; 
 ```
diff --git a/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md b/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
index 6186c52f763db..7d459b515aa41 100644
--- a/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
+++ b/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/other-functions/convert-to.md
@@ -29,6 +29,11 @@ Returns a VARCHAR value with the converted encoding, allowing proper pinyin-base
 
 ## Examples
 
+<!-- setup-sql
+CREATE TABLE class_test (class_id INT, class_name VARCHAR(50), student_ids ARRAY<INT>) DISTRIBUTED BY HASH(class_id) BUCKETS 1 PROPERTIES("replication_num"="1");
+INSERT INTO class_test VALUES (1,'啊',[1]),(2,'哈',[2]),(3,'哦',[3]),(4,'张',[4]),(5,'我',[5]),(6,'asd',[6]),(7,'qwe',[7]),(8,'z',[8]);
+-->
+
 ```sql
 SELECT * FROM class_test ORDER BY class_name;
 ```