Clickhouse remoteSecure查询嵌套列报错：DEV环境无法用点符号访问

问题根源 #

这个报错是因为ClickHouse 24.x版本对remoteSecure函数的嵌套列解析逻辑做了兼容性变更，再加上DEV环境（24.5.3.5）和远程服务器（24.8.8.17）跨版本查询的叠加影响：

• 23.x版本（PROD）的remoteSecure会直接将远程嵌套列的结构原样映射到本地查询上下文，允许直接用点符号（event_params.key）访问子列；
• 24.x版本的remoteSecure引入了内部临时表别名（比如__table1），在解析嵌套列时错误地将表别名与嵌套列路径绑定，导致点符号访问的路径被解析为__table1.event_params.key，但实际远程表的嵌套列结构里并没有这个带别名的完整路径。

用索引（event_params[1]）能生效，是因为这种方式直接按嵌套数组的位置取值，不需要解析子列名称映射，绕过了别名解析的问题。

解决方法 #

1. 显式修正查询语句 #

通过显式指定表别名或括号包裹的方式，让解析器正确识别嵌套列路径：

• 方式一：给远程表指定别名，通过别名访问嵌套列

  SELECT t.event_params.key 
  FROM remoteSecure('远程地址:端口', '库名.表名', '用户名', '密码') AS t
  

• 方式二：用括号包裹远程表的嵌套列引用

  SELECT (remoteSecure('远程地址:端口', '库名.表名', '用户名', '密码').event_params).key AS key
  

2. 启用旧版元数据解析配置 #

在DEV环境的ClickHouse配置文件（config.xml）中添加或修改以下配置，让24.x版本回到23.x的remoteSecure元数据解析逻辑：

<remote_use_legacy_metadata>1</remote_use_legacy_metadata>

修改后需要重启ClickHouse服务，配置生效后即可直接用点符号访问嵌套列。

3. 统一版本（可选） #

如果条件允许，将DEV环境的ClickHouse版本升级到与远程服务器（24.8.8.17）一致，新版本已经修复了跨版本嵌套列解析的兼容问题，无需额外配置即可正常使用点符号访问。

内容的提问来源于stack exchange，提问作者Alexandr