全部文档
当前文档
最近更新时间：2026-11-04 16:40:18
向量 Vector 是向量存储桶三级资源结构的最底层，是向量索引中实际存储的数据点和唯一标识某个数据的基本单元。
一个向量由三部分组成:
组成 | 说明 |
key | 向量主键，唯一标识向量索引内的向量，长度 1~1024 字符，需为 UTF-8 格式 |
data | 向量数据，浮点数组，维度和数据类型必须与创建索引时指定的相匹配 |
metadata | 向量关联的元数据，JSON 格式，用于关联原始数据、过滤检索 |
向量元数据分为两类:
类型 | 说明 |
可筛选元数据 | 参与相似性检索过滤条件判断的元数据，写入向量时附带，查询时可作为过滤条件 |
不可筛选元数据 | 不参与过滤、仅存储业务描述信息的元数据，如标签、来源、时间戳等，方便结果展示或后续管理 |
向量级操作要求实时更新，保证强一致性:写入、修改、删除后立即生效，后续查询可立即获取最新向量数据。
目前支持北京地域，更多地域敬请期待。
单个向量索引表最多可存储 5000 万行向量数据。
限制项 | 约束 |
单索引向量数 | 最多 5000 万条 |
向量维度 | 2~4096 维，需与索引维度一致 |
单向量数组大小 | 1 KB~500 KB |
key 长度 | 1~1024 字符，UTF-8 格式 |
单次请求 key | 不允许出现相同 key 的多条向量 |
限制项 | 约束 |
单向量元数据总大小 | ≤40 KB ，包含可筛选元数据和不可筛选元数 |
单向量可筛选元数据 | ≤2 KB |
单向量不可筛选元数据字段数 | ≤10 个 |
元数据支持类型 | 整数、浮点数、字符串、数组 |
限制项 | 约束 |
PutVectors 单批 | ≤500 条 |
PutVectors QPS | ≤5 |
GetVectors 单次 | ≤100 条 |
ListVectors 单次 | ≤1000 条 |
ListVectors 并行分段 | ≤16 |
QueryVectors QPS | 30 |
QueryVectors TopK | 1~30 |
向量数据中不允许出现无效值，如 NaN 或 Infinity
若目标向量索引以余弦距离(cosine)度量，则不允许写入零向量(向量所有元素均为 0)
限制项 | 约束 |
单次过滤累计长度 | ≤64 KB |
单次过滤项数量 | ≤1024 个 |
过滤条件嵌套层级 | ≤8 层 |
1.进入向量详情页中索引列表页签
2.点击要查看的索引表名称，进入向量数据列表页
1.向量数据列表页中点击插入向量数据
2.写入向量数据，支持批量写入，控制台单次最多设置 200 个:
主键值:长度 1~1024 字节，必填
向量内容:必填，且向量维度需要和用户选择的 embedded 模型的维度一致
元数据:自定义，非必填
元数据类型:仅支持 string
3.点击确定后，完成向量数据的写入
向量数据列表页可选择单个或多个向量数据进行删除。
1.对单个向量数据进行删除：向量数据列表页中，点击对应向量数据的删除操作按钮
2.对多个向量数据进行删除：向量数据列表页中，批量勾选要删除的向量数据后，点击页面上方的删除按钮
3.点击二次确认弹窗中的删除按钮，完成对应向量数据的删除，删除后数据将不可恢复，请谨慎操作。
1.向量数据列表页中，点击向量数据查询按钮，即可对该索引表进行查询
2.在查询页面内，需设定:
向量数据，必填
可过滤元数据，可选配置:
元数据单次查询命令最大 64KB 字符
单次 filter 指令最多 1024 个
TOPK，支持 1-100
返回相似距离:默认关闭
返回元数据:默认关闭
清除查询条件后恢复默认向量数据页面，检索成功后展示检索内容，失败则不改变当前页面展示。
可过滤元数据可添加最多两层条件组、点击【且/或】逻辑运算符可实现切换。
3.点击查询按钮开始查询
4.在向量数据列表页中展示检索结果:
5.点击页面上方清理按钮退出查询状态，恢复默认向量数据页面
接口 | 说明 |
向索引写入向量数据(单批 ≤500) | |
按 key 获取指定向量(单次 ≤100) | |
列举索引中所有向量(支持并行) | |
删除指定向量 | |
输入查询向量返回 TopK 相似结果 |
纯净模式
