From 58e3cd6914a6f983bc2855730b9130917262dd81 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Fri, 8 May 2026 07:42:11 +0000 Subject: [PATCH 1/2] Auto-sync: Update Chinese docs from English PR Synced from: https://github.com/pingcap/docs/pull/22583 Target PR: https://github.com/pingcap/docs-cn/pull/21613 AI Provider: azure Co-authored-by: github-actions[bot] --- TOC.md | 1 + lateral-derived-tables.md | 66 +++++++++++++++++++++++++++++++++++++++ mysql-compatibility.md | 2 +- 3 files changed, 68 insertions(+), 1 deletion(-) create mode 100644 lateral-derived-tables.md diff --git a/TOC.md b/TOC.md index d121472adc69..7c0e8f07ab92 100644 --- a/TOC.md +++ b/TOC.md @@ -269,6 +269,7 @@ - [子查询相关的优化](/subquery-optimization.md) - [列裁剪](/column-pruning.md) - [关联子查询去关联](/correlated-subquery-optimization.md) + - [LATERAL 派生表](/lateral-derived-tables.md) - [Max/Min 消除](/max-min-eliminate.md) - [谓词下推](/predicate-push-down.md) - [分区裁剪](/partition-pruning.md) diff --git a/lateral-derived-tables.md b/lateral-derived-tables.md new file mode 100644 index 000000000000..8fdc8212fe9c --- /dev/null +++ b/lateral-derived-tables.md @@ -0,0 +1,66 @@ +--- +title: LATERAL 派生表 +summary: 了解 TiDB 中 LATERAL 派生表的语法和当前限制。 +--- + +# LATERAL 派生表 + +**lateral derived table** 是 `FROM` 子句中的一种子查询，它可以引用同一 `FROM` 子句中更早出现的表的列。这使它比标准派生表更强大，因为标准派生表中的子查询不能引用同一 `FROM` 子句中的外部列。 + +TiDB 可识别用于派生表的 `LATERAL` 语法，遵循 MySQL 8.0 的语法（[WL#8652](https://dev.mysql.com/worklog/task/?id=8652)）。 + +> **Note:** +> +> 当前，TiDB 支持解析 `LATERAL` 派生表语法，但尚不支持执行，执行时会返回错误。你可以在 issue [#40328](https://github.com/pingcap/tidb/issues/40328) 中跟踪完整执行支持的进展。 + +## 语法 + +```sql +SELECT ... FROM table_ref, LATERAL (subquery) [AS] alias [(col_list)] ... +SELECT ... FROM table_ref [LEFT] JOIN LATERAL (subquery) [AS] alias [(col_list)] ON ... +``` + +- `LATERAL` 关键字必须位于派生表子查询之前。 +- 子查询右括号后必须提供表别名。 +- 别名前的 `AS` 关键字是可选的。 +- 别名后可以跟一个可选的派生列列表：`LATERAL (...) AS dt(col1, col2)`。 + +## 示例 + +### 逗号连接 + +```sql +SELECT * FROM t1, LATERAL (SELECT * FROM t2 WHERE t2.id = t1.id) AS dt; +``` + +在此示例中，子查询引用了前一个表 `t1` 中的列 `t1.id`。普通派生表（不带 `LATERAL`）无法做到这一点。 + +### 带派生列列表的 LEFT JOIN + +```sql +SELECT t1.id, dt.val +FROM t1 +LEFT JOIN LATERAL (SELECT t2.val FROM t2 WHERE t2.id = t1.id LIMIT 1) AS dt(val) +ON TRUE; +``` + +派生列列表 `(val)` 会重命名子查询返回的列。 + +## 与标准派生表的比较 + +| Feature | Standard derived table | LATERAL derived table | +|---|---|---| +| Can reference outer `FROM` columns | No | Yes | +| Alias required | Yes | Yes | +| Derived column list | Supported | Supported | + +## MySQL 兼容性 + +TiDB 的 LATERAL 派生表语法在语法级别上与 MySQL 8.0 兼容。 + +## 另请参阅 + +- [Subquery Related Optimizations](/subquery-optimization.md) +- [Decorrelation of Correlated Subquery](/correlated-subquery-optimization.md) +- [Explain Statements That Use Subqueries](/explain-subqueries.md) +- [MySQL Compatibility](/mysql-compatibility.md) \ No newline at end of file diff --git a/mysql-compatibility.md b/mysql-compatibility.md index e9a24ddc3780..e953278cdca7 100644 --- a/mysql-compatibility.md +++ b/mysql-compatibility.md @@ -47,7 +47,7 @@ TiDB 高度兼容 MySQL 协议，以及 MySQL 5.7 和 MySQL 8.0 常用的功能 * "Session Tracker: 将 GTID 上下文信息添加到 OK 包中" * 降序索引 [#2519](https://github.com/pingcap/tidb/issues/2519) * `SKIP LOCKED` 语法 [#18207](https://github.com/pingcap/tidb/issues/18207) -* 横向派生表 [#40328](https://github.com/pingcap/tidb/issues/40328) +* 横向派生表（语法已被识别，但尚不支持执行）[#40328](https://github.com/pingcap/tidb/issues/40328)。有关语法的详细信息，请参阅 [LATERAL Derived Tables](/lateral-derived-tables.md)。 * JOIN 的 ON 子句的子查询 [#11414](https://github.com/pingcap/tidb/issues/11414) ## 与 MySQL 有差异的特性详细说明 From fd3822a021f914eed975ba92eaae8dce0d838509 Mon Sep 17 00:00:00 2001 From: qiancai Date: Fri, 8 May 2026 16:33:02 +0800 Subject: [PATCH 2/2] Update lateral-derived-tables.md --- lateral-derived-tables.md | 34 +++++++++++++++++----------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/lateral-derived-tables.md b/lateral-derived-tables.md index 8fdc8212fe9c..b4f8b1e7f414 100644 --- a/lateral-derived-tables.md +++ b/lateral-derived-tables.md @@ -5,13 +5,13 @@ summary: 了解 TiDB 中 LATERAL 派生表的语法和当前限制。 # LATERAL 派生表 -**lateral derived table** 是 `FROM` 子句中的一种子查询，它可以引用同一 `FROM` 子句中更早出现的表的列。这使它比标准派生表更强大，因为标准派生表中的子查询不能引用同一 `FROM` 子句中的外部列。 +**LATERAL 派生表**是 `FROM` 子句中的一种子查询，它可以引用同一个 `FROM` 子句中位于其前面的表中的列。与标准派生表相比，LATERAL 派生表功能更强，因为标准派生表中的子查询不支持引用同一个 `FROM` 子句中的外部列。 -TiDB 可识别用于派生表的 `LATERAL` 语法，遵循 MySQL 8.0 的语法（[WL#8652](https://dev.mysql.com/worklog/task/?id=8652)）。 +TiDB 可识别用于派生表的 `LATERAL` 语法，该语法遵循 MySQL 8.0 语法（[WL#8652](https://dev.mysql.com/worklog/task/?id=8652)）。 -> **Note:** +> **注意：** > -> 当前，TiDB 支持解析 `LATERAL` 派生表语法，但尚不支持执行，执行时会返回错误。你可以在 issue [#40328](https://github.com/pingcap/tidb/issues/40328) 中跟踪完整执行支持的进展。 +> 当前，TiDB 支持解析 `LATERAL` 派生表语法，但尚不支持执行该语法，执行时会返回错误。你可以通过 issue [#40328](https://github.com/pingcap/tidb/issues/40328) 跟踪完整执行支持的进展。 ## 语法 @@ -21,9 +21,9 @@ SELECT ... FROM table_ref [LEFT] JOIN LATERAL (subquery) [AS] alias [(col_list)] ``` - `LATERAL` 关键字必须位于派生表子查询之前。 -- 子查询右括号后必须提供表别名。 +- 子查询右括号后必须指定表别名。 - 别名前的 `AS` 关键字是可选的。 -- 别名后可以跟一个可选的派生列列表：`LATERAL (...) AS dt(col1, col2)`。 +- 别名后可以指定可选的派生列的列表：`LATERAL (...) AS dt(col1, col2)`。 ## 示例 @@ -33,7 +33,7 @@ SELECT ... FROM table_ref [LEFT] JOIN LATERAL (subquery) [AS] alias [(col_list)] SELECT * FROM t1, LATERAL (SELECT * FROM t2 WHERE t2.id = t1.id) AS dt; ``` -在此示例中，子查询引用了前一个表 `t1` 中的列 `t1.id`。普通派生表（不带 `LATERAL`）无法做到这一点。 +在此示例中，子查询引用了前一个表 `t1` 中的列 `t1.id`。普通派生表（不带 `LATERAL`）不能这样引用前面的表。 ### 带派生列列表的 LEFT JOIN @@ -44,23 +44,23 @@ LEFT JOIN LATERAL (SELECT t2.val FROM t2 WHERE t2.id = t1.id LIMIT 1) AS dt(val) ON TRUE; ``` -派生列列表 `(val)` 会重命名子查询返回的列。 +派生列列表 `(val)` 将会重命名子查询返回的列。 ## 与标准派生表的比较 -| Feature | Standard derived table | LATERAL derived table | +| 功能 | 标准派生表 | LATERAL 派生表 | |---|---|---| -| Can reference outer `FROM` columns | No | Yes | -| Alias required | Yes | Yes | -| Derived column list | Supported | Supported | +| 是否可以引用外部 `FROM` 列 | 否 | 是 | +| 是否必须指定别名 | 是 | 是 | +| 是否支持派生列列表 | 支持 | 支持 | ## MySQL 兼容性 -TiDB 的 LATERAL 派生表语法在语法级别上与 MySQL 8.0 兼容。 +TiDB 的 LATERAL 派生表语法与 MySQL 8.0 语法兼容。 ## 另请参阅 -- [Subquery Related Optimizations](/subquery-optimization.md) -- [Decorrelation of Correlated Subquery](/correlated-subquery-optimization.md) -- [Explain Statements That Use Subqueries](/explain-subqueries.md) -- [MySQL Compatibility](/mysql-compatibility.md) \ No newline at end of file +- [子查询相关优化](/subquery-optimization.md) +- [关联子查询去关联](/correlated-subquery-optimization.md) +- [使用子查询的 Explain 语句](/explain-subqueries.md) +- [MySQL 兼容性](/mysql-compatibility.md) \ No newline at end of file