Catalyst ZCQL查询在Node函数中执行失败求助

以下是针对性的排查步骤和解决方案：

1. 校验查询语句一致性 #

把Node函数中实际执行的查询语句完整打印出来（比如用console.log(query)），逐字符对比控制台能正常运行的版本。重点检查：

• 表名、列名的大小写是否一致（部分环境对大小写敏感）
• 聚合函数的写法（比如AVG(is_active)是否正确，有没有多余的符号或拼写错误）
• 动态拼接参数时的转义错误（比如布尔值的传递、引号的处理）

2. 检查权限差异 #

控制台使用的是个人账号权限，而Node函数通常用服务账号执行，两者权限可能不同：

• 确认服务账号拥有目标Datastore表的查询权限（比如Datastore Viewer角色）
• 如果表有行级权限，检查服务账号是否能访问所有需要计算平均值的行

3. 逐步简化查询定位问题 #

先执行无聚合的基础查询，验证Node环境的连通性：

// 测试基础查询
const testQuery = "SELECT is_active FROM your_table LIMIT 5";

如果基础查询正常，再逐步添加AVG聚合函数，确认是否是聚合逻辑触发的错误。

4. 排查SDK版本与细节错误 #

• 确认使用的Zoho Node SDK是最新版本，旧版本可能存在布尔列聚合函数的兼容性bug
• 在catch块中打印完整错误对象，获取更详细的报错信息：

catch (error) {
  console.error("完整错误信息:", error); // 查看error.details或error.stack获取具体原因
}

如果是布尔值类型解析问题，可以尝试将布尔列转为数值型再计算平均值：

SELECT AVG(CASE WHEN is_active THEN 1 ELSE 0 END) AS avg_active FROM your_table

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