Method 与 URL
/index/add 接口用于在已有集合上，新增标量字段索引：
POST https://{实例访问 IP 地址}:{实例网络端口}/index/add。说明：
如果集合开启了动态 schema（即创建集合时配置了 filterIndexConfig 参数），不支持创建标量索引。
当前不支持创建 json 类型的标量索引。
使用示例
注意：
如下示例可直接复制，在 CVM 运行之前，您需在文本编辑器将 api_key=A5VOgsMpGWJhUI0WmUbY******************** 与 10.0.X.X 依据实际情况进行替换。
curl -i -X POST \\-H 'Content-Type: application/json' \\-H 'Authorization: Bearer account=root&api_key=A5VOgsMpGWJhUI0WmUbY********************' \\http://10.0.X.X:80/index/add \\-d '{"database": "db-test","collection": "book-vector","indexes": [{"fieldName": "bookInfo","fieldType": "string","indexType": "filter"},{"fieldName": "page","fieldType": "uint64","indexType": "filter"}],"buildExistedData": true}'
请求参数
参数 | 子参数 | 是否必选 | 参数含义 | 配置方法及要求 |
database | - | 是 | 配置需重建索引的 Database 名称。 | |
collection | - | 是 | 指定需重建索引的 Collection 名称。 | |
indexes | fieldName | 是 | 指定新增标量索引的字段。 | 用户自定义字段名。命名规则为1-128字符，只能使用英文字母，数字，下划线_、中划线-，并以英文字母开头。 |
| fieldType | | 指定字段数据类型。 | 指定自定义字段的数据类型。取值如下： string：字符型。 uint64：指无符号整数（unsigned integer）。 array：数组类型，数组元素为 string。 |
| indexType | | 指定索引类型。 | 仅支持设置为 filter。 |
buildExistedData | - | 是 | 指定新增的索引字段是否写入过数据。 | true：默认为 true，新增字段已写入过数据，需扫描历史数据并构建索引。 false：新增索引字段为新增字段，无需扫描历史数据，可以快速创建索引。 |
相关说明
调用
/index/add新增标量索引之后，请使用 /collection/describe 接口查看 Collection 的索引状态，当返回参数 indexStatus 中的 status 显示为 ready 时，表明新增的标量索引重建已完成，可正常写入数据。initial：索引已创建但尚未构建，处于初始状态。
ready：索引构建成功且已就绪，可正常执行操作。
training：正在训练机器学习模型以生成向量数据。
building：正在构建向量索引结构并存储向量数据。
building_scalar：正在构建标量索引。
building_sparse：正在构建稀疏向量索引。
failed：索引构建失败，需修复后方可正常操作。
{"code": 0,"msg": "operation success","collection": {"database": "db-test","collection": "coll-test","documentCount": 4,"indexes": [......],"indexStatus": {"status": "ready","startTime": ""}}}
