阅读时间:1 分钟
0 字
语义查询接入
调用方使用实体、属性和关系表达业务需求,不提交源表名或任意 SQL。开始前需要有效身份、租户上下文和可访问的已发布模型版本。
请求流程
- 获取可访问本体及版本,缓存时间不能超过平台给出的有效期。
- 提交实体类型、选择属性、过滤、排序、分页和必要的关系遍历。
- 传播标准追踪头;不要在业务字段中伪造主体和租户。
- 读取响应中的模型版本、
traceId、数据来源、新鲜度和分页游标。 - 对部分结果、陈旧数据和来源错误按接口声明处理。
查询约束
只选择需要的字段,使用有选择性的过滤条件,限制关系深度,不依赖跨源结果的全局事务快照。调用方不得假设响应字段永远存在;字段可能因模型版本、权限或源数据质量缺失。
错误处理
请求无效和无权限不可自动重试;限流、源端超时和临时不可用按照错误中的 retryable 和退避提示处理。模型版本过期时重新发现版本并检查兼容性。预算超限时缩小范围,不提高客户端重试频率。
验证成功
一次成功接入应能证明:同一主体只看到获授权的实例和字段;分页没有重复或遗漏;响应包含可查询的 traceId;数据来源与新鲜度满足业务要求。