This is an automated email from the ASF dual-hosted git repository.
morningman pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/doris-website.git
The following commit(s) were added to refs/heads/master by this push:
new fc8fa9ebbc7d docs(i18n): machine Japanese translation candidates
(#4573)
fc8fa9ebbc7d is described below
commit fc8fa9ebbc7de77061820a5daf4ee70687f098f7
Author: Mingyu Chen (Rayner) <[email protected]>
AuthorDate: Mon Nov 2 13:08:56 2026 +0000
docs(i18n): machine Japanese translation candidates (#4573)
## Japanese translation candidate
Source commit: `618ed23852c4c67b16296910731076bb11594a09`
Model: `gpt-6-sol`; glossary: `1`
Review status: machine. Japanese proofreading and the normal PR checks
are still required.
| Action | Version | English source | SHA-256 prefix | Generation |
| --- | --- | --- | --- | --- |
| update | 4.x |
[`versioned_docs/version-4.x/sql-manual/basic-element/sql-data-types/string-type/STRING.md`](https://github.com/apache/doris-website/blob/618ed23852c4c67b16296910731076bb11594a09/versioned_docs/version-4.x/sql-manual/basic-element/sql-data-types/string-type/STRING.md)
| `ae7d4809e879` | full (chinese-reference-changed) |
| update | 4.x |
[`versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/ai-agg.md`](https://github.com/apache/doris-website/blob/618ed23852c4c67b16296910731076bb11594a09/versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/ai-agg.md)
| `88c0b72b8baf` | full (chinese-reference-changed) |
| update | 4.x |
[`versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/linear-histogram.md`](https://github.com/apache/doris-website/blob/618ed23852c4c67b16296910731076bb11594a09/versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/linear-histogram.md)
| `273fd40d6143` | full (chinese-reference-changed) |
| update | 4.x |
[`versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max-by.md`](https://github.com/apache/doris-website/blob/618ed23852c4c67b16296910731076bb11594a09/versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max-by.md)
| `2eca5f83a98f` | full (chinese-reference-changed) |
| update | 4.x |
[`versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max.md`](https://github.com/apache/doris-website/blob/618ed23852c4c67b16296910731076bb11594a09/versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max.md)
| `56248684c4df` | full (chinese-reference-changed) |
| update | 4.x |
[`versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min-by.md`](https://github.com/apache/doris-website/blob/618ed23852c4c67b16296910731076bb11594a09/versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min-by.md)
| `d7986eec336f` | full (chinese-reference-changed) |
| update | 4.x |
[`versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min.md`](https://github.com/apache/doris-website/blob/618ed23852c4c67b16296910731076bb11594a09/versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min.md)
| `a47b1597c3bd` | full (chinese-reference-changed) |
| update | 4.x |
[`versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-array.md`](https://github.com/apache/doris-website/blob/618ed23852c4c67b16296910731076bb11594a09/versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-array.md)
| `f47e5bf19fcf` | full (chinese-reference-changed) |
| update | 4.x |
[`versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-weighted.md`](https://github.com/apache/doris-website/blob/618ed23852c4c67b16296910731076bb11594a09/versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-weighted.md)
| `1deded4278f0` | full (chinese-reference-changed) |
| update | 4.x |
[`versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn.md`](https://github.com/apache/doris-website/blob/618ed23852c4c67b16296910731076bb11594a09/versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn.md)
| `8cb60a3bc3bd` | full (chinese-reference-changed) |
## Failed or skipped tasks
- `T06-4X-046482001207913`
(versioned_docs/version-4.x/lakehouse/catalogs/lance-catalog.mdx): No
usable document after three attempts: Codex translation failed:
ETIMEDOUT
## Candidates retained with warnings
-
`versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max-by.md`:
third attempt retained for review. protected-content: Restore protected
source content: protected node 11: expected ["code","text",null,"Table
created and data inserted successfully."]; received
["code","text",null,"テーブルの作成とデータの挿入に成功しました。"]
-
`versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max.md`:
third attempt retained for review. protected-content: Restore protected
source content: protected node 9: expected ["code","sql",null,"--
setup\ncreate table t1(\n k1 int,\n k_string varchar(100),\n k_decimal
decimal(10, 2),\n k_array array<int>\n) distributed by hash (k1) buckets
1\nproperties (\"replication_num\"=\"1\");\ninsert into t1 values \n (1,
'apple', 10.01, [10, 20, 30]),\n (1, 'banana', 20.02, [10, 20]),\n (2,
'orange', 30.03, [10, 20, 40]),\n (2, null, null, [10, 20, null]),\n (3,
null, null, null);"]; received ["code","sql",null,"-- setup\ncreate
table t1(\n k1 int,\n k_string varchar(100),\n k_decimal decimal(10,
2),\n k_array array<int>\n) distributed by hash (k1) buckets
1\nproperties (\"replication_num\"=\"1\");\ninsert into t1 values\n (1,
'apple', 10.01, [10, 20, 30]),\n (1, 'banana', 20.02, [10, 20]),\n (2,
'orange', 30.03, [10, 20, 40]),\n (2, null, null, [10, 20, null]),\n (3,
null, null, null);"]
-
`versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min-by.md`:
third attempt retained for review. protected-content: Restore protected
source content: protected node 6: expected
["code","sql",null,"MIN_BY(<expr1>, <expr2>)"]; received
["inlineCode",null,null,"NULL"] protected node 7: expected
["inlineCode",null,null,"<expr1>"]; received
["code","sql",null,"MIN_BY(<expr1>, <expr2>)"] protected node 8:
expected ["inlineCode",null,null,"<expr2>"]; received
["inlineCode",null,null,"<expr1>"]
-
`versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min.md`:
third attempt retained for review. protected-content: Restore protected
source content: protected node 9: expected ["code","sql",null,"--
setup\ncreate table t1(\n k1 int,\n k_string varchar(100),\n k_decimal
decimal(10, 2),\n k_array array<int>\n) distributed by hash (k1) buckets
1\nproperties (\"replication_num\"=\"1\");\ninsert into t1 values \n (1,
'apple', 10.01, [10, 20, 30]),\n (1, 'banana', 20.02, [10, 20]),\n (2,
'orange', 30.03, [10, 20, 40]),\n (2, null, null, [10, 20, null]),\n (3,
null, null, null);"]; received ["code","sql",null,"-- setup\ncreate
table t1(\n k1 int,\n k_string varchar(100),\n k_decimal decimal(10,
2),\n k_array array<int>\n) distributed by hash (k1) buckets
1\nproperties (\"replication_num\"=\"1\");\ninsert into t1 values\n (1,
'apple', 10.01, [10, 20, 30]),\n (1, 'banana', 20.02, [10, 20]),\n (2,
'orange', 30.03, [10, 20, 40]),\n (2, null, null, [10, 20, null]),\n (3,
null, null, null);"] protected node 10: expected
["code","text",null,"Table created and data inserted successfully."];
received ["code","text",null,"テーブルが作成され、データが正常に挿入されました。"]
## Validation
Updates at or below 30% translate only changed Markdown/MDX blocks and
preserve other target blocks.
Change size is the sum of max(removed, added) non-empty English lines
per diff hunk, divided by the larger old/new line count.
New documents, larger updates, glossary changes or baselines that cannot
be aligned use full translation.
Generation uses at most three attempts per document. Deletions and
code-only updates may need no model call.
Each retry receives the earlier validation errors. Third-attempt content
issues are retained as warnings above.
Full attempt history and diagnostics are in generation.json and the page
state records.
Committed source hashes, managed paths and target/state hashes are
checked before applying candidates.
Master is checked before each model call and before publishing:
unrelated merges are allowed, a page changed on master is dropped, and a
translation configuration or tooling change discards the batch.
The publisher runs the shared PR translation-state, syntax and
internal-link checks before pushing.
The normal PR build and human proofreading are still required before
merging.
<!-- japanese-translation-automation:v1
bot-head=f7b945acb0daaa07ec2ecdaef552f72ff23c585b -->
Shared PR admission checks: passed (translation state, syntax, internal
links).
Co-authored-by: morningman <[email protected]>
---
.../sql-data-types/string-type/STRING.md | 12 ++--
.../sql-functions/aggregate-functions/ai-agg.md | 46 ++++++++-------
.../aggregate-functions/linear-histogram.md | 42 +++++++++-----
.../sql-functions/aggregate-functions/max-by.md | 53 +++++++++++++----
.../sql-functions/aggregate-functions/max.md | 66 +++++++++++++---------
.../sql-functions/aggregate-functions/min-by.md | 53 +++++++++++++----
.../sql-functions/aggregate-functions/min.md | 52 ++++++++++-------
.../aggregate-functions/topn-array.md | 36 +++++++-----
.../aggregate-functions/topn-weighted.md | 40 ++++++++-----
.../sql-functions/aggregate-functions/topn.md | 35 ++++++++----
.../sql-data-types/string-type/STRING.json | 38 +++++++++++--
.../sql-functions/aggregate-functions/ai-agg.json | 47 +++++++++++++--
.../aggregate-functions/linear-histogram.json | 38 +++++++++++--
.../sql-functions/aggregate-functions/max-by.json | 66 ++++++++++++++++++++--
.../sql-functions/aggregate-functions/max.json | 66 ++++++++++++++++++++--
.../sql-functions/aggregate-functions/min-by.json | 66 ++++++++++++++++++++--
.../sql-functions/aggregate-functions/min.json | 66 ++++++++++++++++++++--
.../aggregate-functions/topn-array.json | 38 +++++++++++--
.../aggregate-functions/topn-weighted.json | 38 +++++++++++--
.../sql-functions/aggregate-functions/topn.json | 38 +++++++++++--
20 files changed, 726 insertions(+), 210 deletions(-)
diff --git
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/basic-element/sql-data-types/string-type/STRING.md
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/basic-element/sql-data-types/string-type/STRING.md
index dd5b914c87bd..fc06468bb647 100644
---
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/basic-element/sql-data-types/string-type/STRING.md
+++
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/basic-element/sql-data-types/string-type/STRING.md
@@ -2,15 +2,15 @@
{
"title": "STRING",
"language": "ja",
- "description": "可変長文字列。デフォルトでは 1048576 バイト (1M) までサポートし、2147483643 バイト
(2G) まで調整できます。"
+ "description": "可変長文字列。デフォルトで10485760バイト（10
MiB）をサポートし、最大2147483643バイト（2G）まで調整可能です。"
}
---
-## STRING
-### 説明
-可変長文字列です。デフォルトでは 1048576 バイト (1M) までサポートし、2147483643 バイト (2G)
まで調整できます。また、STRING 型の長さは、BE の設定項目 string_type_length_soft_limit_bytes (STRING
型の長さに対するソフトリミット) によっても制限されます。STRING 型は値列でのみ使用でき、キー列、パーティション列、バケット列には使用できません。
+## STRING {#string}
+### 説明 {#description}
+デフォルトのソフト長さ制限が10485760バイト（10 MiB）の可変長文字列です。BE で
`string_type_length_soft_limit_bytes` を設定すると、この制限を最大2147483643バイト（約2
GiB）まで引き上げられます。STRING は value 列でのみ使用でき、key 列、パーティション列、バケット列では使用できません。
-注: 可変長文字列は UTF-8 で格納されるため、通常、英語の文字は 1 バイト、中国語の文字は 3 バイトを占めます。
+注: 可変長文字列は UTF-8 エンコーディングで保存されるため、通常、英字は1バイト、中国語文字は3バイトを占有します。
-### キーワード
+### キーワード {#keywords}
STRING
diff --git
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/ai-agg.md
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/ai-agg.md
index 3a0872dea034..61db9c347ec4 100644
---
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/ai-agg.md
+++
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/ai-agg.md
@@ -2,37 +2,43 @@
{
"title": "AI_AGG",
"language": "ja",
- "description": "ユーザーが指定した指示に従い、大規模言語モデルを使って特定の列を集約します。"
+ "description": "ユーザーが指定した指示に従い、大規模言語モデルを使用して特定の列を集約します。"
}
---
-## 説明
+## 説明 {#description}
-ユーザーが指定した指示に従い、大規模言語モデルを使って特定の列を集約します。
+ユーザーが指定した指示に従い、大規模言語モデルを使用して特定の列を集約します。
-## 構文
+## 構文 {#syntax}
-`AI_AGG([<resource_name>], <expr>, <instruction>)`
+```sql
+AI_AGG([<resource_name>], <expr>, <instruction>)
+```
+
+<a id="parameter-description"></a>
-## パラメータの説明
+## パラメータ {#parameters}
-| パラメータ | 説明 |
-| --- | --- |
-| `<resource_name>` | 使用するリソース名。省略可能です。 |
-| `<expr>` | 集約するテキスト列。個々のテキストは 128K 文字未満である必要があります。 |
-| `<instruction>` | 実行する指示。リテラルのみ指定できます。 |
+| パラメータ | 説明 |
+| ----------------- |
--------------------------------------------------------- |
+| `<resource_name>` | 指定されたリソース名。省略可能です。 |
+| `<expr>` | 集約対象のテキスト列。単一のテキストの文字数は 128K 未満である必要があります。|
+| `<instruction>` | 実行する指示。リテラルのみ受け付けます。 |
-## 戻り値
+## 戻り値 {#return-value}
+
+バージョン 4.1.5 以降、AI_AGG はモデルが生成した完全なテキストを単一の結果として返します。テキストに JSON
配列が含まれていても、その配列を複数の集約結果に分割しません。OpenAI Responses 形式では、reasoning や tool
項目などのテキスト以外の出力をスキップし、message 項目の `output_text` を連結します。レスポンスにステータスが含まれる場合は
`completed` でなければならず、未完了のレスポンスやテキストを含まないレスポンスではエラーが報告されます。
集約結果を含む文字列を返します。
すべての入力値が NULL の場合は NULL を返します。
-結果は言語モデルが生成するため、出力は固定されません。
+結果は言語モデルによって生成されるため、出力は固定されません。
-## 例
+## 例 {#example}
-次のテーブルは、カスタマーサポートの問い合わせを模しています。
+次のテーブルは、カスタマーサポートチケットをシミュレートしたものです。
```sql
CREATE TABLE support_tickets (
ticket_id BIGINT,
@@ -54,7 +60,7 @@ INSERT INTO support_tickets VALUES
(5, 'Eve', 'Login Failure', 'Getting redirected back to login after entering
2FA code.');
```
-`AI_AGG` を使用すると、問題の主題ごとに顧客の問い合わせを要約できます。
+問題の件名ごとに顧客の問題を要約するには、`AI_AGG` を使用できます。
```sql
SELECT
subject,
@@ -77,9 +83,9 @@ GROUP BY subject;
+------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
```
-ケース 2：
+例 2：
-次のテーブルは、EC サイトのユーザーレビューを模しています。
+次のテーブルは、eコマースプラットフォームのユーザーレビューテーブルをシミュレートしたものです。
```sql
CREATE TABLE product_reviews (
review_id BIGINT,
@@ -105,7 +111,7 @@ INSERT INTO product_reviews VALUES
(9, 1004, 5, '降噪给力，地铁里也能安静听歌，续航一周充一次。');
```
-AI_AGG を使って要約・評価する場合:
+AI_AGG を使用して要約および評価を行います。
```sql
SET default_ai_resource = 'ai_resource_name';
SELECT
@@ -127,4 +133,4 @@ GROUP BY product_id;
| 1001 | 买家普遍认为鞋子穿着舒适、外观好看且物流快，但鞋底偏硬且有轻微胶味。
|
| 1002 | 买家认为该榨汁杯小巧便携、出汁快且易清洗，但电池续航短且售后换货流程慢。
|
+------------+--------------------------------------------------------------------------------------------------------------+
-```
\ No newline at end of file
+```
diff --git
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/linear-histogram.md
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/linear-histogram.md
index a172e2db55dd..cb4ce700a2d0 100644
---
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/linear-histogram.md
+++
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/linear-histogram.md
@@ -2,32 +2,33 @@
{
"title": "LINEAR_HISTOGRAM",
"language": "ja",
- "description": "LINEARHISTOGRAM 関数はデータの分布を表します。"
+ "description": "LINEARHISTOGRAM 関数はデータ分布を表すために使用します。"
}
---
-## 説明
+## 説明 {#description}
-LINEAR_HISTOGRAM 関数はデータの分布を表します。「等幅」のバケット分割方式を使用し、データの値の大きさに応じてバケットに分割します。
+LINEAR_HISTOGRAM 関数はデータ分布を表すために使用します。「等幅」のバケット化戦略を使用し、値の大きさに応じてデータをバケットに分割します。
-## 構文
+## 構文 {#syntax}
```sql
-LINEAR_HISTOGRAM(<expr>, DOUBLE <interval>[, DOUBLE <offset>])
+LINEAR_HISTOGRAM(<expr>, <interval> [, <offset>])
```
-## パラメータ
+## パラメータ {#parameters}
| パラメータ | 説明 |
| -- | -- |
-| `interval` | バケットの幅。サポートされる型は
TinyInt、SmallInt、Int、BigInt、LargeInt、Float、Double、Decimal です。 |
-| `offset` | 省略可能。デフォルト値は 0 で、範囲は `[0, interval)` です。Double 型をサポートします。 |
+| `<expr>` |
集計対象の式。BOOLEAN、TINYINT、SMALLINT、INT、BIGINT、LARGEINT、FLOAT、DOUBLE、DECIMAL
をサポートします。Doris 4.1 シリーズでは 4.1.5 以降で BOOLEAN 入力がサポートされ、FALSE と TRUE はそれぞれ 0 と 1
としてカウントされます。 |
+| `<interval>` | バケット幅。DOUBLE 型。0 より大きくする必要があります。 |
+| `<offset>` | オプションの DOUBLE オフセット。デフォルトは 0 で、`[0, interval)` の範囲内である必要があります。 |
-## 戻り値
+## 戻り値 {#return-value}
-計算結果を JSON 型の値として返します。
+バケット境界、件数、累積件数を含む JSON テキストを VARCHAR として返します。NULL 入力は無視されます。すべての入力が NULL
である場合、または入力行がない場合は、`{"num_buckets":0,"buckets":[]}` を返します。
-## 例
+## 例 {#example}
```sql
-- setup
@@ -76,9 +77,20 @@ select linear_histogram(a, 2, 1) from histogram_test where a
is null;
フィールドの説明：
-- `num_buckets`: バケットの数。
+- `num_buckets`: バケット数。
- `buckets`: ヒストグラム内のバケット。
- - `lower`: 下限（この値を含みます）。
- - `upper`: 上限（この値を含みません）。
+ - `lower`: 下限（包含）。
+ - `upper`: 上限（排他）。
- `count`: バケット内の要素数。
- - `acc_count`: このバケットまでの累積要素数。
+ - `acc_count`: このバケットまでの累積件数。
+
+BOOLEAN 入力では 0 と 1 のバケットを使用し、NULL はカウントに含めません：
+
+```sql
+SELECT LINEAR_HISTOGRAM(b, 1.0)
+FROM (SELECT TRUE AS b UNION ALL SELECT FALSE UNION ALL SELECT TRUE UNION ALL
SELECT NULL) t;
+```
+
+```text
+{"num_buckets":2,"buckets":[{"lower":0.0,"upper":1.0,"count":1,"acc_count":1},{"lower":1.0,"upper":2.0,"count":2,"acc_count":3}]}
+```
diff --git
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max-by.md
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max-by.md
index 80d342dceed0..2181851c010b 100644
---
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max-by.md
+++
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max-by.md
@@ -2,33 +2,37 @@
{
"title": "MAX_BY",
"language": "ja",
- "description": "MAX_BY 関数は、指定した列の最大値に対応する値を返します。"
+ "description": "MAX_BY 関数は、指定した列の最大値に基づいて関連する値を返します。"
}
---
-## 説明
+## 説明 {#description}
-MAX_BY 関数は、指定した列の最大値に対応する値を返します。
+MAX_BY 関数は、指定した列の最大値に基づいて関連する値を返します。
-## 構文
+`<expr2>` が Array の場合、配列は要素ごとに辞書順で比較されます。NULL 要素は、NULL
でない要素より大きい値として扱われます。配列値全体が NULL の場合は無視されます。
+
+バージョンによる違い: Doris 4.1 系列の 4.1.5 以降、および Doris 4.2 以降では、配列内の `NULL` 要素は `NULL`
でない要素より大きい値として比較されます。Doris 4.0 および 4.1.5 より前の Doris 4.1 では、配列内の `NULL` 要素は NULL
でない要素より小さい値として比較されます。配列値全体が `NULL` の場合は、これらすべてのバージョンで無視されます。
+
+## 構文 {#syntax}
```sql
MAX_BY(<expr1>, <expr2>)
```
-## パラメータ
+## パラメータ {#parameters}
| パラメータ | 説明 |
-| -- | -- |
-| `<expr1>` |
対応する値を指定する式。Bool、TinyInt、SmallInt、Int、BigInt、LargeInt、Float、Double、Decimal、String、Date、Datetime、Array、Map、Struct
型をサポートします。 |
-| `<expr2>` |
最大値を求める式。Bool、TinyInt、SmallInt、Int、BigInt、LargeInt、Float、Double、Decimal、String、Date、Datetime、Array
型をサポートします。 |
+| --- | --- |
+| `<expr1>` | 関連値に使用する式。Bool, TinyInt, SmallInt, Int, BigInt, LargeInt, Float,
Double, Decimal, String, Date, Datetime, Array, Map, Struct 型をサポートします。 |
+| `<expr2>` | 最大値に使用する式。Bool, TinyInt, SmallInt, Int, BigInt, LargeInt, Float,
Double, Decimal, String, Date, Datetime, Array 型をサポートします。 |
-## 戻り値
+## 戻り値 {#return-value}
-<expr1> と同じデータ型の値を返します。
+<expr1> と同じデータ型を返します。
グループ内に有効なデータがない場合は NULL を返します。
-## 例
+## 例 {#example}
```sql
-- setup
@@ -47,6 +51,10 @@ insert into tbl values
(3, 1, [8], {"x": 4, "y": 1}, NAMED_STRUCT("a", 4, "b", "r"));
```
+```text
+テーブルの作成とデータの挿入に成功しました。
+```
+
```sql
select max_by(k1, k2) from tbl;
```
@@ -94,3 +102,26 @@ select max_by(k1, k2) from tbl where k1 is null;
| NULL |
+----------------+
```
+
+以下の配列比較例は、Doris 4.1 系列の 4.1.5 以降、および Doris 4.2 以降に適用されます。
+
+```sql
+SELECT max_by(label, sort_key) AS result
+FROM (
+ SELECT 'null element' AS label, [1, NULL] AS sort_key
+ UNION ALL SELECT 'non-null element', [1, 2]
+ UNION ALL SELECT 'null array', CAST(NULL AS ARRAY<INT>)
+) t;
+```
+
+```text
+null element
+```
+
+```sql
+SELECT max_by(1, CAST(NULL AS ARRAY<INT>)) AS result;
+```
+
+```text
+NULL
+```
diff --git
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max.md
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max.md
index bedd93f7fd5e..73c22f259161 100644
---
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max.md
+++
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max.md
@@ -2,33 +2,41 @@
{
"title": "MAX",
"language": "ja",
- "description": "MAX 関数は、式の NULL 以外の値のうち最大の値を返します。"
+ "description": "MAX 関数は、式の NULL ではない値の最大値を返します。"
}
---
-## 説明
+## 説明 {#description}
-MAX 関数は、式の NULL 以外の値のうち最大の値を返します。
+MAX 関数は、式の NULL ではない値の最大値を返します。
-## 構文
+バージョンによる違い: Doris 4.1 系列の 4.1.5 以降、および Doris 4.2 以降では、配列内の `NULL` 要素は `NULL`
ではない要素より大きい値として比較されます。Doris 4.0 および 4.1.5 より前の Doris 4.1 では、`NULL`
配列要素は小さい値として比較されます。配列値全体が `NULL` の入力は、これらすべてのバージョンで無視されます。
+
+## 構文 {#syntax}
```sql
MAX(<expr>)
```
-## パラメータ
+## パラメータ {#parameters}
| パラメータ | 説明 |
-| -- | -- |
-| `<expr>` | 最大値を求める式。サポートされる型は String, Time, Date, DateTime, Timestamptz,
IPv4, IPv6, TinyInt, SmallInt, Integer, BigInt, LargeInt, Float, Double,
Decimal, Array です。 |
+| --- | --- |
+| `<expr>` | 値を取得する式。サポートされる型は
String、Time、Date、DateTime、Timestamptz、IPv4、IPv6、TinyInt、SmallInt、Integer、BigInt、LargeInt、Float、Double、Decimal、Array
です。 |
+
+## 戻り値 {#return-value}
+
+入力式と同じデータ型を返します。
+グループ内のすべてのレコードが NULL の場合、関数は NULL を返します。
-## 戻り値
-入力式と同じデータ型の値を返します。
-グループ内のすべてのレコードで式の値が NULL の場合は、NULL を返します。
+:::caution 動作変更（4.1.5）
+Doris 4.1 系列では 4.1.5 以降、配列などの複合値内の NULL 要素は、同じ位置にある NULL
ではない要素より大きい値として比較されます。たとえば、`[10, 20, NULL]` は `[10, 20, 40]` より大きくなります。これは式全体が
NULL である場合とは異なります。該当する行は引き続き無視されます。4.1.5 より前は、集計比較で複合値内の NULL
要素は小さい値として扱われていました。
-## 例
+:::
+
+## 例 {#example}
```sql
-- setup
@@ -39,7 +47,7 @@ create table t1(
k_array array<int>
) distributed by hash (k1) buckets 1
properties ("replication_num"="1");
-insert into t1 values
+insert into t1 values
(1, 'apple', 10.01, [10, 20, 30]),
(1, 'banana', 20.02, [10, 20]),
(2, 'orange', 30.03, [10, 20, 40]),
@@ -47,11 +55,15 @@ insert into t1 values
(3, null, null, null);
```
+```text
+Table created and data inserted successfully.
+```
+
```sql
-select k1, max(k_string) from t1 group by k1;
+select k1, max(k_string) from t1 group by k1 order by k1;
```
-String 型の場合: 各グループの文字列の最大値を返します。
+String 型の場合: グループごとに最大の文字列値を返します。
```text
+------+---------------+
@@ -64,10 +76,10 @@ String 型の場合: 各グループの文字列の最大値を返します。
```
```sql
-select k1, max(k_decimal) from t1 group by k1;
+select k1, max(k_decimal) from t1 group by k1 order by k1;
```
-Decimal 型の場合: 高精度の小数値の最大値を返します。
+Decimal 型の場合: 最大の高精度小数値を返します。
```text
+------+----------------+
@@ -80,26 +92,26 @@ Decimal 型の場合: 高精度の小数値の最大値を返します。
```
```sql
-select k1, max(k_array) from t1 group by k1;
+select k1, max(k_array) from t1 group by k1 order by k1;
```
-Array 型の場合: 各グループの配列の最大値を返します（要素を順に比較し、null を最小の要素として扱います）。
+Array 型の場合: 要素を順番に比較し、各グループの最大の配列値を返します。同じ位置では、NULL 要素は NULL
ではない要素より大きい値として比較されます。
```text
-+------+--------------+
-| k1 | max(k_array) |
-+------+--------------+
-| 1 | [10, 20, 30] |
-| 2 | [10, 20, 40] |
-| 3 | NULL |
-+------+--------------+
++------+----------------+
+| k1 | max(k_array) |
++------+----------------+
+| 1 | [10, 20, 30] |
+| 2 | [10, 20, null] |
+| 3 | NULL |
++------+----------------+
```
```sql
select max(k_string) from t1 where k1 = 3;
```
-グループ内のすべての値が NULL の場合は、NULL を返します。
+グループ内のすべての値が NULL の場合、NULL を返します。
```text
+---------------+
@@ -113,7 +125,7 @@ select max(k_string) from t1 where k1 = 3;
select max(k_string) from t1;
```
-すべてのデータの中から最大値を返します。
+すべてのデータにおける最大値を返します。
```text
+---------------+
diff --git
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min-by.md
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min-by.md
index 0bc56acef07e..1c649f93a47b 100644
---
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min-by.md
+++
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min-by.md
@@ -2,33 +2,37 @@
{
"title": "MIN_BY",
"language": "ja",
- "description": "MIN_BY 関数は、指定した列の最小値に対応する値を返します。"
+ "description": "MINBY 関数は、指定した列の最小値に基づいて対応する値を返します。"
}
---
-## 説明
+## 説明 {#description}
-MIN_BY 関数は、指定した列の最小値に対応する値を返します。
+MIN_BY 関数は、指定した列の最小値に基づいて対応する値を返します。
-## 構文
+`<expr2>` が Array の場合、配列は要素ごとに辞書順で比較され、NULL 要素は NULL 以外の要素より大きい値として扱われます。NULL
の配列値は無視されます。
+
+バージョンの違い：Doris 4.1 系列の 4.1.5 以降、および Doris 4.2 以降では、配列内の `NULL` 要素は `NULL`
以外の要素より大きい値として比較されます。Doris 4.0 および 4.1.5 より前の Doris 4.1 では、配列内の `NULL` 要素は
`NULL` 以外の要素より小さい値として比較されます。配列値が `NULL` の場合は、これらすべてのバージョンで無視されます。
+
+## 構文 {#syntax}
```sql
MIN_BY(<expr1>, <expr2>)
```
-## パラメータ
+## パラメータ {#parameters}
| パラメータ | 説明 |
-| -- | -- |
-| `<expr1>` |
対応する値を指定する式。Bool、TinyInt、SmallInt、Int、BigInt、LargeInt、Float、Double、Decimal、String、Date、Datetime、Array、Map、Struct
型をサポートします。 |
-| `<expr2>` |
最小値を求める式。Bool、TinyInt、SmallInt、Int、BigInt、LargeInt、Float、Double、Decimal、String、Date、Datetime、Array
型をサポートします。 |
+| --- | --- |
+| `<expr1>` | 対応する値の式。サポートされる型: Bool, TinyInt, SmallInt, Int, BigInt,
LargeInt, Float, Double, Decimal, String, Date, Datetime, Array, Map, Struct。 |
+| `<expr2>` | 最小値の式。サポートされる型: Bool, TinyInt, SmallInt, Int, BigInt, LargeInt,
Float, Double, Decimal, String, Date, Datetime, Array。 |
-## 戻り値
+## 戻り値 {#return-value}
-<expr1> と同じデータ型の値を返します。
+戻り値は <expr1> と同じデータ型です。
グループ内に有効なデータがない場合は NULL を返します。
-## 例
+## 例 {#example}
```sql
-- setup
@@ -47,6 +51,10 @@ insert into tbl values
(3, 1, [8], {"x": 4, "y": 1}, NAMED_STRUCT("a", 4, "b", "r"));
```
+```text
+Table created and data inserted successfully.
+```
+
```sql
select min_by(k1, k2) from tbl;
```
@@ -94,3 +102,26 @@ select min_by(k1, k2) from tbl where k1 is null;
| NULL |
+----------------+
```
+
+次の配列比較の例は、Doris 4.1 系列の 4.1.5 以降、および Doris 4.2 以降に適用されます。
+
+```sql
+SELECT min_by(label, sort_key) AS result
+FROM (
+ SELECT 'null element' AS label, [1, NULL] AS sort_key
+ UNION ALL SELECT 'non-null element', [1, 2]
+ UNION ALL SELECT 'null array', CAST(NULL AS ARRAY<INT>)
+) t;
+```
+
+```text
+non-null element
+```
+
+```sql
+SELECT min_by(1, CAST(NULL AS ARRAY<INT>)) AS result;
+```
+
+```text
+NULL
+```
diff --git
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min.md
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min.md
index 49c697db8104..5290ee8c373b 100644
---
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min.md
+++
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min.md
@@ -2,32 +2,40 @@
{
"title": "MIN",
"language": "ja",
- "description": "MIN 関数は、式の NULL 以外の値のうち最小値を返します。"
+ "description": "MIN 関数は、式の NULL ではない値のうち最小の値を返します。"
}
---
-## 説明
+## 説明 {#description}
-MIN 関数は、式の NULL 以外の値のうち最小値を返します。
+MIN 関数は、式の NULL ではない値のうち最小の値を返します。
-## 構文
+バージョンによる違い：Doris 4.1 系列の 4.1.5 以降、および Doris 4.2 以降では、配列内の `NULL` 要素は `NULL`
ではない要素より大きい値として比較されます。Doris 4.0 および 4.1.5 より前の Doris 4.1 では、配列内の `NULL`
要素はより小さい値として比較されます。配列値全体が `NULL` の場合は、これらすべてのバージョンで無視されます。
+
+## 構文 {#syntax}
```sql
MIN(<expr>)
```
-## パラメータ
+## パラメータ {#parameters}
| パラメータ | 説明 |
-| -- | -- |
-| `<expr>` |
最小値を求める式。String、Time、Date、DateTime、Timestamptz、IPv4、IPv6、TinyInt、SmallInt、Integer、BigInt、LargeInt、Float、Double、Decimal、Array
型をサポートします。 |
+| --- | --- |
+| `<expr>` | 値を取得する式。サポートされる型は
String、Time、Date、DateTime、Timestamptz、IPv4、IPv6、TinyInt、SmallInt、Integer、BigInt、LargeInt、Float、Double、Decimal、Array
です。 |
-## 戻り値
+## 戻り値 {#return-value}
入力式と同じデータ型を返します。
-グループ内のすべての行で式の値が NULL の場合は、NULL を返します。
+グループ内のすべてのレコードが NULL の場合、関数は NULL を返します。
+
+:::caution 動作変更（4.1.5）
+
+Doris 4.1 系列の 4.1.5 以降では、配列などの複合値に含まれる NULL 要素は、同じ位置の NULL
ではない要素より大きい値として比較されます。たとえば、`[10, 20, NULL]` は `[10, 20, 40]`
より大きい値として比較されます。これは式全体が NULL である場合とは異なります。そのような行は引き続き無視されます。4.1.5
より前では、集計比較において複合値内部の NULL 要素は小さい値として扱われました。
+
+:::
-## 例
+## 例 {#example}
```sql
-- setup
@@ -38,7 +46,7 @@ create table t1(
k_array array<int>
) distributed by hash (k1) buckets 1
properties ("replication_num"="1");
-insert into t1 values
+insert into t1 values
(1, 'apple', 10.01, [10, 20, 30]),
(1, 'banana', 20.02, [10, 20]),
(2, 'orange', 30.03, [10, 20, 40]),
@@ -46,11 +54,15 @@ insert into t1 values
(3, null, null, null);
```
+```text
+テーブルが作成され、データが正常に挿入されました。
+```
+
```sql
-select k1, min(k_string) from t1 group by k1;
+select k1, min(k_string) from t1 group by k1 order by k1;
```
-文字列型: グループごとに文字列の最小値を返します。
+String 型：各グループについて、最小の文字列値を返します。
```text
+------+---------------+
@@ -63,10 +75,10 @@ select k1, min(k_string) from t1 group by k1;
```
```sql
-select k1, min(k_decimal) from t1 group by k1;
+select k1, min(k_decimal) from t1 group by k1 order by k1;
```
-Decimal 型: 高精度の小数値の最小値を返します。
+Decimal 型：最小の高精度小数値を返します。
```text
+------+----------------+
@@ -79,17 +91,17 @@ Decimal 型: 高精度の小数値の最小値を返します。
```
```sql
-select k1, min(k_array) from t1 group by k1;
+select k1, min(k_array) from t1 group by k1 order by k1;
```
-Array 型: グループごとに最小の配列値を返します (要素を順に比較し、NULL を最小の要素とみなします)。
+Array 型：要素を順番に比較し、各グループの最小の配列値を返します。NULL 要素は、同じ位置の NULL ではない要素より大きい値として比較されます。
```text
+------+----------------+
| k1 | min(k_array) |
+------+----------------+
| 1 | [10, 20] |
-| 2 | [10, 20, null] |
+| 2 | [10, 20, 40] |
| 3 | NULL |
+------+----------------+
```
@@ -98,7 +110,7 @@ Array 型: グループごとに最小の配列値を返します (要素を順
select min(k_string) from t1 where k1 = 3;
```
-グループ内のすべての値が NULL の場合は NULL を返します。
+グループ内のすべての値が NULL の場合、NULL を返します。
```text
+---------------+
@@ -112,7 +124,7 @@ select min(k_string) from t1 where k1 = 3;
select min(k_string) from t1;
```
-すべてのデータの中から最小値を返します。
+すべてのデータの最小値。
```text
+---------------+
diff --git
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-array.md
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-array.md
index 450a6aa4d3b0..a95996058913 100644
---
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-array.md
+++
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-array.md
@@ -2,34 +2,34 @@
{
"title": "TOPN_ARRAY",
"language": "ja",
- "description": "TOPN_ARRAY は、指定した列で出現頻度の高い上位 N 個の値を配列で返します。"
+ "description": "TOPNARRAY は、指定した列で出現頻度が最も高い N 個の値の配列を返します。"
}
---
-## 説明
+## 説明 {#description}
-TOPN_ARRAY は、指定した列で出現頻度の高い上位 N 個の値を配列で返します。近似計算を行い、出現回数の降順で結果を並べます。
+TOPN_ARRAY は、指定した列で出現頻度が最も高い N 個の値の配列を返します。件数の降順で結果を返す近似計算関数です。
-## 構文
+## 構文 {#syntax}
```sql
TOPN_ARRAY(<expr>, <top_num> [, <space_expand_rate>])
```
-## パラメータ
+## パラメータ {#parameters}
| パラメータ | 説明 |
| -- | -- |
-| `<expr>` | 集計対象の列または式。サポートされる型は
TinyInt、SmallInt、Integer、BigInt、LargeInt、Float、Double、Decimal、Date、Datetime、IPV4、IPV6、String
です。 |
-| `<top_num>` | 返す値の数。正の整数である必要があります。サポートされる型は Integer です。 |
-| `<space_expand_rate>` | 省略可能。Space-Saving アルゴリズムで使用するカウンターの数を
`counter_numbers = top_num * space_expand_rate`
で設定します。値が大きいほど結果の精度が高くなります。デフォルト値は 50 です。サポートされる型は Integer です。 |
+| `<expr>` | カウント対象の列または式。サポートされる型: Boolean（Doris 4.1 系列では 4.1.5
以降）、TinyInt、SmallInt、Integer、BigInt、LargeInt、Float、Double、Decimal、Date、Datetime、IPV4、IPV6、String。
|
+| `<top_num>` | 返す出現頻度が最も高い値の数。正の INT 定数である必要があります。 |
+| `<space_expand_rate>` | オプションの INT 定数で、デフォルト値は 50
です。正の値を指定すると、中間状態のシリアライズ時に最大 `top_num * space_expand_rate`
個の候補を保持します。値が大きいほど、通常は精度が向上します。これはローカル集約メモリのハード上限ではありません。Doris 4.1 系列では 4.1.5
以降、0 以下の値を指定するとすべての中間候補を保持しますが、最終結果に含まれる値は `top_num`
個以下です。このモードではより多くのメモリを使用する可能性があり、クエリのメモリ制限が適用されます。 |
-## 戻り値
+## 戻り値 {#return-value}
-出現頻度の高い上位 N 個の値を含む配列を返します。
-グループに有効なデータがない場合は NULL を返します。
+出現頻度が最も高い N 個の値を含む配列を返します。
+グループ内に有効なデータがない場合は NULL を返します。
-## 例
+## 例 {#example}
```sql
-- setup
CREATE TABLE page_visits (
@@ -56,7 +56,7 @@ SELECT TOPN_ARRAY(page_id, 3) as top_pages
FROM page_visits;
```
-アクセス数が多いページの上位 3 件を求めます。
+訪問数が最も多い上位 3 ページを検索します。
```text
+-----------+
@@ -77,3 +77,13 @@ SELECT TOPN_ARRAY(page_id, 3) as top_pages FROM page_visits
where page_id is nul
| NULL |
+-----------+
```
+
+BOOLEAN 入力（Doris 4.1 系列では 4.1.5 以降）:
+
+```sql
+SELECT TOPN_ARRAY(TRUE, 2), TOPN_ARRAY(CAST(NULL AS BOOLEAN), 2);
+```
+
+```text
+[1] NULL
+```
diff --git
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-weighted.md
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-weighted.md
index d99258e2a681..f618209e117f 100644
---
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-weighted.md
+++
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-weighted.md
@@ -2,35 +2,35 @@
{
"title": "TOPN_WEIGHTED",
"language": "ja",
- "description": "TOPNWEIGHTED 関数は、指定した列で重み付きの出現回数が多い上位 N 個の値を返します。通常の TOPN
関数とは異なり、"
+ "description": "TOPNWEIGHTED 関数は、重み付きカウントを使用して、指定した列で最も頻繁に出現する N
個の値を返します。通常の TOPN 関数とは異なり、"
}
---
-## 説明
+## 説明 {#description}
-TOPN_WEIGHTED 関数は、指定した列で重み付きの出現回数が多い上位 N 個の値を返します。通常の TOPN
関数とは異なり、重みによって値の重要度を調整できます。
+TOPN_WEIGHTED 関数は、重み付きカウントを使用して、指定した列で最も頻繁に出現する N 個の値を返します。通常の TOPN
関数とは異なり、TOPN_WEIGHTED では重みを使用して値の重要度を調整できます。
-## 構文
+## 構文 {#syntax}
```sql
TOPN_WEIGHTED(<expr>, <weight>, <top_num> [, <space_expand_rate>])
```
-## パラメータ
+## パラメーター {#parameters}
-| パラメータ | 説明 |
+| パラメーター | 説明 |
| -- | -- |
-| `<expr>` | 集計対象の列または式。対応する型:
TinyInt、SmallInt、Integer、BigInt、LargeInt、Float、Double、Decimal、Date、Datetime、IPV4、IPV6、String。
|
-| `<weight>` | 重みの調整に使用する列または式。対応する型: Double。|
-| `<top_num>` | 返す値の個数。正の整数を指定する必要があります。対応する型: Integer。 |
-| `<space_expand_rate>` | 省略可能。Space-Saving アルゴリズムで使用するカウンターの数を
`counter_numbers = top_num * space_expand_rate`
として設定します。値が大きいほど結果の精度が高くなります。デフォルトは 50 です。対応する型: Integer。 |
+| `<expr>` | カウント対象の列または式。サポートされる型: Boolean（Doris 4.1 系列では 4.1.5
以降）、TinyInt、SmallInt、Integer、BigInt、LargeInt、Float、Double、Decimal、Date、Datetime、IPV4、IPV6、String。
|
+| `<weight>` | 重みの調整に使用する列または式。型: BIGINT。|
+| `<top_num>` | 出現頻度が最も高い値を返す数。正の INT 定数である必要があります。 |
+| `<space_expand_rate>` | オプションの INT 定数。デフォルトは 50 です。正の値を指定すると、中間状態のシリアル化時に最大
`top_num * space_expand_rate`
個の候補を保持し、値を大きくすると通常は精度が向上します。これはローカル集約メモリの厳密な上限ではありません。Doris 4.1 系列では 4.1.5
以降、0 以下の値を指定するとすべての中間候補を保持しますが、最終結果に含まれる値は最大で `top_num`
個です。このモードではメモリ使用量が増える可能性があり、クエリのメモリ制限が引き続き適用されます。 |
-## 戻り値
+## 戻り値 {#return-value}
-重み付きの出現回数が多い上位 N 個の値を含む配列を返します。
+重み付きカウントが最も高い N 個の値を含む配列を返します。
グループ内に有効なデータがない場合は NULL を返します。
-## 例
+## 例 {#example}
```sql
-- setup
CREATE TABLE product_sales (
@@ -57,7 +57,7 @@ SELECT TOPN_WEIGHTED(product_id, sale_amount, 3) as
top_products
FROM product_sales;
```
-売上金額を重みとして、上位 3 件の商品を取得します。
+売上金額で重み付けした上位 3 つの製品を検索します。
```text
+--------------+
@@ -72,7 +72,7 @@ SELECT TOPN_WEIGHTED(product_id, sale_amount, 3) as
top_products
FROM product_sales where product_id is null;
```
-売上金額を重みとして、上位 3 件の商品を取得します。
+売上金額で重み付けした上位 3 つの製品を検索します。
```text
+--------------+
@@ -81,3 +81,13 @@ FROM product_sales where product_id is null;
| NULL |
+--------------+
```
+
+BOOLEAN 入力（Doris 4.1 系列では 4.1.5 以降）:
+
+```sql
+SELECT TOPN_WEIGHTED(TRUE, 1, 2), TOPN_WEIGHTED(CAST(NULL AS BOOLEAN), 1, 2);
+```
+
+```text
+[1] NULL
+```
diff --git
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn.md
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn.md
index 286e5a256546..267314153aee 100644
---
a/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn.md
+++
b/i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn.md
@@ -2,33 +2,33 @@
{
"title": "TOPN",
"language": "ja",
- "description": "TOPN 関数は、指定した列で出現頻度の高い上位 N 個の値を返します。"
+ "description": "TOPN 関数は、指定された列で出現頻度が最も高い N 個の値を返します。"
}
---
-## 説明
+## 説明 {#description}
-TOPN 関数は、指定した列で出現頻度の高い上位 N 個の値を返します。これは近似計算関数であり、出現回数の降順に並べた結果を返します。
+TOPN 関数は、指定された列で出現頻度が最も高い N 個の値を返します。これは近似計算関数であり、結果はカウント数の降順で返されます。
-## 構文
+## 構文 {#syntax}
```sql
TOPN(<expr>, <top_num> [, <space_expand_rate>])
```
-## パラメータ
+## パラメータ {#parameters}
| パラメータ | 説明 |
| -- | -- |
-| `<expr>` | 出現回数を数える対象の列または式。対応する型:
TinyInt、SmallInt、Integer、BigInt、LargeInt、Float、Double、Decimal、Date、Datetime、IPV4、IPV6、String。
|
-| `<top_num>` | 返す値の個数。正の整数を指定する必要があります。対応する型: Integer。 |
-| `<space_expand_rate>` | 省略可能。Space-Saving アルゴリズムで使用するカウンターの数を
`counter_numbers = top_num * space_expand_rate`
として設定します。値が大きいほど結果の精度が高くなります。デフォルトは 50 です。対応する型: Integer。 |
+| `<expr>` |
集計対象の列または式。サポートされる型：TinyInt、SmallInt、Integer、BigInt、LargeInt、Float、Double、Decimal、Date、Datetime、IPV4、IPV6、String。
|
+| `<top_num>` | 返す出現頻度上位の値の数。正の INT 定数である必要があります。 |
+| `<space_expand_rate>` | オプションの INT 定数。デフォルトは 50
です。正の値を指定すると、中間状態をシリアル化する際に最大で `top_num * space_expand_rate`
個の候補を保持します。値を大きくすると、通常は精度が向上します。これはローカル集約メモリのハード上限ではありません。Doris 4.1 系列では 4.1.5
以降、値を 0 以下にすると、すべての中間候補を保持しますが、最終結果に含まれる値は最大で `top_num`
個です。このモードではより多くのメモリを使用する可能性があり、クエリのメモリ制限も受けます。 |
-## 戻り値
+## 戻り値 {#return-value}
-値とその出現回数を含む JSON 文字列を返します。
+値とそのカウントを含む JSON 文字列を返します。
グループ内に有効なデータがない場合は NULL を返します。
-## 例
+## 例 {#example}
```sql
-- setup
CREATE TABLE page_visits (
@@ -55,7 +55,7 @@ SELECT TOPN(page_id, 3) as top_pages
FROM page_visits;
```
-アクセス回数の多いページを上位 3 件取得します。
+アクセス数が最も多い上位 3 ページを検索します。
```text
+---------------------+
@@ -77,3 +77,14 @@ FROM page_visits where page_id is null;
| NULL |
+-----------+
```
+
+中間候補をすべて保持し、最頻値のみを返します：
+
+```sql
+SELECT TOPN(s, 1, 0)
+FROM (SELECT 'a' AS s UNION ALL SELECT 'b' UNION ALL SELECT 'a') t;
+```
+
+```text
+{"a":2}
+```
diff --git
a/translations/state/ja/pages/default/4.x/sql-manual/basic-element/sql-data-types/string-type/STRING.json
b/translations/state/ja/pages/default/4.x/sql-manual/basic-element/sql-data-types/string-type/STRING.json
index 5ca2428ac294..b6d2cfa4896b 100644
---
a/translations/state/ja/pages/default/4.x/sql-manual/basic-element/sql-data-types/string-type/STRING.json
+++
b/translations/state/ja/pages/default/4.x/sql-manual/basic-element/sql-data-types/string-type/STRING.json
@@ -8,13 +8,39 @@
"sourceLocale": "en",
"sourcePath":
"versioned_docs/version-4.x/sql-manual/basic-element/sql-data-types/string-type/STRING.md",
"targetPath":
"i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/basic-element/sql-data-types/string-type/STRING.md",
- "sourceCommit": "81077becd6a77efa3e237ed9159bf413f36c9902",
- "sourceHash":
"9169b4533c57ecae822213ddb5190860ab2f49270db7bed387d70bd254f06867",
- "sourceTechnicalHash":
"f041f1ef76a703797cbeccd3d72435cf897d1e1df5b05abc945a7a6b0826a119",
- "targetHash":
"505fb0116f86042c8c092ef8104b4e39192b5fa926e73d135db0b9e879791964",
+ "sourceCommit": "618ed23852c4c67b16296910731076bb11594a09",
+ "sourceHash":
"ae7d4809e87949be838c96574600ca5fb487bdced3e3de807ffd5137445118e9",
+ "sourceTechnicalHash":
"2501e9e2c9b8de79737059e570d6db5cda7fa0768e53e93abd725fe91c266c53",
+ "targetHash":
"eb24c39d5e70c522e07ce62d77f2ee054c5098830ce991e5f98d2204bc98920f",
"reviewStatus": "machine",
"ownership": "machine",
- "translatedAt": "2026-10-15T05:07:27.668Z",
- "glossaryVersion": "0"
+ "translatedAt": "2026-10-31T16:59:21.858Z",
+ "glossaryVersion": "1",
+ "generation": {
+ "policy": "whole-document-v1",
+ "mode": "full",
+ "reason": "chinese-reference-changed",
+ "attempts": 1,
+ "acceptedWithWarnings": false,
+ "sourceHash":
"ae7d4809e87949be838c96574600ca5fb487bdced3e3de807ffd5137445118e9",
+ "targetHash":
"eb24c39d5e70c522e07ce62d77f2ee054c5098830ce991e5f98d2204bc98920f",
+ "warnings": [],
+ "history": [
+ {
+ "attempt": 1,
+ "issues": []
+ }
+ ]
+ },
+ "sourceRevisions": {
+ "en": {
+ "path":
"versioned_docs/version-4.x/sql-manual/basic-element/sql-data-types/string-type/STRING.md",
+ "blob": "5e6e0398b2fad276e5809143c34e79ca3a425635"
+ },
+ "zh-CN": {
+ "path":
"i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/basic-element/sql-data-types/string-type/STRING.md",
+ "blob": "680274179711ab8e367e5d77fad7b56f4706d448"
+ }
+ }
}
}
diff --git
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/ai-agg.json
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/ai-agg.json
index c7f8906589d1..0fc0c57c2bad 100644
---
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/ai-agg.json
+++
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/ai-agg.json
@@ -8,13 +8,48 @@
"sourceLocale": "en",
"sourcePath":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/ai-agg.md",
"targetPath":
"i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/ai-agg.md",
- "sourceCommit": "16f5b30d55a55ef6fbd9ced7b028236140037ac8",
- "sourceHash":
"f02c0c3cc608cc4a6bff781a4e365dd45e89fd5f2f25390496cc9686cda3253b",
- "sourceTechnicalHash":
"c0577ab6b324d36aae0633b2f937a6d875c4707bba3c389f26ee6e4cf79ce3c0",
- "targetHash":
"36aabf1b9f2c6873d6eb620d09ed362e838f6788bea7e0f39f29bb511124c418",
+ "sourceCommit": "618ed23852c4c67b16296910731076bb11594a09",
+ "sourceHash":
"88c0b72b8baf173a34d2d742bebd69bd5f417c6e53872ff099cac46a2d551d9b",
+ "sourceTechnicalHash":
"fe0ecc5d81114d8848c2a2c21b79c1c0cc4c8c6eb45f32dc8c3b9fe8997a32d1",
+ "targetHash":
"121f07de04eb6b3961a3f072761a84dac6e166f2ebc0b1d87d87303ece4b99d8",
"reviewStatus": "machine",
"ownership": "machine",
- "translatedAt": "2026-10-13T19:30:24.920Z",
- "glossaryVersion": "0"
+ "translatedAt": "2026-10-31T17:02:46.047Z",
+ "glossaryVersion": "1",
+ "generation": {
+ "policy": "whole-document-v1",
+ "mode": "full",
+ "reason": "chinese-reference-changed",
+ "attempts": 2,
+ "acceptedWithWarnings": false,
+ "sourceHash":
"88c0b72b8baf173a34d2d742bebd69bd5f417c6e53872ff099cac46a2d551d9b",
+ "targetHash":
"121f07de04eb6b3961a3f072761a84dac6e166f2ebc0b1d87d87303ece4b99d8",
+ "warnings": [],
+ "history": [
+ {
+ "attempt": 1,
+ "issues": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nnumeric values:
expected [\"128\",\"2\",\"4.1.5\"]; received
[\"1\",\"1\",\"128\",\"2\",\"4.1.5\"]\nprotected node 14: expected
[\"code\",\"sql\",null,\"SET default_ai_resource =
'ai_resource_name';\\nSELECT\\n product_id,\\n AI_AGG(\\n
comment,\\n '请把多条用户评价总结成一句话，突出买家最关心的优点和缺点，控制在50字以内。'\\n ) AS
评价摘要\\nFROM product_reviews\\nGROUP BY product_id;\"]; received
[\"inlineCode\",null,null,\"AI_AGG\"]\nprotect [...]
+ }
+ ]
+ },
+ {
+ "attempt": 2,
+ "issues": []
+ }
+ ]
+ },
+ "sourceRevisions": {
+ "en": {
+ "path":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/ai-agg.md",
+ "blob": "f63df252c41ad6788f72fb0dc749dc1f484b759d"
+ },
+ "zh-CN": {
+ "path":
"i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/ai-agg.md",
+ "blob": "004ea28a76923308db7d72c27f49daf601d0abee"
+ }
+ }
}
}
diff --git
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/linear-histogram.json
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/linear-histogram.json
index 8a5f6b592742..74367ed3af7c 100644
---
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/linear-histogram.json
+++
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/linear-histogram.json
@@ -8,13 +8,39 @@
"sourceLocale": "en",
"sourcePath":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/linear-histogram.md",
"targetPath":
"i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/linear-histogram.md",
- "sourceCommit": "f9184fac0bbfb81ef27a7f834ad53f1764cc8929",
- "sourceHash":
"64f17409c81bd9b0ba3606d0aab4f6cd1947afd2682b449b424d99746ec33689",
- "sourceTechnicalHash":
"28821fc72395fcc3853a834b0af22a541dbe3ce1da278d07a743faea9a9a74c2",
- "targetHash":
"88cf1f32d88841aa30f5a8f520de94191b411d4ada7d7b8ced0dcef980e23c0f",
+ "sourceCommit": "618ed23852c4c67b16296910731076bb11594a09",
+ "sourceHash":
"273fd40d6143161e22ef13f9d4e4566eb52536db24db827d09a47253272cebb8",
+ "sourceTechnicalHash":
"db5593b97326ab77a7dd094f6f2da8c3bc5d1fb86560689497be540cf203dc4a",
+ "targetHash":
"715afb6c0b8396f022f69c096d6cd7939a4aefb6b3b907a8ff864f095a37df31",
"reviewStatus": "machine",
"ownership": "machine",
- "translatedAt": "2026-10-14T05:12:57.465Z",
- "glossaryVersion": "0"
+ "translatedAt": "2026-10-31T17:04:44.426Z",
+ "glossaryVersion": "1",
+ "generation": {
+ "policy": "whole-document-v1",
+ "mode": "full",
+ "reason": "chinese-reference-changed",
+ "attempts": 1,
+ "acceptedWithWarnings": false,
+ "sourceHash":
"273fd40d6143161e22ef13f9d4e4566eb52536db24db827d09a47253272cebb8",
+ "targetHash":
"715afb6c0b8396f022f69c096d6cd7939a4aefb6b3b907a8ff864f095a37df31",
+ "warnings": [],
+ "history": [
+ {
+ "attempt": 1,
+ "issues": []
+ }
+ ]
+ },
+ "sourceRevisions": {
+ "en": {
+ "path":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/linear-histogram.md",
+ "blob": "b97fb0de88d3e52fc8f7e7e76d6a9718272fdba2"
+ },
+ "zh-CN": {
+ "path":
"i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/linear-histogram.md",
+ "blob": "80304e0d0840b76aeef032f0e82cd5b4505fe791"
+ }
+ }
}
}
diff --git
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/max-by.json
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/max-by.json
index 13c95e1261cd..fde609d8bbb2 100644
---
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/max-by.json
+++
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/max-by.json
@@ -8,13 +8,67 @@
"sourceLocale": "en",
"sourcePath":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max-by.md",
"targetPath":
"i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max-by.md",
- "sourceCommit": "f9184fac0bbfb81ef27a7f834ad53f1764cc8929",
- "sourceHash":
"c6f6527a6dc7431aeffce1dfcb4e8fd5298789427b44d30310ae99faf37a2302",
- "sourceTechnicalHash":
"7cc91e22ecea156da06e669ae07b8df0350d8d343884f915665c5608ec3c66db",
- "targetHash":
"cdecfee7dc786e919541369ff1718de611a5fce87eb74b048875881e22e59540",
+ "sourceCommit": "618ed23852c4c67b16296910731076bb11594a09",
+ "sourceHash":
"2eca5f83a98ff714e00678270d823f8061b82d20de006dc07f37ea3f34c06f6e",
+ "sourceTechnicalHash":
"d7ff6ca9e34fdd6d2c7b341655503d1dda621606b248858b09473b70e0221c36",
+ "targetHash":
"bc82da6e4ceac7c725b87c3faa6635b9890e3595377363e9bf68db1ddd0861bd",
"reviewStatus": "machine",
"ownership": "machine",
- "translatedAt": "2026-10-14T05:12:57.465Z",
- "glossaryVersion": "0"
+ "translatedAt": "2026-10-31T17:09:00.245Z",
+ "glossaryVersion": "1",
+ "generation": {
+ "policy": "whole-document-v1",
+ "mode": "full",
+ "reason": "chinese-reference-changed",
+ "attempts": 3,
+ "acceptedWithWarnings": true,
+ "sourceHash":
"2eca5f83a98ff714e00678270d823f8061b82d20de006dc07f37ea3f34c06f6e",
+ "targetHash":
"bc82da6e4ceac7c725b87c3faa6635b9890e3595377363e9bf68db1ddd0861bd",
+ "warnings": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node 11:
expected [\"code\",\"text\",null,\"Table created and data inserted
successfully.\"]; received [\"code\",\"text\",null,\"テーブルの作成とデータの挿入に成功しました。\"]"
+ }
+ ],
+ "history": [
+ {
+ "attempt": 1,
+ "issues": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node 5:
expected [\"inlineCode\",null,null,\"NULL\"]; received
[\"code\",\"sql\",null,\"MAX_BY(<expr1>, <expr2>)\"]\nprotected node 6:
expected [\"code\",\"sql\",null,\"MAX_BY(<expr1>, <expr2>)\"]; received
[\"inlineCode\",null,null,\"<expr1>\"]\nprotected node 7: expected
[\"inlineCode\",null,null,\"<expr1>\"]; received
[\"inlineCode\",null,null,\"<expr2>\"]"
+ }
+ ]
+ },
+ {
+ "attempt": 2,
+ "issues": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node 6:
expected [\"code\",\"sql\",null,\"MAX_BY(<expr1>, <expr2>)\"]; received
[\"inlineCode\",null,null,\"NULL\"]\nprotected node 7: expected
[\"inlineCode\",null,null,\"<expr1>\"]; received
[\"code\",\"sql\",null,\"MAX_BY(<expr1>, <expr2>)\"]\nprotected node 8:
expected [\"inlineCode\",null,null,\"<expr2>\"]; received
[\"inlineCode\",null,null,\"<expr1>\"]"
+ }
+ ]
+ },
+ {
+ "attempt": 3,
+ "issues": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node
11: expected [\"code\",\"text\",null,\"Table created and data inserted
successfully.\"]; received [\"code\",\"text\",null,\"テーブルの作成とデータの挿入に成功しました。\"]"
+ }
+ ]
+ }
+ ]
+ },
+ "sourceRevisions": {
+ "en": {
+ "path":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max-by.md",
+ "blob": "5bd095384f45d5937926aa54a16189199083650f"
+ },
+ "zh-CN": {
+ "path":
"i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max-by.md",
+ "blob": "9bc097d39befac02e8dbe07926c605b4d8a77c9b"
+ }
+ }
}
}
diff --git
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/max.json
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/max.json
index 1845c91e903f..e6499fd293de 100644
---
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/max.json
+++
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/max.json
@@ -8,13 +8,67 @@
"sourceLocale": "en",
"sourcePath":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max.md",
"targetPath":
"i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max.md",
- "sourceCommit": "f9184fac0bbfb81ef27a7f834ad53f1764cc8929",
- "sourceHash":
"a516191fc093af9b05a62b060b62aac1291daa1601ee070952c37d87610ba1c2",
- "sourceTechnicalHash":
"272e0ba6e2788aec7c7979d4384de0158c65c2c3a0ba9ceb97e8fd3bf003403a",
- "targetHash":
"c3c95cc28269eded635c765e1efe81ffd0a1b3bfa4cbeb131df6e9db33d02dbc",
+ "sourceCommit": "618ed23852c4c67b16296910731076bb11594a09",
+ "sourceHash":
"56248684c4dfe7dfede52aae8e4521ddafdc06f7ef0eb39a60c688224fec629d",
+ "sourceTechnicalHash":
"583d7830e9f7e51ed1b6b61ea6f01dccabb64c2255409dcd92ec182a5099e7e8",
+ "targetHash":
"fdf209f69ae7b7533ed4aa4cbe51a7edcad2f0820f1a016782fc543031028d62",
"reviewStatus": "machine",
"ownership": "machine",
- "translatedAt": "2026-10-14T05:12:57.465Z",
- "glossaryVersion": "0"
+ "translatedAt": "2026-10-31T17:12:03.387Z",
+ "glossaryVersion": "1",
+ "generation": {
+ "policy": "whole-document-v1",
+ "mode": "full",
+ "reason": "chinese-reference-changed",
+ "attempts": 3,
+ "acceptedWithWarnings": true,
+ "sourceHash":
"56248684c4dfe7dfede52aae8e4521ddafdc06f7ef0eb39a60c688224fec629d",
+ "targetHash":
"fdf209f69ae7b7533ed4aa4cbe51a7edcad2f0820f1a016782fc543031028d62",
+ "warnings": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node 9:
expected [\"code\",\"sql\",null,\"-- setup\\ncreate table t1(\\n k1
int,\\n k_string varchar(100),\\n k_decimal decimal(10, 2),\\n
k_array array<int>\\n) distributed by hash (k1) buckets 1\\nproperties
(\\\"replication_num\\\"=\\\"1\\\");\\ninsert into t1 values \\n (1,
'apple', 10.01, [10, 20, 30]),\\n (1, 'banana', 20.02, [10, 20]),\\n (2,
'orange', 30.03, [10, 20, 40]),\\n [...]
+ }
+ ],
+ "history": [
+ {
+ "attempt": 1,
+ "issues": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node 5:
expected [\"code\",\"sql\",null,\"MAX(<expr>)\"]; received
[\"inlineCode\",null,null,\"NULL\"]\nprotected node 6: expected
[\"inlineCode\",null,null,\"<expr>\"]; received
[\"code\",\"sql\",null,\"MAX(<expr>)\"]\nprotected node 7: expected
[\"inlineCode\",null,null,\"[10, 20, NULL]\"]; received
[\"inlineCode\",null,null,\"<expr>\"]"
+ }
+ ]
+ },
+ {
+ "attempt": 2,
+ "issues": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node 9:
expected [\"code\",\"sql\",null,\"-- setup\\ncreate table t1(\\n k1
int,\\n k_string varchar(100),\\n k_decimal decimal(10, 2),\\n
k_array array<int>\\n) distributed by hash (k1) buckets 1\\nproperties
(\\\"replication_num\\\"=\\\"1\\\");\\ninsert into t1 values \\n (1,
'apple', 10.01, [10, 20, 30]),\\n (1, 'banana', 20.02, [10, 20]),\\n (2,
'orange', 30.03, [10, 20, 40]),\ [...]
+ }
+ ]
+ },
+ {
+ "attempt": 3,
+ "issues": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node 9:
expected [\"code\",\"sql\",null,\"-- setup\\ncreate table t1(\\n k1
int,\\n k_string varchar(100),\\n k_decimal decimal(10, 2),\\n
k_array array<int>\\n) distributed by hash (k1) buckets 1\\nproperties
(\\\"replication_num\\\"=\\\"1\\\");\\ninsert into t1 values \\n (1,
'apple', 10.01, [10, 20, 30]),\\n (1, 'banana', 20.02, [10, 20]),\\n (2,
'orange', 30.03, [10, 20, 40]),\ [...]
+ }
+ ]
+ }
+ ]
+ },
+ "sourceRevisions": {
+ "en": {
+ "path":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max.md",
+ "blob": "c3273a10d515ecfb3bacdfd18be177160c2f0291"
+ },
+ "zh-CN": {
+ "path":
"i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/max.md",
+ "blob": "d812025fae279fc3ad06866539e4d69f26ade8d5"
+ }
+ }
}
}
diff --git
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/min-by.json
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/min-by.json
index 2b1bf4cc2a68..5687dee1f8b6 100644
---
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/min-by.json
+++
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/min-by.json
@@ -8,13 +8,67 @@
"sourceLocale": "en",
"sourcePath":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min-by.md",
"targetPath":
"i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min-by.md",
- "sourceCommit": "f9184fac0bbfb81ef27a7f834ad53f1764cc8929",
- "sourceHash":
"d38ac023c2d1d64b6c8ec36f972bd8992481703655d550d962b211b1dd2beaa2",
- "sourceTechnicalHash":
"1bdbbf385ea0c9a1dbb46190bcf1d3168e673f18d9d80786d925572236cb1474",
- "targetHash":
"2042d384890e45fe4ebd72d5fdb186430dfeb69703c51b9dca63b029f7ddd91b",
+ "sourceCommit": "618ed23852c4c67b16296910731076bb11594a09",
+ "sourceHash":
"d7986eec336f27c7ca3e1bee54973c2a88ed14089664097b1246fe53ea5d6d5f",
+ "sourceTechnicalHash":
"51cc0598c074689cfdec252363c8984e9e366b2a98c97f624cbb0c770a13aa2f",
+ "targetHash":
"0537b2ba67b3de04907599988571831f3949ed1b3a4f2c967268afe0954b3c2b",
"reviewStatus": "machine",
"ownership": "machine",
- "translatedAt": "2026-10-14T05:12:57.465Z",
- "glossaryVersion": "0"
+ "translatedAt": "2026-10-31T17:16:11.347Z",
+ "glossaryVersion": "1",
+ "generation": {
+ "policy": "whole-document-v1",
+ "mode": "full",
+ "reason": "chinese-reference-changed",
+ "attempts": 3,
+ "acceptedWithWarnings": true,
+ "sourceHash":
"d7986eec336f27c7ca3e1bee54973c2a88ed14089664097b1246fe53ea5d6d5f",
+ "targetHash":
"0537b2ba67b3de04907599988571831f3949ed1b3a4f2c967268afe0954b3c2b",
+ "warnings": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node 6:
expected [\"code\",\"sql\",null,\"MIN_BY(<expr1>, <expr2>)\"]; received
[\"inlineCode\",null,null,\"NULL\"]\nprotected node 7: expected
[\"inlineCode\",null,null,\"<expr1>\"]; received
[\"code\",\"sql\",null,\"MIN_BY(<expr1>, <expr2>)\"]\nprotected node 8:
expected [\"inlineCode\",null,null,\"<expr2>\"]; received
[\"inlineCode\",null,null,\"<expr1>\"]"
+ }
+ ],
+ "history": [
+ {
+ "attempt": 1,
+ "issues": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node 6:
expected [\"code\",\"sql\",null,\"MIN_BY(<expr1>, <expr2>)\"]; received
[\"inlineCode\",null,null,\"NULL\"]\nprotected node 7: expected
[\"inlineCode\",null,null,\"<expr1>\"]; received
[\"code\",\"sql\",null,\"MIN_BY(<expr1>, <expr2>)\"]\nprotected node 8:
expected [\"inlineCode\",null,null,\"<expr2>\"]; received
[\"inlineCode\",null,null,\"<expr1>\"]"
+ }
+ ]
+ },
+ {
+ "attempt": 2,
+ "issues": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node
11: expected [\"code\",\"text\",null,\"Table created and data inserted
successfully.\"]; received [\"code\",\"text\",null,\"テーブルの作成とデータの挿入に成功しました。\"]"
+ }
+ ]
+ },
+ {
+ "attempt": 3,
+ "issues": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node 6:
expected [\"code\",\"sql\",null,\"MIN_BY(<expr1>, <expr2>)\"]; received
[\"inlineCode\",null,null,\"NULL\"]\nprotected node 7: expected
[\"inlineCode\",null,null,\"<expr1>\"]; received
[\"code\",\"sql\",null,\"MIN_BY(<expr1>, <expr2>)\"]\nprotected node 8:
expected [\"inlineCode\",null,null,\"<expr2>\"]; received
[\"inlineCode\",null,null,\"<expr1>\"]"
+ }
+ ]
+ }
+ ]
+ },
+ "sourceRevisions": {
+ "en": {
+ "path":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min-by.md",
+ "blob": "cce5d69bfddd0ca31c9a6fc1264e4359a832e9bb"
+ },
+ "zh-CN": {
+ "path":
"i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min-by.md",
+ "blob": "2dbbaa5ee1c61bcb23a1fbd885ac134d7577b264"
+ }
+ }
}
}
diff --git
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/min.json
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/min.json
index f68811eb6198..104d8cebae05 100644
---
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/min.json
+++
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/min.json
@@ -8,13 +8,67 @@
"sourceLocale": "en",
"sourcePath":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min.md",
"targetPath":
"i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min.md",
- "sourceCommit": "f9184fac0bbfb81ef27a7f834ad53f1764cc8929",
- "sourceHash":
"ea9314225e5aac71833957e9d7f0bdef77a80c02644904c407a82f816304a113",
- "sourceTechnicalHash":
"64a572978d4ce39ba0e657632feaf0b4f9a2086765ff89f0b23b1aab2a254912",
- "targetHash":
"d70c2d919a1a39dfd1fb40dc93537029570d7f3805182d5c1a76d0ec05a79757",
+ "sourceCommit": "618ed23852c4c67b16296910731076bb11594a09",
+ "sourceHash":
"a47b1597c3bd34f750643728f8a21d93e8a3355bd683b114bd2e1495e06055ec",
+ "sourceTechnicalHash":
"9b19e699739257471def7cbe0fa59ae1e103a90410e434a6e6e60a5bcc8829c1",
+ "targetHash":
"eaa4b873d26c6881376dbf797d7b7d9579b95e4e0b6ab06bb7f3ad40a6d7c80a",
"reviewStatus": "machine",
"ownership": "machine",
- "translatedAt": "2026-10-14T05:12:57.465Z",
- "glossaryVersion": "0"
+ "translatedAt": "2026-10-31T17:20:15.459Z",
+ "glossaryVersion": "1",
+ "generation": {
+ "policy": "whole-document-v1",
+ "mode": "full",
+ "reason": "chinese-reference-changed",
+ "attempts": 3,
+ "acceptedWithWarnings": true,
+ "sourceHash":
"a47b1597c3bd34f750643728f8a21d93e8a3355bd683b114bd2e1495e06055ec",
+ "targetHash":
"eaa4b873d26c6881376dbf797d7b7d9579b95e4e0b6ab06bb7f3ad40a6d7c80a",
+ "warnings": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node 9:
expected [\"code\",\"sql\",null,\"-- setup\\ncreate table t1(\\n k1
int,\\n k_string varchar(100),\\n k_decimal decimal(10, 2),\\n
k_array array<int>\\n) distributed by hash (k1) buckets 1\\nproperties
(\\\"replication_num\\\"=\\\"1\\\");\\ninsert into t1 values \\n (1,
'apple', 10.01, [10, 20, 30]),\\n (1, 'banana', 20.02, [10, 20]),\\n (2,
'orange', 30.03, [10, 20, 40]),\\n [...]
+ }
+ ],
+ "history": [
+ {
+ "attempt": 1,
+ "issues": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node 9:
expected [\"code\",\"sql\",null,\"-- setup\\ncreate table t1(\\n k1
int,\\n k_string varchar(100),\\n k_decimal decimal(10, 2),\\n
k_array array<int>\\n) distributed by hash (k1) buckets 1\\nproperties
(\\\"replication_num\\\"=\\\"1\\\");\\ninsert into t1 values \\n (1,
'apple', 10.01, [10, 20, 30]),\\n (1, 'banana', 20.02, [10, 20]),\\n (2,
'orange', 30.03, [10, 20, 40]),\ [...]
+ }
+ ]
+ },
+ {
+ "attempt": 2,
+ "issues": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node 7:
expected [\"inlineCode\",null,null,\"[10, 20, NULL]\"]; received
[\"inlineCode\",null,null,\"NULL\"]\nprotected node 8: expected
[\"inlineCode\",null,null,\"[10, 20, 40]\"]; received
[\"inlineCode\",null,null,\"NULL\"]\nprotected node 9: expected
[\"code\",\"sql\",null,\"-- setup\\ncreate table t1(\\n k1 int,\\n
k_string varchar(100),\\n k_decimal decimal(10, 2),\\n k_array
array<in [...]
+ }
+ ]
+ },
+ {
+ "attempt": 3,
+ "issues": [
+ {
+ "check": "protected-content",
+ "message": "Restore protected source content:\nprotected node 9:
expected [\"code\",\"sql\",null,\"-- setup\\ncreate table t1(\\n k1
int,\\n k_string varchar(100),\\n k_decimal decimal(10, 2),\\n
k_array array<int>\\n) distributed by hash (k1) buckets 1\\nproperties
(\\\"replication_num\\\"=\\\"1\\\");\\ninsert into t1 values \\n (1,
'apple', 10.01, [10, 20, 30]),\\n (1, 'banana', 20.02, [10, 20]),\\n (2,
'orange', 30.03, [10, 20, 40]),\ [...]
+ }
+ ]
+ }
+ ]
+ },
+ "sourceRevisions": {
+ "en": {
+ "path":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min.md",
+ "blob": "2bc1116f5c0fe9b49a23c84cb759351aa672ae68"
+ },
+ "zh-CN": {
+ "path":
"i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/min.md",
+ "blob": "330a99af3ecee80b6fc7b07e3cbe28fc7552f101"
+ }
+ }
}
}
diff --git
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/topn-array.json
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/topn-array.json
index 6db303780495..f1fbcf0890f7 100644
---
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/topn-array.json
+++
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/topn-array.json
@@ -8,13 +8,39 @@
"sourceLocale": "en",
"sourcePath":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-array.md",
"targetPath":
"i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-array.md",
- "sourceCommit": "f9184fac0bbfb81ef27a7f834ad53f1764cc8929",
- "sourceHash":
"0d1a1c1a4fa472856c4feaff17accfca1b15b214c279aed5a9bf734b54fe79bd",
- "sourceTechnicalHash":
"8925d653b28bfb58f76ab48df6a5bf092994665edf93a22c6cf7d4e3c5107864",
- "targetHash":
"50ef57bd3376bb8b21b35cb2338df7d266203a645409557ef3c33772ab9208cf",
+ "sourceCommit": "618ed23852c4c67b16296910731076bb11594a09",
+ "sourceHash":
"f47e5bf19fcf6c04210d6c275f3b39f4576cb4dec6d319c61b2c8d9239c88704",
+ "sourceTechnicalHash":
"36ff484abf1ad39ba4cdb7fb216bdd39b5c938eca4be9b6b23f7828d9794a5e4",
+ "targetHash":
"50b6593584c85518c4518ba6423d5706a7357f4604f5fdfd64896258d20bc63b",
"reviewStatus": "machine",
"ownership": "machine",
- "translatedAt": "2026-10-14T05:27:19.788Z",
- "glossaryVersion": "0"
+ "translatedAt": "2026-10-31T17:21:18.152Z",
+ "glossaryVersion": "1",
+ "generation": {
+ "policy": "whole-document-v1",
+ "mode": "full",
+ "reason": "chinese-reference-changed",
+ "attempts": 1,
+ "acceptedWithWarnings": false,
+ "sourceHash":
"f47e5bf19fcf6c04210d6c275f3b39f4576cb4dec6d319c61b2c8d9239c88704",
+ "targetHash":
"50b6593584c85518c4518ba6423d5706a7357f4604f5fdfd64896258d20bc63b",
+ "warnings": [],
+ "history": [
+ {
+ "attempt": 1,
+ "issues": []
+ }
+ ]
+ },
+ "sourceRevisions": {
+ "en": {
+ "path":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-array.md",
+ "blob": "b5b1722cbd76c5fa6d4793272d1f91414a6eaba3"
+ },
+ "zh-CN": {
+ "path":
"i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-array.md",
+ "blob": "b370d4948b9d69d2a42c1ca552b7d5b7f7958368"
+ }
+ }
}
}
diff --git
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/topn-weighted.json
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/topn-weighted.json
index 12e59d23da6f..9e761589ea29 100644
---
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/topn-weighted.json
+++
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/topn-weighted.json
@@ -8,13 +8,39 @@
"sourceLocale": "en",
"sourcePath":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-weighted.md",
"targetPath":
"i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-weighted.md",
- "sourceCommit": "f9184fac0bbfb81ef27a7f834ad53f1764cc8929",
- "sourceHash":
"ab4d6b879aba84680e834eb9416783d3d86bd1bd2e3e967aa430f106dfe5d2fa",
- "sourceTechnicalHash":
"ec1d1bc6ba2cde41e3622ad9b6f6bb7197a30cac99fb65cebc0f7c5e565298d7",
- "targetHash":
"8b1489fdab270f92d515d6add9bfee534e6983937c42b997873efc53c3065b28",
+ "sourceCommit": "618ed23852c4c67b16296910731076bb11594a09",
+ "sourceHash":
"1deded4278f003f1d2417f37840e1d45e7d66b6c4b9a2056ccf3b253530e35fd",
+ "sourceTechnicalHash":
"76eabd5cf968a28af5f1d9cff570ebcc59ccc9f461d50fcaf63306b71c6a900c",
+ "targetHash":
"c9db78adb89361b24a30b09c69c9e96056dc7a2546f6cc57cfa13abdb4b185ab",
"reviewStatus": "machine",
"ownership": "machine",
- "translatedAt": "2026-10-14T05:27:19.788Z",
- "glossaryVersion": "0"
+ "translatedAt": "2026-10-31T17:21:40.625Z",
+ "glossaryVersion": "1",
+ "generation": {
+ "policy": "whole-document-v1",
+ "mode": "full",
+ "reason": "chinese-reference-changed",
+ "attempts": 1,
+ "acceptedWithWarnings": false,
+ "sourceHash":
"1deded4278f003f1d2417f37840e1d45e7d66b6c4b9a2056ccf3b253530e35fd",
+ "targetHash":
"c9db78adb89361b24a30b09c69c9e96056dc7a2546f6cc57cfa13abdb4b185ab",
+ "warnings": [],
+ "history": [
+ {
+ "attempt": 1,
+ "issues": []
+ }
+ ]
+ },
+ "sourceRevisions": {
+ "en": {
+ "path":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-weighted.md",
+ "blob": "167bd9e08ee639deb8b2a57e136e6072c6102a2a"
+ },
+ "zh-CN": {
+ "path":
"i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn-weighted.md",
+ "blob": "bd37396199e94d56c49caedbf32a988f580d954b"
+ }
+ }
}
}
diff --git
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/topn.json
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/topn.json
index f60bec3f94c1..ed62dd8f1544 100644
---
a/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/topn.json
+++
b/translations/state/ja/pages/default/4.x/sql-manual/sql-functions/aggregate-functions/topn.json
@@ -8,13 +8,39 @@
"sourceLocale": "en",
"sourcePath":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn.md",
"targetPath":
"i18n/ja/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn.md",
- "sourceCommit": "f9184fac0bbfb81ef27a7f834ad53f1764cc8929",
- "sourceHash":
"aa214af874a1c36c0d5069854f8e12f43c23ee8b1f37bc8f408d10c79344b44b",
- "sourceTechnicalHash":
"0a8491771f915666302734c6fa5f7cfd233e30e41260699ec960d7c05fe16bb1",
- "targetHash":
"e74dbf7ca9ab5da3a8e09232f42250ed45ddcc0a7ca1aa59f6a13a3ef4a07e87",
+ "sourceCommit": "618ed23852c4c67b16296910731076bb11594a09",
+ "sourceHash":
"8cb60a3bc3bda3d1be7482d3ec1a15860c9ae01eb6620952f71ff9811bc439b6",
+ "sourceTechnicalHash":
"68102480954ac94c99dd0d028994e3a27b89a295a059c29eaa54d517ddf6b7b5",
+ "targetHash":
"4de5d92530f19126e3335840417ad71477fef4fc90b77a8ec8e3a25b643ea1da",
"reviewStatus": "machine",
"ownership": "machine",
- "translatedAt": "2026-10-14T05:27:19.788Z",
- "glossaryVersion": "0"
+ "translatedAt": "2026-10-31T17:22:30.959Z",
+ "glossaryVersion": "1",
+ "generation": {
+ "policy": "whole-document-v1",
+ "mode": "full",
+ "reason": "chinese-reference-changed",
+ "attempts": 1,
+ "acceptedWithWarnings": false,
+ "sourceHash":
"8cb60a3bc3bda3d1be7482d3ec1a15860c9ae01eb6620952f71ff9811bc439b6",
+ "targetHash":
"4de5d92530f19126e3335840417ad71477fef4fc90b77a8ec8e3a25b643ea1da",
+ "warnings": [],
+ "history": [
+ {
+ "attempt": 1,
+ "issues": []
+ }
+ ]
+ },
+ "sourceRevisions": {
+ "en": {
+ "path":
"versioned_docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn.md",
+ "blob": "8fca3e7b95241d83a7142b84db6b8d289f5ce6eb"
+ },
+ "zh-CN": {
+ "path":
"i18n/zh-CN/docusaurus-plugin-content-docs/version-4.x/sql-manual/sql-functions/aggregate-functions/topn.md",
+ "blob": "f351da77373b111b8ef89d83cd4d788d2f79f77b"
+ }
+ }
}
}
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
