This is an automated email from the ASF dual-hosted git repository.
libenchao pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/flink.git
The following commit(s) were added to refs/heads/master by this push:
new fc7d821dfa1 [FLINK-31787][docs] Add explicit ROW constructor to sql
functions doc
fc7d821dfa1 is described below
commit fc7d821dfa16bad8ca58cb716b1b429d55b8317a
Author: Aitozi <[email protected]>
AuthorDate: Thu Apr 13 10:06:24 2023 +0800
[FLINK-31787][docs] Add explicit ROW constructor to sql functions doc
Close apache/flink#22386
---
docs/data/sql_functions.yml | 9 +++++++--
docs/data/sql_functions_zh.yml | 11 ++++++++---
docs/layouts/shortcodes/sql_functions.html | 2 +-
docs/layouts/shortcodes/sql_functions_zh.html | 2 +-
4 files changed, 17 insertions(+), 7 deletions(-)
diff --git a/docs/data/sql_functions.yml b/docs/data/sql_functions.yml
index 471b3bcfea1..1aa2ca0872e 100644
--- a/docs/data/sql_functions.yml
+++ b/docs/data/sql_functions.yml
@@ -931,13 +931,18 @@ json:
valueconstruction:
- sql: |
- -- implicit constructor with parenthesis
+ **implicit** constructor with parenthesis
+
(value1 [, value2]*)
+
+ **explicit** ROW constructor with
+
+ ROW(value1 [, value2]*)
table: row(ANY1, ANY2, ...)
description: |
Returns a row created from a list of values (value1, value2,...).
- The implicit row constructor supports arbitrary expressions as fields
but requires at least two fields. The explicit row constructor can deal with an
arbitrary number of fields but does not support all kinds of field expressions
well currently.
+ The implicit row constructor requires at least two fields. The explicit
row constructor can deal with an arbitrary number of fields. Both of them
support arbitrary expressions as fields.
- sql: ARRAY ‘[’ value1 [, value2 ]* ‘]’
table: array(ANY1, ANY2, ...)
description: Returns an array created from a list of values (value1,
value2, ...).
diff --git a/docs/data/sql_functions_zh.yml b/docs/data/sql_functions_zh.yml
index c3c24d555b2..c0e7a1995ef 100644
--- a/docs/data/sql_functions_zh.yml
+++ b/docs/data/sql_functions_zh.yml
@@ -985,12 +985,17 @@ json:
valueconstruction:
- sql: |
- -- implicit constructor with parenthesis
+ **implicit** constructor with parenthesis
+
(value1 [, value2]*)
+
+ **explicit** ROW constructor with
+
+ ROW(value1 [, value2]*)
table: row(ANY1, ANY2, ...)
description: |
- 返回从值列表 (value1, value2, ...) 创建的行。隐式行构造函数支持任意表达式作为字段，但至少需要两个字段。
- 显式行构造函数可以处理任意数量的字段，但目前还不能很好地支持所有类型的字段表达式。
+ 返回从值列表 (value1, value2, ...) 创建的行。隐式行构造函数至少需要两个字段。显式行构造函数可以处理任意数量的字段。
+ 两者都支持任意表达式作为字段
- sql: ARRAY ‘[’ value1 [, value2 ]* ‘]’
table: array(ANY1, ANY2, ...)
description: 返回从值列表 (value1, value2, ...) 创建的数组。
diff --git a/docs/layouts/shortcodes/sql_functions.html
b/docs/layouts/shortcodes/sql_functions.html
index ec8667ee1c7..a8e3557778c 100644
--- a/docs/layouts/shortcodes/sql_functions.html
+++ b/docs/layouts/shortcodes/sql_functions.html
@@ -35,7 +35,7 @@ under the License.
{{ range $category }}
<tr>
<td>
- {{ .sql | default "N/A" }}
+ {{ .sql | $.Page.RenderString | default "N/A" }}
</td>
<td>
{{ .table | default "N/A" }}
diff --git a/docs/layouts/shortcodes/sql_functions_zh.html
b/docs/layouts/shortcodes/sql_functions_zh.html
index 4047517c30c..949fa00d363 100644
--- a/docs/layouts/shortcodes/sql_functions_zh.html
+++ b/docs/layouts/shortcodes/sql_functions_zh.html
@@ -35,7 +35,7 @@ under the License.
{{ range $category }}
<tr>
<td>
- {{ .sql | default "不适用" }}
+ {{ .sql | $.Page.RenderString | default "不适用" }}
</td>
<td>
{{ .table | default "不适用" }}
