From d3024a8871097f039e4b79b0554a64867dfa2706 Mon Sep 17 00:00:00 2001 From: plchy2 Date: Wed, 17 Dec 2025 12:37:42 +0530 Subject: [PATCH 1/2] Fix inconsistency in ARRAY_SIZE(NULL) documentation --- .../scalar-functions/array-functions/array-size.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md index f5fdba5f6f865..bd511b73be5c6 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md @@ -28,7 +28,8 @@ ARRAY_SIZE() ## 返回值 -返回数组中元素数量，如果输入数组为 NULL，则返回 NULL +返回数组中元素数量，如果输入数组为 NULL，则返回数组的大小，当前示例中返回 1 + ## 举例 From 025600565e857bfbc5bcf53fce4ec3040a19007b Mon Sep 17 00:00:00 2001 From: plchy2 Date: Fri, 19 Dec 2025 13:19:53 +0530 Subject: [PATCH 2/2] Align ARRAY_SIZE examples for NULL vs array containing NULL across docs --- .../scalar-functions/array-functions/array-size.md | 9 +++++---- .../scalar-functions/array-functions/array-size.md | 6 +++--- .../scalar-functions/array-functions/array-size.md | 2 +- .../scalar-functions/array-functions/array-size.md | 6 +++--- 4 files changed, 12 insertions(+), 11 deletions(-) diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md index bd511b73be5c6..c55be62353fd5 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-2.1/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md @@ -28,19 +28,20 @@ ARRAY_SIZE() ## 返回值 -返回数组中元素数量，如果输入数组为 NULL，则返回数组的大小，当前示例中返回 1 +返回数组中元素数量，如果输入数组为 NULL，则返回 NULL + ## 举例 ```sql -SELECT ARRAY_SIZE(['a', 'b', 'c']),ARRAY_SIZE([NULL]),ARRAY_SIZE([]); +SELECT ARRAY_SIZE(['a', 'b', 'c']),ARRAY_SIZE(NULL),ARRAY_SIZE([]); ``` ```text +------------------------------+---------------------+-----------------+ -| cardinality(['a', 'b', 'c']) | cardinality([NULL]) | cardinality([]) | +| cardinality(['a', 'b', 'c']) | cardinality(NULL) | cardinality([]) | +------------------------------+---------------------+-----------------+ -| 3 | 1 | 0 | +| 3 | NULL | 0 | +------------------------------+---------------------+-----------------+ ``` diff --git a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md index f5fdba5f6f865..786dde0c85fef 100644 --- a/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md +++ b/i18n/zh-CN/docusaurus-plugin-content-docs/version-3.x/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md @@ -33,13 +33,13 @@ ARRAY_SIZE() ## 举例 ```sql -SELECT ARRAY_SIZE(['a', 'b', 'c']),ARRAY_SIZE([NULL]),ARRAY_SIZE([]); +SELECT ARRAY_SIZE(['a', 'b', 'c']),ARRAY_SIZE(NULL),ARRAY_SIZE([]); ``` ```text +------------------------------+---------------------+-----------------+ -| cardinality(['a', 'b', 'c']) | cardinality([NULL]) | cardinality([]) | +| cardinality(['a', 'b', 'c']) | cardinality(NULL) | cardinality([]) | +------------------------------+---------------------+-----------------+ -| 3 | 1 | 0 | +| 3 | NULL | 0 | +------------------------------+---------------------+-----------------+ ``` diff --git a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md index 02d67e45b144e..33187cb154eb3 100644 --- a/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md +++ b/versioned_docs/version-2.1/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md @@ -40,6 +40,6 @@ SELECT ARRAY_SIZE(['a', 'b', 'c']),ARRAY_SIZE([NULL]),ARRAY_SIZE([]); +------------------------------+---------------------+-----------------+ | cardinality(['a', 'b', 'c']) | cardinality([NULL]) | cardinality([]) | +------------------------------+---------------------+-----------------+ -| 3 | 1 | 0 | +| 3 | NULL | 0 | +------------------------------+---------------------+-----------------+ ``` diff --git a/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md b/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md index 02d67e45b144e..91b33abe9ff6e 100644 --- a/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md +++ b/versioned_docs/version-3.x/sql-manual/sql-functions/scalar-functions/array-functions/array-size.md @@ -33,13 +33,13 @@ Returns the number of elements in the array. If the input array is NULL, it retu ## Example ```sql -SELECT ARRAY_SIZE(['a', 'b', 'c']),ARRAY_SIZE([NULL]),ARRAY_SIZE([]); +SELECT ARRAY_SIZE(['a', 'b', 'c']),ARRAY_SIZE(NULL),ARRAY_SIZE([]); ``` ```text +------------------------------+---------------------+-----------------+ -| cardinality(['a', 'b', 'c']) | cardinality([NULL]) | cardinality([]) | +| cardinality(['a', 'b', 'c']) | cardinality(NULL) | cardinality([]) | +------------------------------+---------------------+-----------------+ -| 3 | 1 | 0 | +| 3 | NULL | 0 | +------------------------------+---------------------+-----------------+ ```