Autodesk Forge Indexes API大文件查询异常问题求助

问题背景 #

开发工具用于查询BIM360上Revit模型的元素属性，基于Forge Indexes API实现官方模型属性查询流程。小模型处理正常，但大模型出现以下问题：

• 调用Get Index Properties获取完整属性索引返回错误码0；
• 调用Post Queries执行查询时，状态返回state = FAILED，错误信息：

  type: "RuntimeError"
  title: "AmazonS3Exception"
  detail: "The character number in one record is more than our max threshold, maxCharsPerRecord: 1,048,576"

问题根源是使用from S3Object[*]的查询语法，会将整个JSON属性集合作为单条记录处理，触发了S3 Select的单记录字符数上限（1MB）。

解决方案（API调用端修复） #

这个问题可以在调用端通过调整查询语句解决，不属于Forge端Bug，具体操作：

• 修改查询语法：将from S3Object[*]替换为from S3Object s，让S3 Select把JSON数组中的每个模型元素属性作为独立记录处理，避免单记录超过字符阈值。
  • 原错误示例查询：

    SELECT * FROM S3Object[*]
    

  • 修正后的查询：

    SELECT s.* FROM S3Object s
    

• 带过滤条件的示例：如果需要筛选特定元素，直接针对s的属性设置条件：

  SELECT s.id, s.properties."Family" FROM S3Object s WHERE s.category = 'Doors'
  

额外排查建议 #

针对Get Index Properties返回错误码0的问题：

• 确认请求中的模型URN、索引ID参数正确无误；
• 验证请求使用的OAuth令牌具备data:read权限；
• 检查大模型的属性索引是否已完全生成（可通过Get Index Properties的状态字段确认）。

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