ClickHouse 多表 JOIN 时 SELECT * 语法错误解析与解决方案

一、问题背景

在使用 ClickHouse 数据库进行多表 JOIN 操作时，你可能会遇到这样的错误

Code: 48, e.displayText() = DB::Exception: Multiple JOIN do not support asterisks yet (version 19.5.3.1)

这个错误是由于 ClickHouse 在特定版本（如 19.5.3.1）中对多表 JOIN 操作的语法限制导致的。本文将详细解析这个错误的原因、影响以及解决方案。

二、错误原因分析

2.1 ClickHouse 版本限制

ClickHouse 在早期版本（如 19.5.3.1）中对多表 JOIN 操作有严格的语法限制。具体来说，当查询中包含多个 JOIN 子句时，不支持使用SELECT *这种隐式列选择语法。

2.2 为什么不支持 SELECT *？

在多表 JOIN 场景下，SELECT *会引发以下问题：

1. 列名冲突：不同表可能存在相同的列名，直接使用*会导致结果集中列名重复
2. 性能问题：隐式选择所有列可能会导致不必要的数据传输和处理
3. 语义歧义：数据库无法确定某些操作（如 GROUP BY、ORDER BY）中引用的列具体来自哪个表

ClickHouse 为了避免这些问题，在多表 JOIN 时禁用了SELECT *语法。

2.3 示例说明

考虑以下 SQL 查询：

SELECT *
FROM table1
LEFT JOIN table2 ON table1.id = table2.id
LEFT JOIN table3 ON table1.id = table3.id
WHERE ...

在 ClickHouse 19.5.3.1 版本中，这个查询会报错，因为存在多个 JOIN 子句且使用了SELECT *。

三、解决方案

3.1 明确指定所有需要的列

最直接的解决方案是在 SELECT 列表中明确指定所有需要的列，而不是使用*。

SELECT 
    table1.column1,
    table1.column2,
    table2.column3,
    table3.column4
FROM 
    table1
LEFT JOIN table2 ON table1.id = table2.id
LEFT JOIN table3 ON table1.id = table3.id
WHERE ...

3.2 使用表别名

为了提高查询的可读性，建议使用表别名：

SELECT 
    t1.column1,
    t1.column2,
    t2.column3,
    t3.column4
FROM 
    table1 t1
LEFT JOIN table2 t2 ON t1.id = t2.id
LEFT JOIN table3 t3 ON t1.id = t3.id
WHERE ...

3.3 处理列名冲突

如果不同表中存在相同的列名，可以使用别名避免冲突：

SELECT 
    t1.id AS table1_id,
    t2.id AS table2_id,
    t1.name,
    t2.value
FROM 
    table1 t1
LEFT JOIN table2 t2 ON t1.id = t2.id

3.4 升级 ClickHouse 版本

如果可能，考虑升级 ClickHouse 到较新版本。较新版本（如 20.x 及以上）对多表 JOIN 的支持更加完善，可能已经移除了这个限制。

四、最佳实践

1. 避免使用 SELECT *：无论数据库是否支持，在生产环境中都应避免使用SELECT *，以提高查询的可读性和性能
2. 明确列引用：在 GROUP BY、ORDER BY 等子句中，始终明确指定列所属的表别名
3. 检查表结构：在编写复杂查询前，先了解参与 JOIN 的表的结构，避免列名冲突
4. 测试兼容性：如果需要支持旧版本的 ClickHouse，务必在开发环境中测试查询的兼容性