通过 HTTP 协议返回的状态码,您可以知道请求是否成功、是否需要进一步操作、是否有错误发生等情况。本文列举一些常见的状态码,提供了状态码的含义以及相应的解决措施,旨在帮助您自主识别和分析在访问数据库时遇到的异常情况,及时解决问题。
Class 11:Authentication failure
11 开头的错误码表明连接数据库认证过程可能是由于凭证不正确或缺乏权限导致失败。
错误码 | 错误描述 | 错误含义 | 解决措施 |
11100 | Datatype privilege failure |
使用 AI 套件的接口访问 Base 类数据库,或者使用 Base 类接口访问 AI 套件的数据库,接口使用受限错误。
| 请使用数据库类型对应的相关接口。 |
Class 13: Index status exception
13 开头的错误码表明构建索引过程存在问题,例如状态无效或者操作不当。
错误码 | 错误描述 | 错误含义 | 解决措施 |
13000 | Collection index state is invalid | Collection 索引状态无效 | 请等待 Collection 完成索引构建。 |
13100 | Collection index is not ready | Collection 索引未准备就绪 | |
13101 | Index is building | 索引正在构建 | |
13200 | Index type does not support delete operations | 该索引类型不支持删除操作 | 索引类型为 FLAT,不支持删除数据。 |
13201 | Index type does not support update operations | 该索引类型不支持更新操作 | 索引类型为 FLAT,不支持更新数据。 |
Class 14:Data exception
14 开头的错误码表明接口输入参数的数据存在问题,例如数据无效、数据类型不对、格式错误、超出取值范围等。
错误码 | 错误描述 | 错误含义 | 解决措施 |
14000 | Data exception | 数据异常 | 检查数据的完整性、准确性和一致性。确保数据没有缺失值、重复值或错误值。 |
14100 | Parameters are invalid | 参数无效 | 请确认接口所定义的参数类型与取值范围。 检查传入的参数或 URL 是否全部正确。 |
14110 | Name is invalid | 名称无效 | 请确认名称命名要求。 请按照命名规范重新定义名称。 |
14111 | Name is too long | 名称字符过长 | 请确认名称的长度要求。 按照名称的长度要求重新命名。 |
14120 | The value is out of the allowed range | 数值超出允许的范围 | 请确认参数的取值范围,重新输入数值。 |
14121 | The value does not match the defined type | 数值与定义的类型不匹配 | 请确认的数据类型,重新输入数值。 |
14122 | Negative value error | 数值为负数错误 | 请确认参数的取值范围,重新输入数值。 |
14130 | String value does not match | 字符串不匹配 | 请确认字符串参数要求,重新输入参数。 |
14131 | String length exceeds allowed range | 字符串长度超出允许范围 | 请确认字符串长度要求,重新输入参数。 |
14132 | String length is zero | 字符串长度为零的错误 | 请确认字符串参数要求,重新输入参数。 |
14200 | Empty data exception | 空数据异常 | 请确认输入参数的要求,重新输入参数。 |
14201 | The input parameters are not allowed to be empty. | 不允许参数为空数据 | 请确认接口的参数,按照要求配置接口参数。 |
14300 | Array subscript error | 数组下标错误 | 使用数组时,出现下标越界或者无效的下标值。请确认数组下标的取值范围,重新配置数组。 |
14400 | Duplicate data encountered while processing batch data | 在处理批量数据时出现了重复数据的错误。 |
请确认可设置批量操作的参数是否配置重复的信息。例如:使用 query 接口参数 documentIds 是否设置了重复的文档 ID。
|
14500 | Object quantity error | 对象数量错误 | 请确认对象数量是否超出限制。 |
14501 | Object quantity error | 对象数量超出允许范围 | 请确认查询过滤的文件数是否超出最大文件数量限制。 |
Class 15:Syntax Error
15 开头的错误码表明输入参数存在配置错误,例如:数据库类型错误、索引类型错误、字段配置不匹配等。
错误码 | 错误描述 | 错误含义 | 解决措施 |
15000 | Syntax error | 参数配置错误 | 输入参数不正确,请确认参数要求,重新输入参数。 |
15100 | Mismatched parameter error | 参数不匹配的错误 | 请确认参数的配置要求,重新输入参数。 |
15101 | Database type mismatch | 数据库类型不匹配 | 请确认是否执行 Base 类数据库却使用了 AI 类数据库相关接口。 请使用数据类型对应的相关接口。 |
15111 | Index type mismatch | 索引类型不匹配 | 创建集合的参数 indexType 必须是 id、filter 或 vector 类型之一。请确认 indexType 参数设置是否正确。 |
15112 | Index field data type mismatch | 索引字段数据类型不匹配 | 索引有其对应的参数 fieldtype,请根据如下描述确认是否配置正确,重新输入参数。 当索引类型是 primary 时,fieldtype 必须是 string。 当索引类型是 vector index 时,fieldtype必须是 vector。 当索引类型为 filter 时,fieldtype 必须是string、uint64 或 array。 |
15113 | Vector index parameters mismatch | 向量索引参数不匹配 |
在向量索引的参数中有错误。例如,HNSW 的参数 M 超出范围。
|
15114 | Mismatched algorithm for vector similarity calculation | 向量相似度计算度量算法不匹配 | 参数 metricType 必须是IP、L2 或 COSINE 中的一个。 |
15115 | The number of replicas does not match the instance type | 副本数数值与实例类型不匹配 | 每一种实例类型支持的副本数不一样,请根据如下描述确认副本数是否设置正确,重新输入参数。 单机版与免费测试版实例:副本仅能为 0 ,创建 Collection 设置副本数大于0,则报错。 高可用版实例副本数取值范围如下: 两可用区:[1,节点数-1]。 三可用区:[2,节点数-1]。 |
15116 | Mismatched embedding field | Embedding 字段不匹配 | 创建 Collection 时配置的 Embedding 的参数不正确。 |
15117 | Mismatch the embedding vector fields | Embedding 向量字段与定义的不匹配 | 创建 Collection 时定义的存储向量数据的字段与插入数据时,使用的字段名可能不一致。 |
15131 | Alias access denied | 别名访问被拒绝 | 所访问集合的别名使用错误,请确认集合的别名,重新通过别名操作集合。 |
15141 | Search condition mismatch | 搜索条件不匹配 | 请确认接口查询条件相关的参数是否设置正确,数据类型与取值范围是否满足要求。 |
15142 | Read consistency mismatch | 读一致性不匹配错误 | 参数 ReadConsistency 设置的取值不正确,当前仅支持如下一致性要求: StrongConsistency:强一致性。 EventualConsistency:最终一致性。 |
15171 | Dimension mismatch | 向量维度不匹配 | 创建 Collection 时,Embedding 模型对应的向量维度与指定的维度不一致。 |
15172 | Operation type mismatch | 操作类型不匹配 | |
15200 | Duplicate object error | 重复对象错误 | 请确认数据库名、集合名、数据 ID 是否存在重复。 |
15201 | Duplicate database name error | 数据库名重复错误 | 创建数据库时,设置的数据库名已经存在。 |
15202 | Duplicate collection error | Collection 重复错误 | 创建集合时,设置的 Collection 名已经存在。 |
15203 | Duplicate document ID error | Document ID 重复错误 | 插入数据时,指定的 Document ID 已经被使用。 |
15204 | Duplicate Alias error | 别名重复错误 | 创建别名时,别名已存在。 |
15205 | Duplicate embedding model | Embedding 模型重复错误 | |
15300 | Undefined object | 未定义的对象 | 请提交工单咨询腾讯云工程师。 |
15301 | Undefined database | 未定义的数据库 | |
15302 | Undefined collection | 未定义的集合 | |
15303 | Undefined document I | 未定义的文档 ID | |
15304 | Undefined alias | 未定义的别名 | 请确认所属访问集合的别名,重新使用别名访问集合。 |
15305 | Undefined embedding model | 未定义的 Embedding 模型 | |
15306 | Undefined index model | 未定义的索引 | 创建集合的参数 indexType 必须是 id、filter 或 vector 类型之一。请确认 indexType 参数设置是否正确。 |
15400 | InValid model | 无效的模型 |
Class 16:External error
16 开头的错误码表明数据库应用服务功能异常,例如:Embedding Token 超出限制等。
错误码 | 错误描述 | 错误含义 | 解决措施 |
16100 | Embedding service unavailable | 不支持 Embedding 功能或 Embedding 功能未打开 | 当前 Embedding 功能支持地域包含:北京、上海、广州、新加坡。其余地域暂不支持。 开通 Embedding 的具体操作,请参见 管理 Embedding 功能。 |
16104 | Token consumption for Embedding exceeds the range | Embedding 所消耗的 Token 流量超出范围 | |
16106 | Exceeded the free token traffic limit for Embedding | 已超过 Embedding 免费限制开通的 Token 流量 | 免费版实例每月提供 500,000 个免费 Token,请等待下个月1号系统将自动会将免费 Token 数量重置为 500,000 个。 |
Class 17: Internal error
Class 18:Processing exception
Class 19:System overload exception
19 开头的错误码表明系统负载过高,内存或磁盘超出限制。
Class 20:AI service Internal error