ShopifyQL 报表查询提示 parseErrors 怎么改写

现象#

调用 shopifyqlQuery 返回 tableData 为 null，parseErrors 只有一句语法错误；把习惯用的 SELECT 改掉后仍然报错。

原因#

• ShopifyQL 用 FROM 加 SHOW 取数，不支持 SELECT、子查询与多数 SQL 函数
• 数据集名写错，sales、orders、customers 之外的名称不在当前 schema 中
• 指标用了展示名或驼峰写法，实际要求下划线小写的字段名
• 缺少 read_reports 权限时返回权限错误，容易与语法错误混在一起

处理步骤#

1. 先跑最小查询 FROM sales SHOW total_sales SINCE -7d 确认通路
2. 再逐段加 TIMESERIES day 与 GROUP BY
3. 每次都读 parseErrors 与 parseWarnings
4. 在 Admin API 客户端确认 scope 含 read_reports，缺失先补授权
5. 把验证过的查询存成常量，避免运行时拼字符串引入非法字符

验收标准#

同一查询返回 parseErrors: []，tableData.columns 与 rows 都有值。