[CSD009] SQL 查询
执行通过当前 SQL 投影访问策略的只读查询。
请求参数
此 API 接口支持的参数列表
| 名称 | 类型 | 示例 | 描述 |
|---|---|---|---|
| string | SELECT apno,pn,pn_docdb,patent_title,patent_id,application_type,created_ts,patent_abstract,patent_type,pn_official,patent_claim,sub_type,updated_ts,country FROM ads_patent WHERE patent_id in (':patent_id') | 待执行的只读 SQL 查询。 |
| object | {
"patent_id": [
"65344d97-1ddc-492b-8aa3-796315bc789c"
]
} | SQL 占位符名称到任意 JSON 参数值的映射。 |
| boolean | - | 是否请求返回调试信息。 |
响应结构
API 响应数据的结构说明
| 字段名 | 类型 | 示例 | 描述 |
|---|---|---|---|
data | object | {} | 接口对应的业务数据。 |
status | boolean | true | 请求是否成功。 |
error_msg | string | Invalid request parameters. | 错误说明；成功时为空字符串，字段示例展示失败场景。 |
error_code | integer<int32> | - | 业务错误码；成功时为 0。 |
error_params | object | {} | 错误消息使用的扩展参数；成功时为空对象。 |
成功响应示例
成功调用 API 的响应示例
JSON
{
"data": {},
"status": true,
"error_msg": "请求参数不合法",
"error_code": 0,
"error_params": {}
}错误码
此接口可能返回的错误码列表
业务错误码
| 错误码 | 描述 |
|---|---|
68300004 | 请求参数异常! |
68300005 | 查询Api失败! |
68300006 | 解析基本存取错误! |
68300007 | 存在错误的请求! |
68300008 | 服务中断异常，请稍后再试! |
68300010 | 文件不符合上传规范! |
平台错误码
| 错误码 | 描述 |
|---|---|
67200001 | API整体限流错误! |
67200002 | 用户调用请求限流限制错误! |
67200003 | 申请token的key和secret不正确或者状态错误! |
67200004 | 无权限或该接口的套餐已超过系统设置的上限! |
67200005 | 账户余额不足，调用失败! |
67200006 | 客户端已过期，调用失败! |
67200007 | 超过调用额度，调用失败! |
HTTP 状态码
| 状态码 | 描述 |
|---|---|
0 | 请求成功 |
400 | 请求非法或 SQL 无法安全解析（INVALID_SQL_QUERY）。 |
403 | SQL 投影无访问权限（SQL_ACCESS_DENIED）。 |
500 | 本服务处理失败。 |
502 | 下游服务调用失败。 |
503 | 50301 为记录保存失败，50302 为可信租户上下文不可用。下游返回后记录失败保留下游响应；下游自身的 503 也原样透传。 |
性能指标
此接口的预期性能特征
正常响应时间
5000 ms
最大响应时间
10000 ms